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

# Use your AI agent in Zendesk Messaging

> Let your AI agent answer customers in your Zendesk Messaging channels and hand chats to your team in Zendesk

The Chatbase Zendesk Messaging integration deploys your AI agent as a bot inside your own Zendesk messaging channels, such as the Zendesk Web Widget, the mobile SDKs, or WhatsApp. The AI agent answers customers there, and when a customer needs a person, it passes the chat to your team in Zendesk Agent Workspace. Customers stay in the same Zendesk channel the whole time.

## How it differs from Zendesk ticketing and Sunshine

Chatbase has three Zendesk integrations. Each one covers a different setup:

| Integration | Where customers chat | What happens when they need a person |
| - | - | - |
| **Zendesk Messaging** (this page) | Your Zendesk messaging channels, with Chatbase set as the responder | The chat moves to Zendesk Agent Workspace |
| [Sunshine](https://chatbase.co/docs/user-guides/integrations/sunshine.md) | Chatbase's own widget: the Chat Bubble, Center Stage, or Help Page | A Zendesk agent takes the chat, and their replies appear in the Chatbase widget |
| [Zendesk](https://chatbase.co/docs/user-guides/integrations/zendesk.md) (ticketing) | Zendesk tickets, or any Chatbase channel for escalations | The AI agent replies on tickets, or opens an escalation ticket |

You can't connect Zendesk Messaging and Sunshine on the same AI agent. Zendesk Messaging and the Zendesk ticketing integration can run together.

> [!NOTE]
>
> Zendesk Messaging doesn't need the [Zendesk](https://chatbase.co/docs/user-guides/integrations/zendesk.md) ticketing integration, because it uses its own connection. Two features need the ticketing integration as well: [handoff by email](#handoff-by-email) and the [conversation link field](https://chatbase.co/docs/user-guides/integrations/zendesk.md#conversation-link-on-tickets).

## Before you start

* A Chatbase **Basic** plan or above.
* Admin access to a Zendesk account with at least one Messaging channel.

## How to connect Zendesk Messaging

**1. Connect Zendesk in Chatbase**

Open your AI agent in the [dashboard](https://www.chatbase.co/dashboard/) and go to **Integrations**. On the **Zendesk Messaging** card, click **Connect**.

A Zendesk window opens. Sign in and allow access. The card then shows **Connected**.

![The Zendesk Messaging card on the Integrations page, showing Connected](https://mintcdn.com/chatbase/2pM_1dDHy3XHQ-WT/user-guides/integrations/images/zendesk-messaging/connect-integration.png?fit=max\&auto=format\&n=2pM_1dDHy3XHQ-WT\&q=85\&s=47050e35e51f415571bd0132cd7a7ca9)

**2. Open marketplace bots in Zendesk**

In Zendesk Admin Center, go to **AI > AI agents**. Under **Marketplace bots**, click **Manage marketplace bots**.

![The Manage marketplace bots link in Zendesk Admin Center](https://mintcdn.com/chatbase/2pM_1dDHy3XHQ-WT/user-guides/integrations/images/zendesk-messaging/manage-marketplace-bots.png?fit=max\&auto=format\&n=2pM_1dDHy3XHQ-WT\&q=85\&s=f5dab0b2e0ae77fe9b73c45bed06f799)

**3. Choose channels for Chatbase in Zendesk**

Click **Chatbase**.

![Chatbase in the list of marketplace bots](https://mintcdn.com/chatbase/2pM_1dDHy3XHQ-WT/user-guides/integrations/images/zendesk-messaging/select-chatbase-bot.png?fit=max\&auto=format\&n=2pM_1dDHy3XHQ-WT\&q=85\&s=ad6903d89c51707174c0582f7345af0e)

Under **Channels**, select each channel Chatbase should answer, then click **Save**. The **Responder** column changes to **Chatbase**.

![Selecting channels for Chatbase and saving](https://mintcdn.com/chatbase/2pM_1dDHy3XHQ-WT/user-guides/integrations/images/zendesk-messaging/select-channels.png?fit=max\&auto=format\&n=2pM_1dDHy3XHQ-WT\&q=85\&s=5d775cdbf9bb007ad67c45c48cfc1019)

**4. Turn on channels in Chatbase**

In Chatbase, go to **Channels**. On the **Zendesk Messaging** card, click **Manage**.

![The Zendesk Messaging card on the Channels page](https://mintcdn.com/chatbase/2pM_1dDHy3XHQ-WT/user-guides/integrations/images/zendesk-messaging/channels-card.png?fit=max\&auto=format\&n=2pM_1dDHy3XHQ-WT\&q=85\&s=a09cb0ead7cd724487b0d9e1fbabe213)

Open the **Connections** tab. Turn on each channel this AI agent should answer, then click **Save**.

![Turning on a channel in the Connections tab](https://mintcdn.com/chatbase/2pM_1dDHy3XHQ-WT/user-guides/integrations/images/zendesk-messaging/connections-tab.png?fit=max\&auto=format\&n=2pM_1dDHy3XHQ-WT\&q=85\&s=5f7fa2ea9e6539b1727ea3ae2221a6a7)

> [!WARNING]
>
> Your AI agent doesn't answer any channel until you turn it on here.

Each channel row shows one of these:

| Row shows | What it means |
| - | - |
| The channel type, like **Web widget**, with a toggle | Chatbase is the responder for this channel in Zendesk. Turn the toggle on to have this AI agent answer it. When it's off, this agent stops answering the channel. |
| **Not assigned in Zendesk** | The channel wasn't selected for Chatbase in the previous step. Click it to open Zendesk Admin Center, when a link is shown. |
| **Used by agent** with an agent's name | Another AI agent already answers this channel. A channel can only be claimed by one agent at a time. |

If the tab shows **No Zendesk channels found**, your Zendesk account has no messaging channels yet. The tab lists up to 100 channels and shows **Showing the first 100 channels only.** when there are more.

> [!TIP]
>
> Send a message in one of the channels you turned on, like your Zendesk Web Widget. Your AI agent replies.

## Supported channels

Your AI agent can answer any messaging channel in your Zendesk account where **Chatbase** is set as the responder in Zendesk Admin Center. The **Connections** tab labels these channel types:

* Web widget
* iOS SDK, Android SDK, and Unity SDK
* WhatsApp
* Messenger
* Instagram
* Slack
* X (Twitter)
* LINE
* WeChat

Any other channel type appears under its Zendesk name.

## Hand off to a human

Add the **Live chat** Action so your AI agent can pass a chat to your team in Zendesk Agent Workspace.

**1. Create the Action**

Go to **Build > Actions** and open **Create Action**. On the **Zendesk Messaging** card, click **Live chat**.

![The Zendesk Messaging card with the Live chat Action](https://mintcdn.com/chatbase/2pM_1dDHy3XHQ-WT/user-guides/integrations/images/zendesk-messaging/live-chat-action-card.png?fit=max\&auto=format\&n=2pM_1dDHy3XHQ-WT\&q=85\&s=2c84d8de48b228d0ede46735ab7d1618)

**2. Choose when to hand off, then turn it on**

Edit **When to use** to describe when the AI agent should hand off. By default, it hands off when a customer asks for a person or the AI agent can't solve the issue.

Click **Continue**, then click **Enable**.

![Editing When to use and turning on the Live chat Action](https://mintcdn.com/chatbase/EhvCUQ4ZmSlhciUK/user-guides/integrations/images/zendesk-messaging/live-chat-action-settings.png?fit=max\&auto=format\&n=EhvCUQ4ZmSlhciUK\&q=85\&s=0934ed2d6ab19f232d3a67f281feb84f)

What happens during a handoff:

1. If the customer isn't signed in, the AI agent asks for their email. Customers signed in through Zendesk are never asked, because Zendesk already knows who they are.
2. The AI agent passes the chat to Zendesk Agent Workspace and stops replying. It sends no extra message of its own, so the customer's last message from the AI agent is the one that says a person is coming.
3. Your team takes it from there in Zendesk.
4. When your team ends the messaging session, the customer's next message goes to the AI agent again.

> [!NOTE]
>
> [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) Actions run here only when their ticket platform is Zendesk.

## How it works

* **Greeting.** When a customer opens a new chat in your Web Widget or app, the AI agent sends its initial messages.
* **Suggested messages.** These show as reply buttons the customer can tap.
* **Name and picture.** The AI agent uses its display name and profile picture.
* **Inactive chats.** A conversation ends after 24 hours without a message.
* **Conversations.** Chats appear in **Activity > Conversations** with the source **Zendesk Messaging**.

> [!NOTE]
>
> Attachments are supported, so your AI agent can read files customers send. See [Attachments](https://chatbase.co/docs/user-guides/chatbot/channels.md#attachments).

## Limitations

* Messages your team sends after a handoff don't appear in Chatbase.
* The AI agent replies with text only. It can't send files or images.

## Disconnect

> [!WARNING]
>
> Remove Chatbase from your channels in Zendesk first, or customers on those channels won't get a reply. In Zendesk Admin Center, go to **AI > AI agents > Manage marketplace bots**, click **Chatbase**, clear its channels, and click **Save**.

Then in Chatbase, go to **Integrations**, open the menu on the **Zendesk Messaging** card, and click **Disconnect**. This removes the connection and the **Live chat** Action from this AI agent.

## Troubleshooting

> [accordion] The AI agent doesn't reply in a channel
>
> Check both sides. In Zendesk Admin Center, go to **AI > AI agents > Manage marketplace bots**, click **Chatbase**, and confirm the channel is selected so the **Responder** column shows **Chatbase**. Then in Chatbase, open **Channels > Zendesk Messaging > Manage > Connections** and make sure the channel's toggle is on and saved.

> [accordion] A channel shows Not assigned in Zendesk
>
> Chatbase isn't the responder for that channel yet. Select the channel for Chatbase under **Manage marketplace bots** in Zendesk Admin Center, then come back to the **Connections** tab.

> [accordion] A channel shows Used by agent
>
> Another AI agent in your workspace already answers that channel. A channel can only be claimed by one agent at a time, so turn it off on the other AI agent first.

> [accordion] The handoff doesn't happen
>
> For signed-out customers, the AI agent needs an email before it can hand off. If the customer didn't share one, the chat stays with the AI agent. Also check that the **Live chat** Action is turned on and that its **When to use** matches the requests you expect.

> [accordion] Connecting fails with a subscription message
>
> "Please subscribe to a plan to install the Zendesk Messaging integration" means your workspace has no active Chatbase subscription. Zendesk Messaging needs the **Basic** plan or above.

> [accordion] I can't connect Zendesk Messaging because Sunshine is connected
>
> An AI agent can use Zendesk Messaging or Sunshine, not both. Disconnect [Sunshine](https://chatbase.co/docs/user-guides/integrations/sunshine.md) on the **Integrations** page first.

## Frequently asked questions

> [accordion] Do I need the Zendesk ticketing integration to use Zendesk Messaging?
>
> No. Zendesk Messaging has its own connection. You only need the [Zendesk](https://chatbase.co/docs/user-guides/integrations/zendesk.md) ticketing integration for handoff by email and for writing the conversation link into a ticket field.

> [accordion] Which Zendesk channels can the AI agent answer?
>
> Any messaging channel in your Zendesk account where Chatbase is set as the responder, including the Web widget, the iOS, Android, and Unity SDKs, WhatsApp, Messenger, Instagram, Slack, X (Twitter), LINE, and WeChat.

> [accordion] What's the difference between Zendesk Messaging and Sunshine?
>
> With Zendesk Messaging, customers chat in your Zendesk channels and handoffs go to Zendesk Agent Workspace. With [Sunshine](https://chatbase.co/docs/user-guides/integrations/sunshine.md), customers chat in the Chatbase widget, and a Zendesk agent's replies appear in that widget. One AI agent can use only one of the two.

> [accordion] Can two AI agents answer the same Zendesk channel?
>
> No. A channel can only be claimed by one agent at a time. You can use different AI agents on different channels.

> [accordion] Which Chatbase plan do I need?
>
> The **Basic** plan or above, with an active subscription.

> [accordion] Does the AI agent ask signed-in customers for their email?
>
> No. Customers signed in through Zendesk are never asked. Signed-out customers must share an email before the AI agent can hand them off.

## Next steps

> [card] [Zendesk](https://chatbase.co/docs/user-guides/integrations/zendesk.md)
>
> Let your AI agent reply to Zendesk tickets, or open a ticket when a chat needs a person.

> [card] [Sunshine](https://chatbase.co/docs/user-guides/integrations/sunshine.md)
>
> Hand customers from the Chatbase widget to a live Zendesk agent.


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