> This page is for version Generative (default).
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Zendesk Chat handoff usage

## Overview\[#overview]

By integrating Zendesk Chat and Ada, you can provide your customers with a
frictionless experience that instantly hands them off from the AI Agent to a
live agent. The customer will begin their
conversation with the AI Agent, and if required, live agents will be
invited to join the chat to support the customer - all within the same
interface.

This article has been designed to outline the experience on the Zendesk
side of things once you have configured Ada with your Zendesk
environment. For detailed instructions on configuration, please see
[Configure Zendesk Chat](/generative/docs/handoffs/zendesk/zendesk-chat/zendesk-chat-configuration).

> **Note**
>
> The number of handoff platforms your organization can use varies
> depending on your subscription package. For more information, see Ada's
> [Pricing](https://www.ada.cx/pricing) page, or contact your Ada team.

## Customer Experience\[#customer-experience]

When the customer reaches the point in the handoff dialog where the Zendesk Live
Agent block has been placed, they will be added to the appropriate
queue, provided the customer is within your support department's operating hours. Within their chat window they will be provided with a banner
indicating their queue position and will no longer have the ability to
chat with the AI Agent.

![](/_fern-files/_img/72b7eae0ea692753ac57681d1a302dea50e50f0a022ca49abe7e7ab2f06724d3.webp)

The agent joins the conversation in the same chat window. This creates a
seamless customer experience. The agent's name and Ada live agent avatar
display in the chat window. To personalize the Ada live agent avatar,
navigate to **Channels** > **Chat** > **Appearance** > **Chat window** > **Avatar**.

![](/_fern-files/_img/5da9915338f629874d2539c9ae671b932e7f6f851dd7ba3d672458e1eb41d395.webp)

> **Note**
>
> Currently, the customer is unable to end the chat with the live agent, so
> the live agent will have to do it instead.

## Agent Experience\[#agent-experience]

When the customer reaches the point in the handoff dialog where the Zendesk Live
Agent block has been placed, Ada will route the
conversation to your live agent(s), placing them in a queue until a human agent becomes available. The handoff process relies
on the Zendesk routing mechanisms, meaning that you will want to ensure
that your departments or groups and hours of operation are appropriately
configured within Zendesk.

The Zendesk department or group that you identify in the [Zendesk Live Agent Block](/generative/docs/handoffs/zendesk/zendesk-chat/zendesk-chat-handoff-setup) will be the
department customers are routed to for handoff. If there are no agents
available in the preferred department, either due to your queues being
full, or all agents being offline, the customer will be routed to the
the Off-Hours dialog.

If the request to handoff to a live agent comes outside of your live
chat hours of operation (as set in Zendesk), the AI Agent will route the
customer to the Off Hours dialog. Your live agent can then choose to
accept the chat from the Zendesk dashboard, as normal.

If the AI Agent has captured specific information from the customer, such as
their name, email, or phone number, that information will map to the
chat, as will any tags you have set up on the Zendesk Live Agent Block.
They will also see the conversation the customer had with the AI Agent leading
up to the handoff, as well as any tags included in the Live Agent Block.

![](/_fern-files/_img/22c3882d8540f483b82b7efc7403d50478d539fe65f236f30610bd8a7caf79d1.webp)

> **Note**
>
> You must turn on the *Automatic ticket creation* setting within Zendesk
> in order for tickets to be created when a handoff occurs.

As a reminder, what is handed over from the AI Agent to the live agent is the
transcript up to the point when the customer transferred to the live
agent queue. Further, please note that the agent will not be able to see
what the customer is typing before they send the message. They will see
*that* they are typing, but not *what* they are typing.

When your live agent is speaking with a customer who transferred over
from speaking with the AI Agent, the live agent will have access to all of
their usual Zendesk actions, including transferring chat to another
agent, creating a ticket, and more. Please note that when a customer
speaks with an agent, the chat populates in the ticket as a public
comment; however, in email tickets, the chat populates as a private
comment.

![](/_fern-files/_img/5bc648cba2bd37818a9239b0acf1eaf284041eff55ca4d0e2f2325ef15108108.webp)

If a customer goes idle (triggered between 20 seconds and 2 minutes of not
having the chat window in focus, or 20 mins of inactivity), the
conversation with the agent will automatically be ended, and the customer
will be provided with any dialog blocks that follow the Zendesk Live
Agent Block. The customer can re-escalate if they would like to reconnect
to an agent.

## Transcript Summaries\[#transcript-summaries]

With Transcript Summaries, Ada can automatically attach a summary of a
customer's conversation to a handoff transcript. This summary helps human
support agents quickly determine the reason for the escalation.

> **Note**
>
> Transcript summaries are currently available for Zendesk Live Chat
> (Zopim and ZAW), Zendesk Ticketing, Salesforce Livechat, and the Email
> Handoff block.

* The feature examines the customer's messages and looks for key phrases
  that represent what the customer is trying to ask or do.

* The summary includes up to three customer messages.

* The summary appears after the last message of the transcript.

* Summaries only consider the customer's text messages, and not button
  clicks or AI Agent messages.

* Summaries are available for English conversations only.

> **Note**
>
> It is possible that the customer's intent can’t be determined. In this
> case, no summary is attached.

## File Transfer\[#file-transfer]

The file transfer in Zendesk Chat provides a two-way file
transfer, meaning both customers and agents can share files within the
live agent chat conversation. By default, customers and agents can share
the following file types: JPEG, PNG, GIF, PDF, and TXT, to a maximum of
20 MB, with only one file being shared at a time. To enable additional
filetypes, you can add them in your Zendesk settings. To learn how, see
[Managing file sending in live chat](https://support.zendesk.com/hc/en-us/articles/4408886202394-Managing-file-sending-in-live-chat)
at Zendesk's documentation.

The customer will have the option to either drag and drop or click the
paperclip icon to select the file from their computer. If they click the
paperclip icon they will be provided with a window in which to select
their file, and only files that meet the limitations mentioned above
(file type and size) will be selectable, all other files will be greyed
out. If the customer drags and drops an unsupported file they will
receive an error message alerting them that the file is too large,
unsupported, etc.

The experience of the agent will be the same as that of the standard
Zendesk live agent chat, where agents can click the file icon in the
Zendesk live chat interface to share a file with the customer.

Once shared, the files are hosted in Zendesk, but those with access to
the Ada dashboard will be able to view the files from with in the
Conversations view.

## Additional Information\[#additional-information]

* We do not currently support live agent surveys.

* We do not support rating requests from agents.

* Zendesk triggers are not supported.

* For clients on Zendesk Agent Workspace — [Tags are supported](https://support.zendesk.com/hc/en-us/articles/4408822099738#topic_bpk_stc_zmb),
  as well as the automatic mapping of *name*, *email*, and *phone*
  variables to ticket fields as long as they are lower case global
  variables in Ada.

* We *do* support the ability for agent-to-agent transfers, cold
  transfers, and transfers to departments in both Zopim and Zendesk Agent
  Workspace.

* We support the following transfers for both Zopim and Zendesk Agent
  Workspace:

  * Agent-to-agent (transfer and leave, or invite).

  * Transfer to department.

## Frequently Asked Questions\[#frequently-asked-questions]

**Q: My conversations appear to be disconnecting, why is this?**

There are a few reasons why the conversation may be disconnected:

* If the customer is on a mobile device, and the device goes to sleep,
  the live agent will be disconnected (this is intended behaviour from
  Zendesk and not Ada-related).

* If the customer is using a computer, and browser privacy is enabled, if
  the user navigates away from the page, the live agent will be
  disconnected.

**Q: Can more than one agent be involved in a conversation?**

No. Currently only one agent can be involved in a conversation at one
time. If more than one agent is involved in a conversation, all the
information will be routed to the first original agent. Any subsequent
agents will not receive any information.

**Q: What happens when the live agent ends a chat?**

Any blocks, as well as quick replies, can be included after the live
chat handoff block, so that when live chat ends, the AI Agent can re-greet
the customer.

![](/_fern-files/_img/36f0831833db56c1af73b79a8c6250442c01f46e146f16858a24d7016a03092c.webp)

**Q: After agent to agent transfer will the second agent get the same
transcript?**

Yes, they will.

**Q: Do we support the Zendesk automatic translation feature?**

Yes, we do. Ada is also multi-lingual, so all languages are
supported out of the box. For example, messages announcing the customers
queue, presence messages, etc. are all translated.

**Q: Do we support emojis in live chat?**

Yes, we do.

**Q: Is Zendesk Chat through Ada supported on mobile?**

Yes, on iOS and Android.

**Q: I have set everything up, but when I attempt to hand off to an
agent, I get a ‘Conversation ended’ message.**

The Zendesk API’s client secret or ID have probably expired or were
deleted. Please re-generate the client secret and update it in the
Settings > Platform > Zendesk Live Chat platform modal. If that
doesn't work, you may need to whitelist the AI Agent by adding the AI Agent's URL
to your whitelist.

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).