> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.

# Amazon Connect email handoff

The Amazon Connect email integration lets an AI Agent create an inbound Email Contact in Amazon Connect. Use it when a conversation needs follow-up by email instead of a live chat. The Email Contact routes in Amazon Connect like any other inbound email, and agents work it as a ticket.

The email integration is a separate app from the Amazon Connect live chat integration. It uses its own credentials and its own block. You can install one or both.

## Capabilities

The **Amazon Connect Email** block has one action, **Create an inbound email contact**. The action sends an email to an inbound address in your Amazon Connect instance, which creates an Email Contact.

The action accepts the following inputs:

| Input                                        | Required | Description                                                                                        |
| -------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------- |
| **Amazon Connect Destination Email Address** | Yes      | The inbound email address in Amazon Connect that receives the Email Contact.                       |
| **User Email Address**                       | Yes      | The email address of the end user.                                                                 |
| **Email Subject**                            | Yes      | The subject of the Email Contact.                                                                  |
| **Email Content**                            | Yes      | The body of the Email Contact, for example the conversation transcript.                            |
| **User Name**                                | No       | The name of the end user.                                                                          |
| **Additional CC Email Addresses**            | No       | More addresses to copy on the Email Contact.                                                       |
| **Additional Recipient Email Addresses**     | No       | More recipient addresses for the Email Contact.                                                    |
| **Amazon Connect Contact Flow ID**           | No       | The Contact Flow that handles the Email Contact.                                                   |
| **Attributes**                               | No       | A JSON object of Contact Attributes to set on the Email Contact, for example `{"key1": "value1"}`. |

## Collect your AWS details

The app calls the Amazon Connect API with an IAM user. Create the user and collect the values that you enter when you connect the app.

**To collect your AWS details:**

1. In the AWS IAM console, create an IAM user for the integration.
2. Give the user the `connect:StartEmailContact` permission.
3. Create an access key pair for the user in **Security credentials** > **Create access key**.
4. Record the following values:
   * **Amazon Connect Instance ID**: the UUID after `/instance/` in the instance ARN.
   * **AWS Access Key ID**
   * **AWS Secret Access Key**
   * **AWS Region**: the region of your Amazon Connect instance, for example `us-east-1`.

> **Info**
>
> Your Ada team installs the Amazon Connect Email app on your AI Agent. Contact your Ada representative to confirm when this step is complete before you continue.

## Connect the app

After your Ada team installs the app, enter your AWS details so that the AI Agent can create Email Contacts.

**To connect the Amazon Connect Email app:**

1. In your AI Agent dashboard, go to **Config** > **Apps**.
   The **Amazon Connect Email** app appears in the list.
2. Click **Connect**.
3. Enter your AI Agent handle in **Bot Handle**, then enter the values from [Collect your AWS details](#collect-your-aws-details).
4. Click **Save**.

![The Amazon Connect Email connection dialog, with fields for Bot Handle, Amazon Connect Instance ID, AWS Access Key ID, AWS Secret Access Key, and AWS Region.](/_fern-files/_img/83e3b6bbc8a7c3edc94146004c1c44e1876daa3d2f36071e3d9c59cf57844766.webp)

## Configure the email Handoff block

Add the block to a Handoff so that the AI Agent creates an Email Contact when the conversation escalates.

**To configure the Amazon Connect email Handoff block:**

1. In your Handoff, add the **Amazon Connect Email** block.
2. In **Action**, select **Create an inbound email contact**.
3. Set the four required inputs. Map AI Agent variables into the inputs where the value changes per conversation.
4. Optional: add more inputs from **Select Optional Inputs**.
5. Select the **Track as Handoff** check box. This step is recommended.

![The Amazon Connect Email block with the Create an inbound email contact action, showing variables mapped to the destination email address, user email address, email subject, email content, and user name inputs.](/_fern-files/_img/d395f1cb56e33a7aa02af804b320dbf279cabd74f81e418fb86958fe67f06936.webp)

## Pass contact attributes

Contact Attributes carry data from the conversation to the Email Contact. The Contact Flow in Amazon Connect can read them, for example to route the Email Contact.

You can pass Contact Attributes in two ways:

* **Attributes input:** Enter a JSON object of one or more key-value pairs in the **Attributes** input. Use this for attributes that change per conversation.
* **Named inputs:** Ask your Ada team to add a named input to the block for each attribute. Give your Ada team the attribute key that your Contact Flow expects and a display name for the block. After your Ada team deploys the change, the input appears in the block. The value you map into it is sent with the key you gave.

You can add more named inputs at any time.

---

Have any questions? Contact your Ada team, or email us at [](mailto:help@ada.cx?subject=Help%20Docs%20inquiry).