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

# Email Your Agent

> Start and continue conversations with your AI agents via email

## Overview

You can email any agent in your organization to start a conversation. The agent processes your message, runs its tools, and sends a response back to your inbox. Reply to continue the conversation — just like emailing a colleague.

Conversations started via email appear in the dashboard alongside all other conversations.

## Email Addresses

Every agent has a default email address based on its ID:

```
agent-{id}@updates.asteragents.com
```

You can also set a **custom email alias** in the agent editor to create a friendlier address:

```
my-sales-agent@updates.asteragents.com
```

Both the default and custom addresses work simultaneously. The custom alias is optional.

<Steps>
  <Step title="Open your agent" icon="robot">
    Go to **Control Hub** → **Agents** and select the agent.
  </Step>

  <Step title="Find the Email Address section" icon="at">
    Scroll to the **Email Address** section to view the default address and set an alias.
  </Step>
</Steps>

## How Email Conversations Work

<CardGroup cols={2}>
  <Card title="Start a conversation" icon="paper-plane">
    Email your agent's address with your message in the body. The subject line becomes part of the conversation context.
  </Card>

  <Card title="Send attachments" icon="paperclip">
    Files are uploaded and included in the agent's context, just like attaching files in the chat UI.
  </Card>

  <Card title="Reply to continue" icon="reply">
    The agent replies by email. Reply to that message to continue in the same thread — your email client groups the messages automatically.
  </Card>

  <Card title="Loop in teammates" icon="comments">
    **CC recipients** are preserved throughout the thread, so you can include colleagues by CC'ing them.
  </Card>
</CardGroup>

## BCC Behavior

If you **BCC** the agent on an email, the agent processes the content **silently** — no reply is sent.

<Tip>
  When you BCC the agent, the To and CC fields contain people who don't know the agent is involved. Replying would expose the agent's existence to those recipients, so Aster detects the BCC automatically and suppresses the reply.
</Tip>

BCC'd conversations still appear in the dashboard and the agent still runs its tools (e.g., logging to Salesforce), so nothing is lost — only the outbound email reply is skipped. Use this when you want the agent to have context without responding.

## Security

* **Organization members only**: The sender's email must belong to a registered user in the agent's organization. Emails from unrecognized addresses are silently ignored.
* **All conversations logged**: Email-initiated conversations appear in the dashboard with full visibility for admins.

## Custom Email Aliases

<Steps>
  <Step title="Open the agent" icon="robot">
    Go to **Control Hub** → **Agents** and select the agent.
  </Step>

  <Step title="Enter a slug" icon="at">
    In the **Email Address** section, enter a slug (e.g., `sales-assistant`). Click **Suggest** to auto-generate one from the agent name.
  </Step>

  <Step title="Save the agent" icon="gear">
    The agent is now reachable at both `{slug}@updates.asteragents.com` and `agent-{id}@updates.asteragents.com`.
  </Step>
</Steps>

**Slug rules:**

* Lowercase letters, numbers, and hyphens only
* Must be globally unique across all agents