Skip to main content

​
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: 
[email protected]
To find or configure your agent’s email address:
  1. Go to Control Hub → Agents
  2. Select the agent
  3. Scroll to the Email Address section
Both the default and custom addresses work simultaneously. The custom alias is optional.

​
Starting a Conversation

Send an email to your agent’s address with your message in the body. The subject line becomes part of the conversation context. Attachments are supported — files are uploaded and included in the agent’s context, just like attaching files in the chat UI.

​
Replying

When the agent responds, you’ll receive an email reply. Reply to that email to continue the conversation in the same thread. Your email client will group the messages together automatically. CC recipients are preserved throughout the thread, so you can loop in teammates.

​
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

To set a custom alias:
  1. Open the agent in Control Hub → Agents
  2. In the Email Address section, enter a slug (e.g., sales-assistant)
  3. Save the agent
Slug rules:
  • Lowercase letters, numbers, and hyphens only
  • Must be globally unique across all agents
  • Click Suggest to auto-generate from the agent name
Once set, the agent is reachable at both {slug}@updates.asteragents.com and agent-{id}@updates.asteragents.com.