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

# Answer customer emails with your AI agent

> Let your AI agent read and reply to customer emails automatically through your company's email system

The Chatbase Email channel lets your AI agent read and answer customer emails automatically. Customers write to your own support address, such as `support@yourdomain.com`, which forwards to your AI agent, and the AI agent replies from your domain using its Data Sources. It needs a paid plan, and email conversations appear in your conversation logs, where your team can [take over](https://chatbase.co/docs/user-guides/chatbot/help-desk/takeover.md) at any time.

> [card] What you can do:
>
> Have routine email support answered the moment it arrives, in your brand's voice, with your team notified the instant delivery goes wrong.

## Before you start

1. [Create a Chatbase account](https://www.chatbase.co/auth/signup) and build your AI agent
2. Subscribe to a paid plan. Without one, the **Enable** button's tooltip reads "Upgrade to a paid plan to use the emails feature". The Email channel isn't available on HIPAA-compliant workspaces.
3. Configure your email domain in [Email settings](https://chatbase.co/docs/user-guides/chatbot/email-settings.md) with forwarding, DKIM, and SPF

> [!WARNING]
>
> **Domain configuration required.** An address can send replies only once its forwarding, DKIM, and SPF are verified. Complete domain setup in **Settings → Email** before deploying. The addresses you add there must be on a **company domain**: free email providers are rejected with "Please use a valid business email address". This applies only to the addresses you connect, not to the email you sign up to Chatbase with.

DMARC isn't required. Email settings shows a DMARC record and its status, but it doesn't block sending.

## How Email integration works

The integration lets your AI agent monitor and respond to incoming emails through your configured addresses:

1. **Email reception**: Incoming emails are forwarded to your Chatbase AI agent. Mail is routed to the AI agent that owns the agent address it was forwarded to.
2. **AI processing**: The AI agent reads the email's plain-text body and any [attachments](#attachments) its model supports, then writes a reply.
3. **Automated reply**: With **Reply Delay** at 0, the reply is sent as soon as it's generated. With a delay set, it's held first (see [Reply Delay](#reply-delay)).
4. **Delivery monitoring**: The system tracks delivery and alerts your [Deliverability Alert Contact](#deliverability-alert-contact) of any issues

> [!NOTE]
>
> This loop pauses when your AI agent escalates by creating a **Zendesk** ticket. The AI agent stops replying to the email thread, your team answers from Zendesk, and the AI agent resumes once the ticket is **Solved** or **Closed**. See [Email handover with Zendesk](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md#email-handover-with-zendesk).

### Who the AI agent replies to

* **Everyone on the thread.** The reply goes to the sender's Reply-To address, and everyone else on the original **To** and **CC** lines is copied, except the sender and your AI agent's own addresses.
* **Forwarded emails.** If someone forwards an email chain to your support address, the AI agent reads the whole body, including the forwarded content, and replies to the person who forwarded it, not the original author.

### Emails the AI agent doesn't answer

These emails are saved to your conversations but don't get an AI reply:

* **No-reply and system senders.** Addresses whose name before the @ is `noreply`, `no-reply`, `donotreply`, `no-response`, `mailer-daemon`, `postmaster`, `bounce`, `auto-reply`, `autoresponder`, `auto-notification`, or `auto-mailer`.
* **Blocked senders** you list in [Blocked senders](#blocked-senders).
* **Suspected spam**, when [Spam detection](#spam-detection) is on.

The AI agent also sends at most 2 replies per minute to the same sender. Past that, the sender gets one "Email Rate Limit Exceeded" notice for that window instead of more AI replies.

Out-of-office replies and mailing-list emails aren't detected automatically, so they get a reply unless one of the rules above stops them. To stop replies to a specific address, add it to **Blocked senders**.

## How to connect Email

**1. Open your Chatbase AI agent**

Navigate to your [Chatbase dashboard](https://www.chatbase.co/dashboard/) and select the AI agent you want to integrate with email.

> [!TIP]
>
> If you haven't created an AI agent yet, follow [Your first AI agent](https://chatbase.co/docs/user-guides/quick-start/your-first-agent.md) to get started.

**2. Configure your email domain**

Navigate to **Settings → Email** and follow the domain configuration process. See [Email settings](https://chatbase.co/docs/user-guides/chatbot/email-settings.md) for detailed instructions.

> [!TIP]
>
> Verify all configuration steps are complete before proceeding. Email addresses with configuration issues will display warnings.

**3. Enable the Email channel**

1. Navigate to **Channels → Email**.

![Email integration navigation](https://mintcdn.com/chatbase/DX8USXKLL_RMQfwe/user-guides/integrations/images/email/email-1.png?fit=max\&auto=format\&n=DX8USXKLL_RMQfwe\&q=85\&s=2b400ee0708e65e3e1c6b5167aa808b0)

2. Click **Manage** to access email deployment settings.

![Email manage button](https://mintcdn.com/chatbase/DX8USXKLL_RMQfwe/user-guides/integrations/images/email/email-2.png?fit=max\&auto=format\&n=DX8USXKLL_RMQfwe\&q=85\&s=7da23758a0cf22afa3248fcb762c7583)

3. Click **Deploy** and toggle the channel to **Enabled**.

![Email deployment interface](https://mintcdn.com/chatbase/DX8USXKLL_RMQfwe/user-guides/integrations/images/email/email-3.png?fit=max\&auto=format\&n=DX8USXKLL_RMQfwe\&q=85\&s=acc14298441c89e81fb88b921934878b)

**4. Customize email settings**

Configure your AI agent's email behavior and appearance from **Channels → Email → Manage**. See [Settings](#settings) below.

![Email configuration options](https://mintcdn.com/chatbase/DX8USXKLL_RMQfwe/user-guides/integrations/images/email/email-4.png?fit=max\&auto=format\&n=DX8USXKLL_RMQfwe\&q=85\&s=4ab116e7c9236c8757668e39cab5f7a3)

> [!TIP]
>
> Send an email to your configured address and confirm your AI agent replies, with the display name and signature you set.

## Settings

Customize how your AI agent sends and formats emails to match your brand and communication standards.

### Reply addresses

Choose which of your verified addresses the AI agent sends replies from. Click **Add email** and select an address from the dropdown. Repeat for each address you want to reply from. Several addresses can forward to the same AI agent: each AI agent accepts up to 3 domains with up to 20 addresses each.

> [card] Configuration
>
> Choose from your verified email addresses. Addresses with configuration issues (forwarding, DKIM, or SPF not enabled) display warnings, and you won't be able to select them.

**How the reply address is chosen**:

1. If the customer emailed an address that's in the list, the AI agent replies from that same address.
2. Otherwise, it replies from the first address in the list.
3. If the list is empty, it replies from the AI agent's built-in `agent@subdomain.chatbase-mail.com` address.

For example, if both `help@yourdomain.com` and `support@yourdomain.com` are in the list, a customer who writes to `help@` gets a reply from `help@`, and a customer who writes to `support@` gets a reply from `support@`.

> [!TIP]
>
> To make every reply come from the address the customer contacted, add each address that forwards to your AI agent to this list.

### Deliverability Alert Contact

Designate a team member to receive notifications about email delivery failures and issues.

> [card] Monitoring
>
> Select from your account members, or choose "None" to disable delivery alerts.

**Recommended**: Assign this to your technical or support team lead so delivery issues get resolved quickly.

### Blocked senders

Add email addresses that should never receive an AI reply. Emails from blocked senders are still saved to your conversations.

### Email Display Name

Set the sender name recipients see when they receive emails from your AI agent.

> [card] Branding
>
> This name appears in the "From" field and represents your brand identity in customer communications.

**Examples**: "CustomerSupport at \[Company Name]", "\[Company Name] AI Assistant", "Helpdesk".

### Spam detection

Enable **Spam detection** to use AI to identify suspected spam. Suspected spam is saved to your conversation logs but doesn't receive an automatic AI reply. You can still reply to these conversations manually.

#### Whitelisted senders

Add email addresses that should always receive an AI reply and bypass **Spam detection**.

### Reply Delay

Hold each AI-generated reply for a set time before it's sent. An instant response can feel automated; a short delay makes replies read like they came from a person, and gives your team a window to step in before an email goes out.

> [card] Pacing
>
> Enter a duration and choose **seconds** or **minutes**. The setting reads "Set to 0 to send immediately. Maximum 60 minutes." Leaving it empty also sends replies immediately.

![Reply delay configuration](https://mintcdn.com/chatbase/fN1ZNcosX9tBeQaY/user-guides/integrations/images/email/reply-delay-setting.png?fit=max\&auto=format\&n=fN1ZNcosX9tBeQaY\&q=85\&s=a0447f64628b9a6177c1161ce30e46f8)

**How it works**:

* The AI agent composes its reply as soon as the customer's email arrives, but the send is held for the configured time.
* While a reply is waiting, it appears in your conversation logs as a pending message with a countdown.
* [Taking over](https://chatbase.co/docs/user-guides/chatbot/help-desk/takeover.md) the conversation cancels any waiting replies. You're warned first, and if you proceed the customer never receives them and the unsent drafts are removed.

![Warning shown when taking over a conversation with a waiting delayed reply](https://mintcdn.com/chatbase/fN1ZNcosX9tBeQaY/user-guides/integrations/images/email/takeover-emails.png?fit=max\&auto=format\&n=fN1ZNcosX9tBeQaY\&q=85\&s=b190ecd2eccf0ab66afca01ea8b7f710)

> [!NOTE]
>
> The delay applies only to automatic AI replies. Replies your team sends from the Helpdesk, and spam conversations you release manually with **Reply anyway**, are always sent immediately.

If a delayed reply fails to send, it's retried automatically. If it still can't be delivered, your [Deliverability Alert Contact](#deliverability-alert-contact) is notified and the reply is discarded.

### AI Composition Disclaimer

Add transparency by including a disclaimer that identifies AI-generated content.

> [card] Transparency
>
> When enabled, adds a customizable disclaimer at the end of emails. The default is "This message is composed by AI."

**Use cases**: regulatory compliance requirements, company transparency policies, building customer trust.

### Email Signature

Create a signature that appears at the bottom of all AI-generated emails.

> [card] Customization
>
> Supports rich text formatting including multiple lines, links, styling, and contact information.

**Signature elements**: company contact information, social media links, legal disclaimers, unsubscribe options.

> [!NOTE]
>
> Remove **Powered by Chatbase** branding from your emails by purchasing the white-label add-on. See [Pricing](https://www.chatbase.co/pricing) for details.

## Attachments

The AI agent can read files customers attach to their emails. Every attachment is saved with the conversation, except files flagged as viruses. The AI agent reads up to 5 attachments per email, and only if its [AI model](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md) supports attachments.

| Type | Formats | Size limit |
| - | - | - |
| Images | JPEG, PNG, GIF, WebP | 5 MB per file |
| Documents | PDF. DOCX, XLSX, and TXT are read as extracted text. | 5 MB per file |
| Audio | OGG, MPEG, MP4, AAC, AMR, M4A, WebM | 16 MB per file |

A larger file is still saved and shown in **Activity > Conversations**, and the AI agent tells the customer in one sentence that it couldn't read it.

The AI agent can't send attachments in its replies. Attachments use extra message credits. See [Attachments](https://chatbase.co/docs/user-guides/chatbot/channels.md#attachments).

## Message credits

Each AI reply uses message credits based on your AI agent's [model](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md), the same as on any other channel. A reply that triggers an Action costs twice the model's usual credits, and attachments add credits per image or per PDF page. Emails that get no AI reply, such as blocked senders or suspected spam, don't use credits for a reply.

## Common use cases

* **Customer support automation**: Handle common inquiries and FAQs automatically
* **Employee self-service**: Answer HR, IT, or administrative questions instantly
* **Lead qualification**: Screen and respond to sales inquiries with relevant information
* **Appointment scheduling**: Assist with booking and calendar management
* **Order status updates**: Provide shipping and order information on demand

> [!TIP]
>
> **Getting started**: Begin with a focused use case like FAQ responses or status inquiries, then expand your AI agent's capabilities as you refine its performance.

## Limitations

* **A configured company domain is required.** An address can't send replies until forwarding, DKIM, and SPF are set up, and addresses on free email providers can't be added.
* **3 domains per AI agent, 20 addresses per domain.**
* **2 AI replies per minute per sender.** Extra emails from the same sender in that window get a single "Email Rate Limit Exceeded" notice.
* **No outgoing attachments.** The AI agent can read attachments but can't send them.

## Frequently asked questions

> [accordion] Which Chatbase plan includes the Email channel?
>
> Any paid plan. Without one, the **Enable** button's tooltip reads "Upgrade to a paid plan to use the emails feature". The Email channel isn't available on HIPAA-compliant workspaces.

> [accordion] How fast does the AI agent reply to emails?
>
> With **Reply Delay** at 0, the reply is sent as soon as the AI agent has generated it. The total time depends on mail delivery and how long the model takes to write the reply. You can add a delay of up to 60 minutes.

> [accordion] Can several support addresses forward to one AI agent?
>
> Yes. One AI agent accepts up to 3 domains with up to 20 addresses each. Add each address in [Email settings](https://chatbase.co/docs/user-guides/chatbot/email-settings.md), and add it to [Reply addresses](#reply-addresses) so customers get replies from the address they wrote to.

> [accordion] Does the AI agent reply to everyone on CC?
>
> Yes. The reply goes to the sender, and everyone else on the original **To** and **CC** lines is copied, except your AI agent's own addresses.

> [accordion] Will the AI agent reply to out-of-office messages or newsletters?
>
> It doesn't reply to no-reply or system addresses such as `noreply@` or `mailer-daemon@`. Out-of-office replies and mailing lists aren't detected automatically, so add those senders to **Blocked senders** if they get unwanted replies.

> [accordion] Do I need a DMARC or MX record?
>
> No. Forwarding, DKIM, and SPF are what allow an address to send replies. DMARC is shown with a status but isn't required, and you don't change your MX records because mail reaches the AI agent through forwarding. See [Email settings](https://chatbase.co/docs/user-guides/chatbot/email-settings.md).

## Next steps

> [card] [Email settings](https://chatbase.co/docs/user-guides/chatbot/email-settings.md)
>
> Configure your domain, authentication records, and verified sending addresses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.