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

# Email

> Connect your team's Gmail or Microsoft 365 mailbox so customer emails land in your Inbox, your AI agent answers them, and replies go out from that same mailbox.

The **Email** channel connects a shared business mailbox (for example `sales@yourcompany.com` or `support@yourcompany.com`) to Ciarem. You connect it by signing in to the mailbox with Google or Microsoft, the same way you connect a calendar. Emails your customers send to it land in the same [Inbox](https://help.ciarem.ai/using-ciarem/inbox.md) as WhatsApp, Instagram and Messenger. Your AI agent reads and answers them like any other chat, and every reply goes out from that mailbox, in the same email thread.

Email is for **one-to-one conversations** with your customers: replies, and a new email to one contact. Bulk email campaigns are coming soon.

## Before you start

* The mailbox must be on **Google Workspace (Gmail)** or **Microsoft 365 (Outlook)**. Other email providers can't be connected.
* Connect a **shared business mailbox** your customers write to, such as `sales@` or `support@`, not a teammate's personal mailbox. Each teammate can log their own mailbox's email with contacts from [My mailbox](https://help.ciarem.ai/using-ciarem/my-mailbox.md).
* Only **admins** can connect a mailbox.
* Email must be included in your plan. If it is not, the connect window says "Email isn't included in your plan."
* You need to be able to sign in to the mailbox, or, on Microsoft 365, to an account that can open it.

## Connect a mailbox

**1. Open the Email page**

In the sidebar, go to **Channels**, then **Email**, and click **Connect a mailbox** (or **Add mailbox** if you already have one).

**2. Choose where the mailbox is**

Choose **Google** (Gmail or Google Workspace) or **Microsoft** (Outlook or Microsoft 365).

**3. Enter the sender name and, if needed, the address**

Type the **Sender name** your customers will see on your replies (for example, "Your Company Support").

If the address your customers write to is not the account you sign in with, turn on the switch and type the **Mailbox address**. Leave the switch off to connect the account you are about to sign in with. The switch reads:

* **Use an alias or a Google Group** for Google. An alias must belong to the account you sign in with and be verified in Gmail under **Settings**, **Accounts**, **Send mail as**. A Google Group address can't sign in, so it works through a member: sign in as a member who receives the group's mail and has the group's address under **Send mail as**. Ciarem only keeps the emails sent to that address; the account's other mail is not saved.
* **Use a shared mailbox** for Microsoft. It must be a shared mailbox the account you sign in with can open.

An address your organization already connected is refused right there, before the sign-in: "This mailbox is already connected." **Back** returns to the first step.

**4. Sign in and approve access**

Click **Continue with Google** or **Continue with Microsoft**, sign in, and approve the access Ciarem asks for. When the window closes, the mailbox appears on the Email page. Signing in with Google isn't available yet (the option reads "Continue with Google isn't available yet"); for now, connect a Microsoft 365 or Outlook mailbox.

### What access Ciarem asks for

* **Read your email**, so new emails in the inbox reach Ciarem, and so replies your team sends from Gmail or Outlook show up in Ciarem too.
* **Send email**, so the AI and your team can reply from the mailbox.
* Your **email address**, to know which mailbox you connected.

Ciarem only reads the mailbox's inbox and sent mail, and only sends from the mailbox you connected.

### If Google shows a warning screen

While Google is still reviewing Ciarem, Google may show a "Google hasn't verified this app" screen or block the sign-in. Your Google Workspace admin can mark Ciarem as trusted in the Google Admin console (**Security**, **Access and data control**, **API controls**, **Manage third-party app access**) so your team can sign in. If you still can't connect, write to [support@ciarem.ai](mailto:support@ciarem.ai).

## Manage your mailboxes

In **Channels**, then **Email**, the **Connected mailboxes** table lists each mailbox, its status (**Connected** or **Sync failing**) and when it was connected.

* Click a mailbox to open its page. There you change the **Sender name** and the **Signature** and click **Save changes**, and you can **Disconnect** the mailbox.
* The row's ⋯ menu has **Settings** and **Disconnect**.

The Email page also has a **Templates** card (**View templates**) and a **Campaigns** card (**View campaigns**). See [Email campaigns](https://help.ciarem.ai/channels/email-campaigns.md).

## What your team sees in the Inbox

Each customer gets one conversation, and each email becomes a message in it, marked with the email channel:

* New emails show up within seconds of reaching the mailbox.
* The **subject** shows above the message text.
* **Attachments** the customer sent are listed under the message as files you can open; images and videos show in the message itself.
* An email the customer wrote with **formatting** (bold, links, lists, images inside the text) shows that way in the conversation. When it is a reply, the earlier messages quoted below it are folded: click the **…** button under the text to read them.
* In the conversation list, an email shows the start of its text.

The [mobile app](https://help.ciarem.ai/mobile/inbox-on-mobile.md) shows emails with their formatting and folded quotes too, the Cc line under the subject, and attachments that open when you tap them. A reply from the app can carry several files too, but no voice notes.

On the Email page, each connected mailbox shows when it last synced. If the last sync failed, its status is **Sync failing**; open the mailbox to see the error.

## How replies work

* Your AI agent answers emails the same way it answers chats, following the same [transfer rules](https://help.ciarem.ai/ai-agent/human-handoff-and-escalation.md). A teammate can take over and reply from the Inbox at any time.
* Every reply sent from Ciarem goes out **from the connected mailbox**, under your sender name, in the **same email thread** as the customer's message. It is saved in the mailbox's **Sent** folder, so the thread there stays complete.
* A reply keeps everyone the customer had on the thread: the people in **Cc** on their last email get the reply too, and the Inbox shows them under the subject.
* If a reply fails, you can retry it from the Inbox.
* Email conversations get **no automatic follow-ups**: an agent's [follow-ups](https://help.ciarem.ai/ai-agent/follow-ups.md) only go out on the other channels.
* A reply from the Inbox can carry **files**: click the attach button and pick one or more (you can add more in the window that opens); they go out in the same email as your text, up to 17 MB in total from a Gmail or Google Workspace mailbox and 2 MB from a Microsoft mailbox. Sent files are listed under the message.
* Use the formatting button for **bold**, *italic* and ~~strikethrough~~ text; the customer sees it formatted in the email. The AI's replies can use bold, italic and strikethrough too.

You can add a **Signature** to a mailbox on its page (see [Manage your mailboxes](#manage-your-mailboxes)); it is added to the end of every reply sent from that mailbox.

### Replying from Gmail or Outlook

Your team can keep answering from Gmail or Outlook. Ciarem reads the connected mailbox's own **Sent** folder: a reply saved there shows up in the Ciarem conversation as a team reply, and the conversation is handed to a person, so the AI stops answering it. An email your team starts from the mailbox shows up in Ciarem only when it answers a thread Ciarem already has or goes to someone who is already a contact; mail to anyone else from the mailbox is left alone, so suppliers and colleagues never become contacts.

A reply that is not saved in that Sent folder never reaches Ciarem, and the AI keeps answering:

* **Google alias:** send the reply **as the alias**, picking it in the **From** field in Gmail. A reply sent from the account's own address is ignored.
* **Microsoft 365 shared mailbox:** by default Outlook saves a reply sent as the shared mailbox in the **sender's own** Sent Items, not the shared mailbox's. Ask your Microsoft 365 admin to turn on copying sent items for the shared mailbox: in the Microsoft 365 admin center, under **Teams & groups**, **Shared mailboxes**, open the mailbox and, under **Sent items**, turn on **Copy items sent as this mailbox** and **Copy items sent on behalf of this mailbox** (in Exchange PowerShell, `MessageCopyForSentAsEnabled` and `MessageCopyForSendOnBehalfEnabled`).

## Write a new email to a contact

You can start a new email thread with a contact from their page, without waiting for them to write first.

**1. Open the contact**

Go to **Contacts** and open the contact. They need an email address on their profile.

**2. Choose New email**

Click the **⋯** menu next to the contact's name and choose **New email**. You see it when the contact has an email address and your workspace has a connected mailbox. Agents see it only on contacts they own.

**3. Write the email**

If you connected more than one mailbox, pick the one to send **From**. Type a **Subject** and your **Message**, and attach files if you need to. Files follow the same limit as replies. The message has a formatting toolbar: headings, bold, italic, underline, lists, links, buttons and dividers. **Fields** inserts a value such as the contact's first name (`{{contact.first_name|there}}`; the text after `|` is used when the contact has no value), their company's name (with the [Companies](https://help.ciarem.ai/using-ciarem/companies.md) add-on on) or your own name, which is filled in when the email is sent. Admins on a plan with email campaigns can also add images, and can use **Start from a template**, which fills the subject and the message from an email template (**Channels**, **Email**, **Templates**); you can edit both before sending. The email goes out as a normal letter from your mailbox, without the footer and unsubscribe link a campaign carries.

**4. Send it**

Click **Send email**. The email goes out from the mailbox as a new thread with your subject, and Ciarem opens the conversation in the Inbox. The conversation is assigned to you, and when the contact replies, the reply lands in the same conversation.

If the contact already has an open email conversation on that mailbox, the new email is added to it instead of opening a second one.

## When Ciarem loses access to the mailbox

If the mailbox's password changes, someone removes Ciarem's access, or your admin blocks the app, Ciarem can no longer read or send from the mailbox. The mailbox then no longer appears in the **Connected mailboxes** table on the Email page, and your admins get an email about it. New emails stop arriving in the Inbox, and replies sent from Ciarem fail with a "This mailbox is no longer connected" error.

To fix it, go to the Email page, click **Add mailbox** and sign in to the same mailbox again. Your earlier conversations stay in the Inbox.

## Not available yet

* Sending **voice notes** from the Inbox on email.
* **Reactions** and **quoted replies** on email messages.
* **Marking emails as read** in your mailbox: emails Ciarem receives stay unread in Gmail or Outlook.
* **Importing older emails** received before you connected the mailbox.
* Mailboxes on providers other than Google and Microsoft.

To send one email to many contacts, see [Email campaigns](https://help.ciarem.ai/channels/email-campaigns.md).

## Troubleshooting

> [accordion] The address I typed is refused
>
> The account you signed in with can't use that address:
>
> * **Google:** the address must be an alias of the account you signed in with, verified in Gmail under **Settings**, **Accounts**, **Send mail as**. Add it there, then connect again.
> * **Microsoft 365:** the account you signed in with must be able to open that shared mailbox. Ask your Microsoft 365 admin for access, then connect again.

> [accordion] Another organization already connected this mailbox
>
> A mailbox can be connected to only one Ciarem organization. If it's yours, write to [support@ciarem.ai](mailto:support@ciarem.ai).

> [accordion] It asks me to sign in again and approve access
>
> Ciarem didn't get lasting access to the mailbox, or some permissions weren't approved. Click **Continue with Google** or **Continue with Microsoft** again and allow everything on the consent screen.

> [accordion] Microsoft says I need admin approval
>
> Some Microsoft 365 organizations only let an admin approve new apps. Ask your Microsoft 365 admin to approve Ciarem, then connect again.

> [accordion] No emails arrive in the Inbox
>
> Check that the mailbox still appears on the Email page: if it's gone, Ciarem lost access to it, so click **Add mailbox** and connect it again. If you connected a Google alias, only emails sent to that alias arrive. Then send a test email to the address from another account and wait a minute.

> [accordion] I replied from Outlook or Gmail but the AI kept answering
>
> Your reply didn't reach the connected mailbox's **Sent** folder, so Ciarem never saw it. With a **Google alias**, send the reply as the alias (pick it in Gmail's **From** field), not from the account's own address. With a **Microsoft 365 shared mailbox**, ask your Microsoft 365 admin to turn on **Copy items sent as this mailbox** and **Copy items sent on behalf of this mailbox** for the shared mailbox. Until then, take over the conversation from the Ciarem Inbox. See [Replying from Gmail or Outlook](#replying-from-gmail-or-outlook).


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