Skip to navigation

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:

InputRequiredDescription
Amazon Connect Destination Email AddressYesThe inbound email address in Amazon Connect that receives the Email Contact.
User Email AddressYesThe email address of the end user.
Email SubjectYesThe subject of the Email Contact.
Email ContentYesThe body of the Email Contact, for example the conversation transcript.
User NameNoThe name of the end user.
Additional CC Email AddressesNoMore addresses to copy on the Email Contact.
Additional Recipient Email AddressesNoMore recipient addresses for the Email Contact.
Amazon Connect Contact Flow IDNoThe Contact Flow that handles the Email Contact.
AttributesNoA 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.

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.
  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.

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.

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.