> For the complete documentation index, see [llms.txt](https://docs.wonderchat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wonderchat.io/integration-guides/email.md).

# Email (Gmail, Outlook, IMAP)

Connect your support mailbox (Gmail, Outlook, iCloud or IMAP) or use a Wonderchat address, so every customer email becomes a ticket in the Inbox with an AI-drafted or AI-sent reply.

The email integration connects a support address to your AI agent. Every customer email becomes a ticket in the [Inbox](https://docs.wonderchat.io/setup-guides/inbox-feature.md), where the AI drafts a reply for your team to review, or sends it for you if you allow that.

You can bring email in two ways:

* **Connect your own mailbox** (Gmail / Google Workspace, Outlook / Microsoft 365, iCloud, or any IMAP inbox). Replies are sent from your address and show up in your mailbox's Sent folder.
* **Claim a Wonderchat address** such as `acme-support@mail.wonderchat.io`. No mailbox needed. Use it on its own, or forward your existing support address to it.

{% hint style="info" %}
This page covers connecting email and setting up how the AI replies. For working the tickets themselves (assigning, approving actions, replying, spam), see the [Inbox](https://docs.wonderchat.io/setup-guides/inbox-feature.md) guide.
{% endhint %}

***

## Open the email settings

1. Go to **Agents** and click **Edit** on your agent's card.
2. Under **Appearance**, open **Installation**, then the **Integrations** tab.
3. Click **Connect** on the **Email** tile.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-fb82fe4172c0eff9af7916a1ef8cdfb38b4ba7ca%2Femail-installation-tile.jpg?alt=media" alt="Installation tab, Integrations, with the Email tile at the bottom"><figcaption><p>The Email tile in Installation → Integrations</p></figcaption></figure>

You can also get here from an empty Inbox: click **Connect** next to Email in the **Bring conversations in** card.

The **Email** window lists every inbox connected to this agent, and the options to add one.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-d1ed50c505bbc169b89e778b3f19e7b9a8afbc04%2Femail-connect-options.jpg?alt=media" alt="Email window with Add a Wonderchat address, Connect Gmail, Connect Outlook, Connect iCloud and Connect another inbox (IMAP)"><figcaption><p>Claim a Wonderchat address, or connect your own mailbox</p></figcaption></figure>

Settings save as you change them. There's no Save button.

***

## Option 1: Connect your own mailbox

1. Click **Connect Gmail**, **Connect Outlook**, **Connect iCloud** or **Connect another inbox (IMAP)**.
2. A new tab opens on your email provider's sign-in page. Sign in and allow access.
3. You're brought back to Wonderchat and the mailbox appears in the list as **Active**.

Sign-in goes through Nylas, our email partner (SOC 2 Type II, ISO 27001, HIPAA, GDPR). You sign in on your provider's screen, Wonderchat never sees your password, and you can disconnect at any time.

{% hint style="warning" %}
If nothing happens when you click Connect, your browser blocked the pop-up. Allow pop-ups for Wonderchat and try again.
{% endhint %}

### Shared or personal mailbox

Once connected, open the mailbox and make sure **Turn incoming emails into tickets** is on. Then choose the **Inbox type**:

* **Shared** (for addresses like support@ or help@): every email becomes a ticket in the Inbox.
* **Personal** (a teammate's own mailbox): only customer requests become tickets, and they're assigned to the mailbox owner. Everything else stays in the mailbox and is never stored in Wonderchat. Forwards and emails from known customers always come through.

### Filters

Filters decide which emails the AI answers. Add an **Include** filter to let matching emails through, or an **Exclude** filter to skip them. You can filter on:

* **Subject contains**
* **From email** or **From domain**
* **Gmail label** (Gmail only), **Outlook folder** or **Outlook category** (Outlook only)
* **AI condition**: describe it in plain English, for example "Emails that are genuine customer support requests".

{% hint style="info" %}
Filters only control the AI. On a shared mailbox, every email still becomes a ticket, so nothing is lost if the AI skips it.
{% endhint %}

### Moving a mailbox to another agent

A mailbox can only be connected to one agent. If you connect one that's already on another agent you can edit, Wonderchat asks **Move this inbox here?** Click **Move here** and its settings move with it. Tickets it already opened stay where they are.

***

## Option 2: Claim a Wonderchat address

A Wonderchat address is a hosted inbox. It's the fastest way to start, and it works with any email provider.

1. In the Email window, click **Claim** next to **Add a Wonderchat address**.
2. Type the name you want (for example `acme-support`) and click **Claim address**.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-e3ef17b94fd4ce2285db8513dd42db42b17e19c0%2Femail-claim-address.jpg?alt=media" alt="Claim a Wonderchat address form with the handle acme-support"><figcaption><p>Pick a name for your Wonderchat address</p></figcaption></figure>

Every email sent to the address opens a ticket in the Inbox, and your replies are sent from it.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-2d4d7009aca7b27dab3b95896fd4df9f1ac0fbe6%2Femail-hosted-address-settings.jpg?alt=media" alt="Settings for acme-support@mail.wonderchat.io"><figcaption><p>Settings for a Wonderchat address</p></figcaption></figure>

### Forward your existing support address

To keep using your own address publicly, set up forwarding from it to your Wonderchat address in your email provider's settings. Gmail sends a confirmation code when you add a forwarding address. Wonderchat catches that email so it doesn't become a ticket, and shows the code in the Email window with **Copy code** and **Confirm in Gmail** buttons.

{% hint style="info" %}
With forwarding, customers still email your own address, but your replies are sent from the Wonderchat address. To reply from your own address, connect it as a mailbox ([Option 1](#option-1-connect-your-own-mailbox)) instead. You can also do this from the ticket composer: click **Send from your own address** next to **From**.
{% endhint %}

### Rename or release the address

* Click the pencil next to the address to rename it. The old address stops working, and mail sent to it bounces.
* Click **Release address** to give it up. Mail to it bounces, open tickets can't reply from it any more, and someone else may claim the name. This can't be undone.

***

## AI reply settings

These settings are the same for a connected mailbox and a Wonderchat address. Open the inbox in the Email window to change them.

### Respond to incoming emails

Turn on **Respond to incoming emails** to have the AI draft or send replies from its knowledge base. When it's off, emails still become tickets, but the AI doesn't reply. On a Wonderchat address it's off until you turn it on.

### When to respond

**Response mode**:

* **Auto-draft — review before sending** (default): the AI writes a draft, and a teammate reviews and sends it from the Inbox.
* **Auto-reply — send immediately**: the AI sends the reply itself.

Turn on **Schedule by business hours** to treat working hours differently. Set your timezone, days and hours, then choose what the AI does **During hours** and **After hours**: **Off**, **Draft** or **Auto-send**. A common setup is Draft during hours and Auto-send after hours, so customers get an answer at night and your team reviews during the day.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-a7dd9ed579e843ad6cdd8036b6ace64092450fd5%2Femail-business-hours.jpg?alt=media" alt="Business hours schedule with Draft during hours and Auto-send after hours"><figcaption><p>Draft during business hours, auto-send outside them</p></figcaption></figure>

When auto-send is in use, **Auto-reply delay** holds each reply for up to an hour before sending. If a teammate replies during the delay, the AI's reply is cancelled.

### Guardrails

All three are on by default:

* **Draft instead of sending when unsure**: low-confidence or unsupported answers become drafts for your review, even in auto-reply mode.
* **Skip emails that need no reply**: the AI doesn't reply to closing messages like "Thanks, that's all" or to FYI emails.
* **Stand down when a human replies**: pending drafts and scheduled replies are withdrawn once you or a teammate answer.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-dc0aedbaa7f269e1e7cfce0096bcd837457675b6%2Femail-guardrails.jpg?alt=media" alt="Guardrails and Writing settings"><figcaption><p>Guardrails keep the AI from sending when it shouldn't</p></figcaption></figure>

### Writing

* **Instructions**: tell the AI how to handle email, for example "Always ask for the order number before discussing a refund." Click **Customize drafts vs auto-replies** to give separate instructions for drafts (a teammate reviews them) and auto-replies (sent straight away).
* **Signature**: added to the end of every AI reply.
* **Writing style**: describe how replies should sound, or click **Generate from my sent emails** (for a mailbox) or **Generate from our ticket replies** (for a Wonderchat address) to build it from your past replies.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-062846125968ab69a383602a148eafb46e698af2%2Femail-writing-settings.jpg?alt=media" alt="Writing settings: instructions, signature and writing style"><figcaption><p>Instructions, signature and writing style</p></figcaption></figure>

### Activity

Click **Activity** on a mailbox to see the last 30 days: emails processed, replies sent, drafts created and failures, with a log of each email and what the AI did with it.

***

## How email tickets behave

* **Replies come from the address the ticket arrived on**, and they thread into the customer's existing email conversation.
* **Two-way sync.** If someone replies straight from Gmail or Outlook, the reply shows up on the ticket. A teammate's email that the customer isn't on is added as an internal note. Extra recipients join the ticket's **Cc**, so they get later replies too.
* **Full context.** When an existing email thread becomes a ticket, the earlier messages are imported too.
* **Attachments.** Files and inline images from customers are imported to the ticket. When you reply, images are sent inline and other files go out as download links.
* **Automated mail** (bounces, auto-responders, newsletters) still becomes a ticket but is never auto-replied to, so the AI never gets into a loop with another robot. An out-of-office reply on an existing ticket is added as a note.
* **Thank-you replies close the ticket.** A customer reply normally moves the ticket back to **On us**. If the last email from your side fully answered the customer and they write back with only a short thanks, the ticket closes instead. If they write again, it reopens.
* **Spam.** Emails your provider already marked as spam go to the Inbox's **Spam** view. You can also turn on Wonderchat's own spam filter in [Ticket settings](https://docs.wonderchat.io/setup-guides/inbox-feature.md#spam).
* **Forwarded emails.** If a teammate forwards a customer's email into the support mailbox, the ticket is opened for the original customer, not the teammate. Emails through a Google Group are credited to the real sender.

***

## Disconnect a mailbox

Open the mailbox in the Email window and click **Disconnect email**, then **Disconnect**. All its filters and settings are removed. You can also tick the box to remove everything the agent learned from synced emails. That can't be undone.

***

## Plans

| Feature                                             | Plan              |
| --------------------------------------------------- | ----------------- |
| One email inbox (a mailbox or a Wonderchat address) | Every plan        |
| More than one email inbox                           | Starter and above |
| Replies without the "Sent with Wonderchat" line     | Starter and above |

***

## Related

{% content-ref url="/pages/jMrAfMQ1crEExLxm6Gyn" %}
[Inbox (Helpdesk)](https://docs.wonderchat.io/setup-guides/inbox-feature.md)
{% endcontent-ref %}

{% content-ref url="/pages/1wAJO0esCT0YJ3R4nAxW" %}
[AI Chatbot Handover to Human Support via Email](https://docs.wonderchat.io/setup-guides/human-handover-for-your-chatbots/ai-chatbot-handover-to-human-support-via-email.md)
{% endcontent-ref %}
