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

# Connect your AI agent to Zendesk tickets

> Let your AI agent reply to Zendesk tickets directly, or escalate conversations by opening a Zendesk ticket

The Chatbase Zendesk integration connects your AI agent to Zendesk Support tickets. The AI agent can reply to tickets as one of your Zendesk agents, draft replies your team reviews, and open a Zendesk ticket with a summary when a conversation on another channel needs a person. One connection covers all of these, and ticket replies and escalation can run on the same AI agent at the same time.

> [card] What you can do:
>
> Have the AI agent answer Zendesk tickets on its own, draft replies for a human to review, or open a ticket the moment a chat conversation needs a person.

## Which Zendesk option should I choose?

Chatbase has three Zendesk integrations. Pick based on where your customers write in and how your team works.

| Option | What it does | Best for |
| - | - | - |
| **Zendesk** ticket replies (this page) | **Auto-respond** lets the AI agent answer tickets as a Zendesk agent. **Draft responses** gives your team a button that writes a reply to review. | Teams whose customers write in through Zendesk tickets |
| **Zendesk** escalation (this page) | An [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) Action (**Create ticket**) opens a Zendesk ticket when a conversation on another channel, such as the Chat Bubble or email, needs a person. | Teams that chat with customers through Chatbase and work follow-ups in Zendesk |
| [Zendesk Messaging](https://chatbase.co/docs/user-guides/integrations/zendesk-messaging.md) | The AI agent answers inside your Zendesk Messaging channels and hands the chat to your team in Agent Workspace. | Teams already using Zendesk's Web Widget, mobile SDKs, or other messaging channels |
| [Sunshine](https://chatbase.co/docs/user-guides/integrations/sunshine.md) | Live chat from Chatbase's own Chat Bubble, Center Stage, or Help Page to a Zendesk agent, whose replies come back into the chat. | Real-time handoff to Zendesk agents from the Chatbase widget |

Ticket replies and escalation use the same Zendesk connection and can run together. Zendesk Messaging uses its own connection and doesn't need this one, except for email handoff and the [conversation link field](#conversation-link-on-tickets). Zendesk Messaging and Sunshine can't both be connected on one AI agent.

## Available capabilities

| Capability | What it does |
| - | - |
| [AI ticket responses in Zendesk](#ai-ticket-responses-in-zendesk) | The AI agent replies to incoming Zendesk tickets, or drafts a reply for a human to review |
| [Human escalation via ticket creation](#human-escalation-via-ticket-creation) | The AI agent opens a Zendesk ticket when a chat conversation needs a person |
| [Conversation link on tickets](#conversation-link-on-tickets) | Chatbase writes a link to the matching Chatbase conversation into a Zendesk ticket field |

## Before you start

* A Chatbase account with an AI agent. If you haven't built one yet, [create a Chatbase account](https://www.chatbase.co/auth/signup) and follow [Your first AI agent](https://chatbase.co/docs/user-guides/quick-start/your-first-agent.md).
* A Zendesk account, and your Zendesk subdomain.
* The Chatbase **Basic** plan or higher.

The connection is per AI agent, and each AI agent connects to one Zendesk subdomain.

## AI ticket responses in Zendesk

### How to connect Zendesk

**1. Open your Chatbase AI agent**

Head to your [dashboard](https://www.chatbase.co/dashboard/) and click the AI agent you wish to integrate with Zendesk.

**2. Find the Zendesk integration**

Click the **Channels** tab, find the **Zendesk** integration, and click **Setup**.

![The Zendesk card on the Channels tab](https://mintcdn.com/chatbase/tFta2uWaJCqIJoQ6/user-guides/integrations/images/zendesk/zendesk-2.png?fit=max\&auto=format\&n=tFta2uWaJCqIJoQ6\&q=85\&s=a03bf73eefde3987c33e1d7ebf213a5f)

**3. Authorize the integration**

A new tab will open. Enter your Zendesk subdomain and click **Submit**. You'll be asked to log in to your Zendesk account to authorize the integration.

![Entering your Zendesk subdomain to authorize](https://mintcdn.com/chatbase/JnjROJ-aB2q57UGe/user-guides/integrations/images/zendesk/zendesk-4.png?fit=max\&auto=format\&n=JnjROJ-aB2q57UGe\&q=85\&s=849c6bbe2c94a6932919681a241b17d8)

**4. Configure the integration**

Once authorized, click **Manage** to configure the integration.

![The Zendesk integration configuration screen](https://mintcdn.com/chatbase/cxa5wAgB2G5Q-lMr/user-guides/integrations/images/zendesk/zendesk-6.png?fit=max\&auto=format\&n=cxa5wAgB2G5Q-lMr\&q=85\&s=e9facc7a95ae9a56c8d935fdd7307dbe)

Under **Auto-respond**, select the following options:

* The Zendesk agent that the bot will reply as.
* Whether tickets should be automatically assigned to the AI agent (**Auto-assign to new tickets**).
* The AI agent's instructions specifically on Zendesk. This is useful if you want to instruct the AI agent to escalate the ticket to a human in certain cases, for example if the customer asks for a refund.

Then click **Save**.

![Saving the Zendesk integration configuration](https://mintcdn.com/chatbase/8OVB0cNPFgIgFsxo/user-guides/integrations/images/zendesk/zendesk-7.png?fit=max\&auto=format\&n=8OVB0cNPFgIgFsxo\&q=85\&s=5c43ba9f1a8d78db0dfe5c51e0c33a89)

### Which tickets the AI agent replies to

The AI agent replies to tickets that meet all of these:

* The ticket is assigned to the Zendesk agent you selected.
* Its status is below **Solved**.
* It doesn't have the `chatbase-no-ai`, `chatbase-routed-to-team`, or `chatbase-relay` tag.

Chatbase creates a Zendesk trigger named **Chatbase Agent: Ticket Updated** that sends the ticket to the AI agent when the customer updates it or when it's assigned to the selected agent. With **Auto-assign to new tickets** on, Chatbase also creates **Chatbase Agent: Auto Assign**, which assigns every new, unassigned ticket without the `chatbase-no-ai` or `chatbase-relay` tag to that agent. Chatbase doesn't filter tickets by channel, brand, or group.

Each reply is a **public** comment posted as the selected agent. Allow 1 to 2 minutes for the reply to appear on the ticket.

> [!NOTE]
>
> Tickets with attachments or images go to a human instead of getting an AI reply.

When the AI agent can't resolve a ticket, or your Zendesk instructions tell it to route the ticket, it escalates: it adds the `chatbase-routed-to-team` and `chatbase-no-ai` tags and unassigns the ticket so your team can pick it up. If it had already replied on the ticket, it first posts a public comment telling the customer the issue is important and that the team will follow up.

### Generate Draft Response

Don't want the AI agent to respond directly? Enable **Generate Draft Response** to review and edit the AI-generated response before it's sent.

**1. Enable the feature**

Once you've configured the integration, you can enable **Generate Draft Response** with a single click under **Draft responses**. If several AI agents are connected to the same Zendesk subdomain, turn on **Set as default chatbot** on the AI agent that should write the drafts.

![Enabling Generate Draft Response](https://mintcdn.com/chatbase/tFta2uWaJCqIJoQ6/user-guides/integrations/images/zendesk/enable-zendesk-generate-draft-response.png?fit=max\&auto=format\&n=tFta2uWaJCqIJoQ6\&q=85\&s=c874ca6d89531fdecb3bed91b330bebd)

**2. Generate a draft in a ticket**

Navigate to the **composer toolbar** at the bottom of the ticket editor, click the Chatbase icon, then click **Generate Draft Response**.

![Generating a draft response from the Zendesk composer toolbar](https://mintcdn.com/chatbase/06fxyzzd9XhLSQS1/user-guides/integrations/images/zendesk/editor-generate-draft-response.png?fit=max\&auto=format\&n=06fxyzzd9XhLSQS1\&q=85\&s=f52e819ee6e5470b7da1390969810798)

### Remove the draft response from Zendesk

The **Generate Draft Response** button comes from the **Chatbase** app installed in Zendesk Support. Disconnecting Zendesk in Chatbase doesn't remove it. The button stays visible, but it won't work. To remove it, uninstall the app in Zendesk:

1. In Zendesk, open **Admin Center**.
2. Go to **Apps and integrations > Apps > Zendesk Support apps**.
3. Find the app named **Chatbase**.
4. Open its menu, choose **Uninstall**, then confirm.
5. Ask your agents to refresh Zendesk. Anyone with it already open keeps seeing the app until they do.

> [!WARNING]
>
> Don't remove the **Chatbase** bot under **Apps and integrations > Integrations > Conversations integrations** by mistake. It connects your AI agent to [Zendesk Messaging](https://chatbase.co/docs/user-guides/integrations/zendesk-messaging.md) channels like WhatsApp and web messaging, and removing it stops the AI agent answering there. It doesn't remove the draft response button.

If you no longer use any Zendesk features, you can also disconnect the Zendesk integration in your Chatbase dashboard.

### Tag management system

You can use the tags the AI agent assigns to tickets to track its performance.

| Tag | When it's applied |
| - | - |
| `chatbase-involved` | Applied to all tickets Chatbase replied to |
| `chatbase-routed-to-team` | Applied to tickets the AI agent couldn't resolve, or was instructed to route to your team. The ticket is also tagged `chatbase-no-ai` and unassigned |
| `chatbase-soft-resolved` | Applied to tickets the AI agent thinks are resolved, but the customer hasn't confirmed |
| `chatbase-hard-resolved` | Applied to tickets where the customer confirmed the problem is resolved |
| `chatbase-no-ai` | Applied to tickets to stop the bot from auto-assigning itself or replying |

Add `chatbase-no-ai` to a ticket yourself to keep the AI agent off it. Chatbase also uses `chatbase-relay` and channel tags such as `chatbase-channel-email` on tickets that relay your team's replies back to the customer, as in an [email handover](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md#email-handover-with-zendesk). The AI agent doesn't reply to tickets tagged `chatbase-relay`.

***

## Human escalation via ticket creation

**1. Connect Zendesk**

Choose **Integrations**, then connect your Zendesk account to authorize access. If you already connected Zendesk from **Channels**, it's the same connection and you can skip this step.

![Connecting Zendesk from the Integrations page](https://mintcdn.com/chatbase/tFta2uWaJCqIJoQ6/user-guides/integrations/images/zendesk/zendesk-8.png?fit=max\&auto=format\&n=tFta2uWaJCqIJoQ6\&q=85\&s=44d9039baecbd9a55194cf5f0ab8e4b2)

![Authorizing the Zendesk connection](https://mintcdn.com/chatbase/8OVB0cNPFgIgFsxo/user-guides/integrations/images/zendesk/zendesk-9.png?fit=max\&auto=format\&n=8OVB0cNPFgIgFsxo\&q=85\&s=57a56a82cdbea291ee63844f3e7d4de4)

**2. Create the Escalations Action**

Configure your Escalations Action to route tickets to Zendesk. Follow the [Escalations Action guide](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) to set it up.

> [!TIP]
>
> Test the integration by asking your AI agent to speak to a human, and confirm a ticket appears in Zendesk with the conversation attached.

> [!NOTE]
>
> **Escalations from the Email channel pause the AI agent.** Once the ticket exists, the AI agent stops replying to the customer's email thread and your team answers from Zendesk instead. Marking the ticket **Solved** or **Closed** returns the thread to the AI agent. See [Email handover with Zendesk](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md#email-handover-with-zendesk).

Escalation tickets get the conversation as a **private** first comment, and a private comment with a link to the conversation in Chatbase. The summary is written in the customer's language. Creating a ticket uses no extra message credits beyond the AI agent's normal reply. The Escalations Action can't be turned on for the Zendesk channel itself, because those tickets are already handled in Zendesk.

> [!TIP]
>
> Zendesk is the only escalation platform that can receive the **full conversation transcript**, with the customer's files attached. Every other platform receives an AI-written summary. See [Details collection by platform](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md#zendesk).

***

## Conversation link on tickets

Chatbase can write a link to the Chatbase conversation into a ticket field on every Zendesk ticket tied to a Chatbase conversation, so your team can open the full conversation from the ticket. That covers escalation tickets, tickets the AI agent replies to, email handover tickets, [Zendesk Messaging](https://chatbase.co/docs/user-guides/integrations/zendesk-messaging.md) conversations, and [Sunshine](https://chatbase.co/docs/user-guides/integrations/sunshine.md) handoffs.

To turn it on:

1. Create a text field in Zendesk that end users can't edit.
2. In Chatbase, go to **Integrations**, find the **Zendesk** card, and click **Settings**.
3. In the **Conversation link field** dialog, pick that field. Only text fields that end users can't edit are listed.

Escalation tickets always get a private comment with the link too, even when no field is chosen.

This setting lives on the **Integrations** card. The reply settings (**Auto-respond** and **Draft responses**) live under **Channels > Zendesk**.

## Disconnecting or switching subdomains

Click **Disconnect** on the Zendesk card to disconnect. Chatbase lists the Escalations Actions that use Zendesk and asks you to confirm, because disconnecting deletes them. The draft response app stays in Zendesk until you [remove it](#remove-the-draft-response-from-zendesk).

Each AI agent connects to one Zendesk subdomain. Reconnecting the AI agent to a different subdomain uninstalls the Chatbase app from the old one. One subdomain can serve several AI agents.

## Troubleshooting

> [accordion] The AI agent doesn't reply to a ticket
>
> Check that the ticket is assigned to the Zendesk agent selected under **Auto-respond**, its status is below **Solved**, and it doesn't carry `chatbase-no-ai`, `chatbase-routed-to-team`, or `chatbase-relay`. Tickets with attachments or images go to a human. Replies take 1 to 2 minutes to appear.

> [accordion] New tickets aren't assigned to the AI agent
>
> Turn on **Auto-assign to new tickets** under **Auto-respond**. Tickets that are already assigned, or tagged `chatbase-no-ai` or `chatbase-relay`, aren't auto-assigned.

> [accordion] Escalation tickets stopped appearing
>
> If Zendesk access was revoked, ticket creation fails and nobody is notified. Open the conversation in **Activity > Conversations** and check the Action's **Result** for the error. Disconnect and connect Zendesk again, then recreate your Escalations Action, because disconnecting deletes it.

> [accordion] The field I want isn't listed in Conversation link field
>
> Only text fields that end users can't edit are listed. Change the field in Zendesk so customers can't edit it, or create a new one.

> [accordion] The Generate Draft Response button doesn't work
>
> Check that Zendesk is still connected in Chatbase. If you disconnected it, the button stays visible but doesn't work until you uninstall the app. See [Remove the draft response from Zendesk](#remove-the-draft-response-from-zendesk).

## Frequently asked questions

> [accordion] Do ticket replies and escalation need separate Zendesk connections?
>
> No. **Channels > Zendesk** and **Integrations** use the same connection, and both features can run on one AI agent at the same time.

> [accordion] How do I stop the AI agent from replying to a ticket?
>
> Add the `chatbase-no-ai` tag to the ticket, or assign it to someone other than the agent selected under **Auto-respond**.

> [accordion] Are AI replies public or internal?
>
> Public. Each reply is a public comment posted as the Zendesk agent you selected. To review replies before they go out, use [Generate Draft Response](#generate-draft-response) instead.

> [accordion] What's the difference between Zendesk, Zendesk Messaging, and Sunshine?
>
> **Zendesk** works with tickets: the AI agent replies to tickets and opens escalation tickets. [Zendesk Messaging](https://chatbase.co/docs/user-guides/integrations/zendesk-messaging.md) puts the AI agent inside your Zendesk messaging channels. [Sunshine](https://chatbase.co/docs/user-guides/integrations/sunshine.md) hands customers from the Chatbase widget to a live Zendesk agent. See [Which Zendesk option should I choose?](#which-zendesk-option-should-i-choose)

> [accordion] Can I connect one AI agent to several Zendesk subdomains?
>
> No. Each AI agent connects to one subdomain, and reconnecting to a different subdomain uninstalls the Chatbase app from the old one. Several AI agents can connect to the same subdomain.

## Next steps

> [card] [Escalations Action](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md)
>
> Configure when your AI agent escalates, what goes on the ticket, the internal note, and which Zendesk custom fields it fills in.

[YouTube video player](https://www.youtube.com/embed/TxXAZlvwF68)


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