Mapping Amazon Connect attributes to Contact Center ticket fields

Admins can configure attributes captured on calls to customize and optimize contact center operations. For example, to provide agents with context about the call or user. You configure these attributes by mapping Amazon Connect contact attributes to ticket fields in Zendesk Support through Contact Center.


What's my plan?






Add-on

Contact Center






Summary: ◀▼
You can map Amazon Connect contact attributes to ticket fields to provide agents with relevant call context. Create user-defined attributes in contact flows, then link them to custom or existing ticket fields. This setup helps capture key customer interaction details, like order numbers or ticket IDs, directly in tickets, improving support efficiency and personalized service.


Admins can configure attributes captured on calls to customize and optimize
contact center operations. For example, to provide agents with context about the call or
user. You configure these attributes by mapping Amazon Connect contact attributes to ticket fields in
Zendesk Support through Contact Center.
This article contains the following topics:

Understanding Contact attributes
Mapping Connect attributes through Contact Center



Understanding Contact attributes

Amazon Connect contact attributes are key and value pairs that store
information about a customer interaction. Think of them as labels or tags that carry
data throughout the lifecycle of a call, chat, or task within your contact center.
For example, admins might configure a contact attribute to provide agents with a
caller’s most recent order number, and then add that to the ticket using a mapping
to a ticket field.
As an admin, you can create user-defined contact attributes in Amazon Connect flows.
These can be populated by querying an external database, pulling
data from unified customer profiles, or capturing direct customer input. You can also use
the Zendesk-specific contact attributes. For example, to determine if the customer
is calling about an existing ticket before handing the call to an agent.
The following are Zendesk-specific contact attributes that you can use in
your flows:








Contact attribute
Description


zendesk_ticket_id
If this attribute is set in the contact flow, it's used
to attach the call to the corresponding ticket with that ID or to
create a new ticket with that ID.


conversation_title
This attribute is used for the ticket and voice comment
title, otherwise it uses the default.


zendesk_user_id

This attribute is set based on matching the user and
phone number.

Note: Using the value of this attribute from the contact flow isn't
currently supported.



zendesk_agent_id
The ID of the Zendesk user that answers the
call.


zendesk_call_id
The ID of the call object that Contact Center creates
when an agent accepts a call.







Mapping Connect attributes through Contact Center

You can map Amazon Connect attributes from a Contact flow to a Zendesk
ticket field through Contact Center. Mapping a Connect attribute to a Zendesk ticket
field involves the following tasks:

Adding Connect attributes to contact flows
(Optional) Adding custom ticket fields

Mapping Connect attributes to ticket fields



Adding Connect attributes to contact flows

To add a Connect attribute to a contact flow


In Amazon Connect, select Routing > Contact
flows.


Select the contact flow to edit.


Add a Set contact attributes block to the flow, to capture the
attribute.
For more information, see How contact attributes work in
Connect Customer.


Add a User defined key and value.


Click Confirm, to confirm the block's configuration.


Click Save, to save the flow.


A contact attribute is now captured and assigned to calls through the flow.
For more details, see the Amazon Connect contact attributes
guide.



Adding custom ticket fields

You can add custom ticket fields or use existing ticket fields to map to an
attribute. For more information on custom ticket fields including example use cases,
see Adding custom ticket fields to your tickets
and forms.



Mapping Connect attributes to ticket fields

To map a Connect attribute to a ticket field


Click the Zendesk product menu in the top bar, then select
Contact center.


Under General, click Contact attributes.


Click Add new attribute.


Enter the Contact attribute key and select the corresponding Ticket
field.



Tip: The name of a contact attribute and the ticket fields
that’s mapped to it are independent of one another.



Click Add contact attribute.


The attribute mapping between Amazon Connect and Zendesk is now in place.
After refreshing your Zendesk workspace, you can perform a test call to confirm that
the Contact attribute is captured in tickets.



{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/10880620037914-Mapping-Amazon-Connect-attributes-to-Contact-Center-ticket-fields",
"url": "https://support.zendesk.com/hc/en-us/articles/10880620037914-Mapping-Amazon-Connect-attributes-to-Contact-Center-ticket-fields",
"headline": "Mapping Amazon Connect attributes to Contact Center ticket fields",
"description": "You can configure and map Amazon Connect contact attributes to ticket fields in your contact center to provide agents with relevant call context and optimize operations.",
"articleSection": "Product help",
"datePublished": "2026-06-08T22:10:02.161492+00:00",
"dateModified": "2026-06-08T22:10:04.853709+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/10880620037914-Mapping-Amazon-Connect-attributes-to-Contact-Center-ticket-fields"