Zendesk integration
Zendesk is a customer service platform. Connect it to Conversational agent to hand customer service conversations, such as questions about orders, returns, or shipping, to your Zendesk AI agent and support team. The conversation continues in the Conversational agent chat window, so shoppers don’t have to leave the page.
To set up the integration, contact your Product Engagement Manager.
How the integration works
You define a list of customer service topics, such as order inquiries, returns, shipping policy, or requests to talk to a person. Conversational agent checks every shopper message. If a message matches one of your topics, Conversational agent hands the conversation to Zendesk:
- Handoff: Conversational agent sends the shopper’s message to Zendesk, together with a summary of the conversation. The summary can include products that the shopper or Conversational agent mentioned in the chat. It doesn’t include the shopper’s cart, products they only viewed, or product cards Conversational agent showed, unless the chat names them.
- Zendesk AI agent: Your Zendesk AI agent replies first. It may resolve the question or escalate to a human agent, based on how you've configured it in Zendesk.
- Live agent: When Zendesk escalates to a human agent, the shopper sees "Connecting you to a live agent", and then "Connected to a live agent" when the agent sends the first message. While the live session is open, the shopper's messages go directly to Zendesk.
- End of session: The session ends when the agent ends it or solves the ticket, or when the shopper selects End live support conversation. The shopper sees "The live agent session has ended" and continues with Conversational agent.
Questions that shoppers type in the search bar are handed off the same way.
NoteConversational agent doesn't decide when a human agent joins. Your Zendesk AI agent and Zendesk settings control the escalation.
Supported content
Your Zendesk AI agent and human agents can send these types of content to the shopper in the chat. Zendesk shows every message as delivered, even when the shopper can't see it, so keep your AI agent's replies and your agents' macros to the supported types.
| Content | What the shopper sees |
|---|---|
| Text | A chat message |
| Image | The image. A caption appears as a separate message. |
| File | A download link |
| Carousel | Scrollable cards with an image, title, description, and buttons. Card buttons can only open links. |
| Form | A form with text, email, and select fields, and a Send button |
| List, location, and template messages | Nothing |
| Buy, location request, and postback buttons | Nothing |
When a shopper submits a form, Conversational agent sends the answers to Zendesk. If the form has a field named name, givenName, or surname, Conversational agent also sets the ticket requester's name from it. To also add the shopper's email to the requester, the form needs a field named email, and the integration needs a Zendesk OAuth client. Your Product Engagement Manager can help you set this up.
What your agents see
Agents work in Zendesk as usual. Zendesk adds the conversation to the ticket as a chat transcript. Conversational agent adds a summary of the conversation to the conversation metadata. To show this context to agents, your Zendesk flow must read the conversation metadata.
By default, a signed-in shopper has one ongoing Zendesk conversation across chats and devices, so agents see one continuous thread.
Monitor handoffs in Marketing
Replies from Zendesk aren't used as context by Conversational agent and aren't billed. To track Zendesk activity, use the Conversational agent events in Marketing: filter for action = external_agent_respond and agent_name = zendesk. For details on filtering events, see Filtering data.
NoteEvent tracking in Marketing is available only if you use Conversational agent together with Marketing. If you use Conversational agent as a standalone product through the Conversational agent API, this tracking isn't available.
Data sharing
When a conversation is handed off, Conversational agent sends Zendesk the shopper’s latest message and an AI-generated summary of the chat so far. The summary may mention products from the chat, but this isn’t guaranteed.
When you delete a customer's data in Bloomreach, their conversation in Zendesk is deleted too. If your integration uses a Zendesk OAuth client, their Zendesk customer profile is also deleted, unless they still have a ticket that isn’t closed. Zendesk tickets aren’t deleted and keep their own copy of the chat, so erase them in Zendesk.
Limitations
- You can connect one customer service platform per agent.
- Shoppers can't upload files during a Zendesk session.
- After the shopper is back with Conversational agent, new messages from Zendesk aren't shown. Agent replies sent after the shopper ended the chat aren't shown.
- When a shopper ends the chat, the Zendesk ticket and agent session stay open. If the shopper is handed off again, the conversation continues in the same ticket.
- If a signed-in shopper chats on two devices at once, the device that last sent a message to Zendesk takes over the live session. This doesn’t happen if your integration opens a new conversation for each live session.
- Proactive messages from Zendesk aren't supported.
Updated 42 minutes ago

