Skip to main content
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: You can’t connect Zendesk Messaging and Sunshine on the same AI agent. Zendesk Messaging and the Zendesk ticketing integration can run together.
Zendesk Messaging doesn’t need the Zendesk ticketing integration, because it uses its own connection. Two features need the ticketing integration as well: handoff by email and the conversation link field.

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

Choose channels for Chatbase in Zendesk

Click Chatbase.
Chatbase in the list of marketplace bots
Under Channels, select each channel Chatbase should answer, then click Save. The Responder column changes to Chatbase.
Selecting channels for Chatbase and saving
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
Open the Connections tab. Turn on each channel this AI agent should answer, then click Save.
Turning on a channel in the Connections tab
Your AI agent doesn’t answer any channel until you turn it on here.
Each channel row shows one of these: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.
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
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
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.
Escalations 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.
Attachments are supported, so your AI agent can read files customers send. See 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

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

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.
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.
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.
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.
“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.
An AI agent can use Zendesk Messaging or Sunshine, not both. Disconnect Sunshine on the Integrations page first.

Frequently asked questions

No. Zendesk Messaging has its own connection. You only need the Zendesk ticketing integration for handoff by email and for writing the conversation link into a ticket field.
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.
With Zendesk Messaging, customers chat in your Zendesk channels and handoffs go to Zendesk Agent Workspace. With Sunshine, 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.
No. A channel can only be claimed by one agent at a time. You can use different AI agents on different channels.
The Basic plan or above, with an active subscription.
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

Zendesk

Let your AI agent reply to Zendesk tickets, or open a ticket when a chat needs a person.

Sunshine

Hand customers from the Chatbase widget to a live Zendesk agent.