> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allgoodhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Mary reads, classifies, and acts on every reply that lands in your marketing inbox — automatically.

When you send marketing emails, replies come back. Lots of them. Unsubscribes, out-of-office messages, people who've changed jobs, bounce notifications, genuine sales inquiries — and a mountain of spam. Sorting through all of this manually is tedious and error-prone.

**Mary's Email Reply Management (ERM)** handles this automatically. Every reply that arrives in your configured inbox is read and classified by Mary's AI. Based on the category it falls into, Mary can extract key pieces of information from the email and then trigger downstream actions — like updating a Marketo record, adding someone to a static list, or creating a new contact.

## The three building blocks

The whole system is built around three concepts you configure yourself:

<CardGroup cols={3}>
  <Card title="Categories" icon="tags" href="/use-cases/erm/categories">
    Define the buckets replies fall into. Give each one a name and a plain-English prompt describing how Mary should recognize it.
  </Card>

  <Card title="Data Extraction" icon="book-check" href="/use-cases/erm/data-extraction">
    Tell Mary which fields to pull from emails in a given category — replacement contacts, return dates, new email addresses, and more.
  </Card>

  <Card title="Actions" icon="bolt" href="/use-cases/erm/actions">
    Configure what happens automatically after classification — syncing Marketo fields, adding to static lists, and more.
  </Card>
</CardGroup>

## How an email gets processed

When a reply hits your inbox, here's exactly what happens:

<Steps>
  <Step title="Email arrives">
    The reply lands in your dedicated allGood inbox address (e.g., `8IEJ8ZOP@parse.allgoodhq.app`). Every message sent to this address is automatically picked up and queued for processing.
  </Step>

  <Step title="Mary classifies the email">
    Mary reads the full email — subject line, body, and metadata — and compares it against the categories you've defined. She picks the best match based on the description you wrote for each category.
  </Step>

  <Step title="Mary classifies the email">
    Mary reads the full email — subject line, body, and metadata — and compares it against the categories you've defined. She picks the best match based on the description you wrote for each category.
  </Step>

  <Step title="Data is extracted (if configured)">
    If you've set up data extraction for that category, Mary pulls specific pieces of information out of the email — for example, a replacement contact's name and email address from a "Left Company" auto-reply.
  </Step>

  <Step title="Mary classifies the email">
    Mary reads the full email — subject line, body, and metadata — and compares it against the [categories](/use-cases/erm/categories) you've defined. She picks the best match based on the description you wrote for each category.
  </Step>

  <Step title="Data is extracted (if configured)">
    If you've set up data extraction for that category, Mary pulls specific pieces of information out of the email — for example, a replacement contact's name and email address from a "Left Company" auto-reply.
  </Step>

  <Step title="Actions execute automatically">
    With the email classified and data in hand, Mary fires the actions you've configured for that category — updating a Marketo lead, adding someone to a static list, and so on.
  </Step>

  <Step title="Data is extracted (if configured)">
    If you've set up [data extraction](/use-cases/erm/data-extraction) for that category, Mary pulls specific pieces of information out of the email — for example, a replacement contact's name and email from a "Left Company" auto-reply.
  </Step>

  <Step title="Actions execute automatically">
    With the email classified and data in hand, Mary fires the actions you've configured for that category — updating a Marketo lead, adding someone to a static list, and so on.
  </Step>

  <Step title="Actions execute automatically">
    With the email classified and data in hand, Mary fires the [actions](/use-cases/erm/actions) you've configured for that category — updating a Marketo lead, adding someone to a static list, and so on.
  </Step>
</Steps>

## Where to next

<CardGroup cols={2}>
  <Card title="Set up your first category" icon="tags" href="/use-cases/erm/categories">
    Define how Mary recognizes a reply type.
  </Card>

  <Card title="Configure data extraction" icon="book-check" href="/use-cases/erm/data-extraction">
    Pull structured data out of incoming replies.
  </Card>

  <Card title="Wire up actions" icon="bolt" href="/use-cases/erm/actions">
    Trigger Marketo updates and list adds automatically.
  </Card>

  <Card title="Test before you ship" icon="flask" href="/use-cases/erm/test-suite">
    Validate categorizations and extractions with the Test Suite.
  </Card>

  <Card title="Inspect processed emails" icon="inbox" href="/use-cases/erm/messages">
    See every reply Mary has handled and why she classified it the way she did.
  </Card>

  <Card title="Search and debug" icon="magnifying-glass" href="/use-cases/erm/search">
    Find specific emails across every category and field.
  </Card>
</CardGroup>
