---
title: "[DRAFT] Email Inbox Interface"
description: "[DRAFT - NOT IN USE] Configure email-based agent interactions"
draft: true
---

<Warning>
**This is a DRAFT document not intended for public use.**

For active interface documentation, see:
- [Managing Agent Interfaces](/building-and-deploying-agents/interface-options/managing-interfaces)
- [API Interface Configuration](/building-and-deploying-agents/interface-options/api-deployment)
- [Airia Catalog Interface](/building-and-deploying-agents/interface-options/airia-agent)
- [Chat Widget Interface](/building-and-deploying-agents/interface-options/chat-widget)
</Warning>

# Email Inbox Interface Configuration

The Email Inbox interface enables your agent to automatically receive and respond to emails sent to a dedicated address. This creates an email-based conversational interface for your agent.

## Key Features

### Email Processing
- **Dedicated Email Address**: Get a unique email address for your agent
- **Automatic Processing**: Agent automatically processes incoming emails
- **Email Actions**: Configure how your agent responds to different types of emails

### Response Management
- **Reply Options**: Configure automatic replies, reply-all, forward, or no response
- **Domain Restrictions**: Limit email processing to specific authorized domains
- **Content Filtering**: Process emails based on content, sender, or other criteria

## Configuration Steps

<Steps>
  <Step title="Access the Interfaces Panel" stepNumber={1}>
    Access the interfaces panel by either:
    - Clicking the **ellipsis (…)** menu to the right of your Agent and selecting **Interfaces**
    - Opening the Agent in Studio and clicking **Settings > Interfaces**
  </Step>
  
  <Step title="Add Email Inbox Interface" stepNumber={2}>
    In the interfaces panel:
    - Click **+ Add Interface** if this is a new interface
    - Select **Email Inbox** from the available interface types
    - Or click the edit icon next to an existing Email Inbox interface to modify its configuration
  </Step>
  
  <Step title="Configure Email Settings" stepNumber={3}>
    Configure the following settings for your Email Inbox interface:
    
    - **Agent Email Address**\
      _Your agent will be assigned a unique email address for receiving messages._
    
    - **Email Actions**\
      _Choose how your agent responds to emails:_\
      **Reply**: Send a direct response to the sender\
      **Reply All**: Include all recipients in the response\
      **Forward**: Forward processed emails to another address\
      **No Email**: Process but don't send email responses
    
    - **Domain Restrictions**\
      _Configure which domains are authorized to send emails to your agent._
    
    - **Authorized Domains**\
      _Add specific domains (e.g., yourcompany.com) that can interact with your agent via email._
    
    - **Content Processing**\
      _Configure how your agent processes different types of email content (text, attachments, etc.)._
  </Step>
  
  <Step title="Save Configuration" stepNumber={4}>
    Click **Save** to activate your Email Inbox interface. Your agent will begin processing emails sent to its assigned address.
    
    <Info>
    Make note of your agent's email address to share with users who should be able to interact with it via email.
    </Info>
  </Step>
</Steps>

## Managing Email Interactions

### Email Address Management
- **Copy Email Address**: Easily copy your agent's email address to share with users
- **Address Format**: Email addresses typically follow the pattern: `agent-id@inbox.airia.com`
- **Address Sharing**: Share the email address with authorized users or systems

### Monitoring Email Activity
- **Incoming Email Tracking**: Monitor emails received by your agent
- **Response Tracking**: Track which emails your agent has responded to
- **Processing Logs**: Review how your agent processed different email types

### Best Practices
- **Clear Instructions**: Provide users with clear instructions on how to interact with your agent via email
- **Domain Security**: Use domain restrictions to prevent unauthorized access
- **Response Testing**: Test your agent's email responses to ensure they're appropriate
- **Regular Monitoring**: Check email logs regularly to ensure proper operation

## Troubleshooting

<AccordionGroup>
<Accordion title="How do I ensure my Email Inbox uses the correct agent version?">
All interfaces execute against the **Active version** of your agent. To ensure your Email Inbox interface uses the latest version:

1. Navigate to your agent in the agent list
2. Verify the Agent shows the correct **Active Version**
3. If an update is required:
   - Go into the Agent
   - Select the version number in the top left
   - Click **Set Active**
   - Return to the agent list

Your Email Inbox interface will automatically use the updated Active version.
</Accordion>

<Accordion title="Why isn't my agent responding to emails?">
If your agent isn't processing or responding to emails:

- **Interface Status**: Verify the Email Inbox interface is **enabled**
- **Domain Authorization**: Check that the sender's domain is in your authorized domains list
- **Email Address**: Confirm emails are being sent to the correct agent email address
- **Active Version**: Ensure the agent has an **Active version** published
- **Response Configuration**: Verify your email action settings are configured correctly
</Accordion>

<Accordion title="How do I get my agent's email address?">
To find your agent's email address:

1. Navigate to the interfaces panel for your agent
2. Click the edit icon next to your Email Inbox interface
3. The email address will be displayed in the configuration panel
4. Use the copy button to copy the address for sharing

The email address is automatically generated when you create the Email Inbox interface.
</Accordion>
</AccordionGroup>