For the complete documentation index, see llms.txt. This page is also available as Markdown.

Zendesk Messenger

Set up an AI agent for Zendesk Messenger. It answers live chats on your website and help center in real time, then hands a chat to your team as a ticket.

eesel's AI agent for Zendesk Messenger answers live chats in the Zendesk Messaging widget on your website and help center. It replies in real time from what it learned from your Zendesk account. It answers in your existing widget, with the bot name, avatar and greeting you set, so there is no separate chat widget to install.

Zendesk Messenger is the live chat widget on your website and help center. Connect it and the same teammate that handles your tickets answers chats in real time, using everything it already learned from your Zendesk help center, macros and past tickets. There's no separate knowledge to set up.

Live chat takes every conversation. The agent answers every chat on the channels you switch on, and replies go out straight away because the customer is waiting. On handover it opens a Zendesk ticket, so nothing is lost when your team picks the conversation up.

The Zendesk Messenger widget open on a website, where eesel AI answers a question about a missing refund after checking the order details
Your agent answers live chats in the widget, looking up what it needs mid-conversation.

What you can do

  • Answer Zendesk Messaging conversations in real time, in the customer's language

  • Send rich replies in the widget: product carousels (up to 10 cards), forms, quick replies, and webviews

  • Hand a conversation to a human by creating a Zendesk ticket, with the fields you choose pre-filled

  • Auto-Handover, which hands over on its own when a chat goes idle, after a wait you set (5 to 60 minutes)

Set up eesel in Zendesk Messenger

You need an active Zendesk connection and Zendesk Messaging enabled in your Zendesk account.

1

Connect the widget

Ask your agent in the dashboard chat to set up Zendesk Messenger. It sends you the authorization link, and you approve eesel AI for Zendesk Conversations in your browser.

Or click through it: open Integrations > Zendesk in the left sidebar, find the Live chat row (that is Zendesk Messenger), and click Connect Zendesk Messaging Widget.

The dashboard chat where the user asks to set up Zendesk Messenger and the agent replies with the connect link
The agent posts the connect link in the chat.

Open the link and give your Zendesk subdomain.

The Zendesk sign-in screen asking for the account subdomain before authorizing
Zendesk asks for your account subdomain first.

Zendesk then asks you to allow eesel AI. It names what eesel can do: read your users' conversations, send messages on your behalf, and see profile information.

The Zendesk authorization screen asking to allow eesel AI, listing the three permissions it needs
The Zendesk approval screen with the three permissions listed.

This approval is the one step a person has to do in the browser. If an AI agent is doing the setup for you, it hands you the link and waits.

Check it worked. The Live chat row under Integrations > Zendesk now shows settings instead of the Connect button. From a terminal, eesel status lists Zendesk as connected.

2

Set the bot name, greeting and instructions

Once connected, open the Live chat row under Integrations > Zendesk again. It now shows settings. Set the bot name, avatar and welcome message. The same settings list your Zendesk messaging channels. Switch on each channel the agent should answer. You can also tell the agent how to behave in the widget: keep replies short, escalate refunds, never quote prices. Left blank, it uses its default behaviour. A clear greeting like "Hi! I'm Acme's AI assistant" tells customers they are talking to an AI.

The Live chat channel settings in eesel with avatar URL, bot name, welcome message and agent instructions
The Live chat settings, where you set the bot name, greeting and instructions.

Then check the automation is on. Open the agent's Automations page and make sure the Live chat row is switched on with Chat reply enabled.

3

Turn it on in Zendesk

In the Zendesk Admin Center, go to AI > AI agents > Manage Marketplace bots. Click eesel AI, tick every channel it should answer, and press Save. This replaces whatever answered those channels before, such as Zendesk's own bot. To check it worked, open Channels > Messaging. The channel should show eesel AI as its response type.

The Zendesk Admin Center Marketplace bots page listing eesel AI as the default bot with its connected channels
eesel AI set as the bot for your messaging channels in Zendesk.
4

Test it

Open the widget on your site or help center and ask something. Test the handover too. Ask for a human, then check the Zendesk ticket it creates has the fields you expect.

A Zendesk help center with the Messenger widget open and eesel answering a visitor's question
The agent answering a live question in the widget.

Actions

Action
What it does

Chat reply

Sends a message in the live chat conversation

Hand off live chat to a human agent

Transfers the chat to a human by creating a Zendesk ticket, fields pre-filled, and a tag on the ticket that points back to the chat it came from

You stay in control the whole way. Adjust your AI agent's access to knowledge and its action permissions to your liking. See Actions and Approvals.

If the customer keeps chatting after a handover, the agent can hand the same conversation over again. Auto-Handover can also create the ticket automatically when a chat goes idle for a wait you set, from 5 to 60 minutes. You switch it on in the Live chat settings under Integrations > Zendesk.

Limitations

  • Connected is not live. After you approve the connection, the agent answers nobody until you switch on at least one channel in eesel and pick eesel AI as the bot for it in Zendesk.

  • It answers every chat on a switched-on channel. There is no skip filter by topic or sender. Use channels and handover rules instead.

  • It needs the Zendesk ticket connection first. Messenger is set up from the Zendesk integration page.

  • At most 3 eesel live chat connections per Zendesk subdomain. See Troubleshooting below.

  • It replaces the bot on those channels. Picking eesel AI in the Zendesk Admin Center replaces whatever answered those channels before, such as Zendesk's own bot.

Troubleshooting

Messenger not responding?

Check the Live chat trigger is enabled on the agent's Automations page, each channel you want answered is switched on in the Live chat settings, eesel AI is the responder for those channels in the Zendesk Admin Center, and the Messaging Widget is actually deployed on your site.

Can't configure your Zendesk channels?

Make sure eesel AI is set as the responder for the corresponding channels in Zendesk (AI > AI agents > Manage Marketplace bots).

Zendesk refused the live chat connection?

One Zendesk subdomain supports at most 3 eesel live chat connections. A refusal means all 3 slots are taken, usually by another eesel workspace at your company or an old test workspace. Contact eesel support with your subdomain and we'll free one up.

Handoff not working?

Verify the Hand off live chat to a human agent action is turned on, and that human agents are available in Zendesk to accept the conversation.

FAQ

How do I add an AI chatbot to Zendesk Messenger?

Connect Zendesk first, then ask your agent in the dashboard chat to set up Zendesk Messenger and approve the link it sends. Switch on your channels in the Live chat settings, and pick eesel AI as the bot in the Zendesk Admin Center. Connecting alone does not reply to anyone: the agent only answers once the Live chat trigger and its actions are on, and only on the channels you turn on. The steps are in Set up eesel in Zendesk Messenger.

Does the Zendesk Messenger AI agent send replies or draft them?

It sends. A customer in live chat is waiting, so replies go out in real time. To keep a person in the loop, use handover rules: name the topics it should pass to your team, and it opens a Zendesk ticket for them.

How do I make sure a customer can always reach a human in Zendesk Messenger?

Turn on Hand off live chat to a human agent, and turn on Auto-Handover so a chat that goes quiet is handed off after a wait you set. When the agent hands over, it creates a Zendesk ticket for your team to pick up.

Can I control which chats the Zendesk Messenger AI agent answers?

Yes, by channel, but not by topic or sender. Choose channels in two places: toggle them in the Live chat configuration on the eesel dashboard, and choose which channels use eesel AI as the responder in the Zendesk Admin Center. On a switched-on channel it answers every chat, so tell it which topics to hand to your team instead.

How is Zendesk Messenger different from the Zendesk ticket integration?

Messenger handles live chat, and the ticket integration handles tickets. The standard Zendesk integration is asynchronous, with the full set of reply, tag, assign and close actions. Zendesk Messenger works through the Messaging Widget in real time, with chat reply and human handover. Same agent and same knowledge, in a different place.

Is Zendesk Messenger the same as Zendesk Sunshine Conversations live chat?

Yes. Zendesk Messenger runs on Sunshine Conversations, Zendesk's messaging platform. When you connect, you approve eesel AI for Zendesk Conversations, and eesel answers the chats on the channels you choose. You do not need to build anything with the Sunshine Conversations API yourself.

Can I connect Zendesk Messenger to Claude or ChatGPT?

Yes, through eesel. You can talk to your eesel agent from Claude, ChatGPT or Cursor, and it works with the same Zendesk knowledge it uses in live chat. See Use eesel from Claude and other assistants, Use eesel from ChatGPT and Claude Code and MCP clients.

What reporting do I get for the Zendesk Messenger AI agent?

The Activity page lists every chat your agent handled, with what it searched, each action it took, and its reasoning. The Reports page shows volume and triggers over time. You can also ask your agent for a written report, or put one on a schedule.

Last updated