Skip to content

Set up escalation to a person

Connect Zendesk Live, then build a custom workflow with trigger keywords, a Form block and a Zendesk Live Agent block set to Live Chat With Agent. Live chat handoff works with Zendesk only. Stores on Freshdesk or Gorgias escalate by opening a ticket instead.

Use this guide when shoppers ask to talk to a person and you want the AI Shopping Assistant to pass the conversation to a live agent in Zendesk. Live chat handoff works with Zendesk only. If your store uses Freshdesk or Gorgias, or your Zendesk plan doesn’t include messaging, see Escalate with a ticket instead.

  1. In Zendesk Admin Center, go to Apps and integrations > Conversations API and create an API key. Copy the app ID, the key ID and the secret key. Zendesk shows the secret key only once.

Connect live chat in the console

  1. In the Webscale AI console, open the account menu and select Integrations. On the Zendesk Live card, select Connect.
  2. Enter the App ID, Key ID and Secret key from Zendesk.
  3. Select Create. The page shows Connector created successfully! and stays open as Update Zendesk Live Credentials.
  4. Select the Verify connection icon beside Update. A bar at the top of the page shows Connection verified when Webscale AI can reach Zendesk. If verification fails, the reason shows next to the icon.
  1. In the Webscale AI console, open the account menu and select Integrations. On the Zendesk Live card, select Connect.
  2. Enter the App ID, Key ID and Secret key from Zendesk.
  3. Select Create. The page shows Connector created successfully! and stays open as Update Zendesk Live Credentials.
  4. Select the Verify connection icon beside Update. A bar at the top of the page shows Connection verified when Webscale AI can reach Zendesk. If verification fails, the reason shows next to the icon.

Build the workflow

  1. Go to Assistant > Agents, open the agent and select the Custom workflows tab. Select Create custom workflow and rename the workflow with the pencil icon, for example Talk to a person.
  2. Select the Trigger block. Under Keywords, add the phrases shoppers use, pressing Enter after each one, for example "talk to a person", "speak to an agent" and "live agent".
  3. On the Blocks tab, select Form to add it below the trigger. Keep the default name and email fields, which are both required.
  4. Select Zendesk Live Agent to add it below the form. Select the Setup tab and check that the app card shows Zendesk Live as connected and that Action event reads Live Chat With Agent, the default.
  5. On the Configure tab, type / to insert the form's values.
  6. Select Message to add it below the Zendesk Live Agent block. Write a closing message that fits both outcomes, such as thanks for chatting plus how to reach your team by email.
  7. Select End to add it as the last block.
  1. Go to Assistant > Agents, open the agent and select the Custom workflows tab. Select Create custom workflow and rename the workflow with the pencil icon, for example Talk to a person.
  2. Select the Trigger block. Under Keywords, add the phrases shoppers use, pressing Enter after each one, for example “talk to a person”, “speak to an agent” and “live agent”.
  3. On the Blocks tab, select Form to add it below the trigger. Keep the default name and email fields, which are both required.
  4. Select Zendesk Live Agent to add it below the form. Select the Setup tab and check that the app card shows Zendesk Live as connected and that Action event reads Live Chat With Agent, the default.
  5. On the Configure tab, type / to insert the form’s values:
    • Customer email: the form’s email field
    • Customer name: the form’s name field
    • Note for agent: context for your team, such as the reason the shopper asked for help
    • Wait for an agent (seconds): how long to wait for someone to accept. The default is 300
    • End chat after inactivity (seconds): how long an idle chat stays open. The default is 300
  6. Select Message to add it below the Zendesk Live Agent block. Write a closing message that fits both outcomes, such as thanks for chatting plus how to reach your team by email.
  7. Select End to add it as the last block.

Nothing is stored until you save. The Save button in each block’s panel saves the whole workflow too.

Save and check it is on

  1. Select Save. The builder shows "Custom workflow saved successfully".
  2. Go back to the Custom workflows tab and check that the workflow's Status switch is on.
  1. Select Save. The builder shows “Custom workflow saved successfully”.
  2. Go back to the Custom workflows tab and check that the workflow’s Status switch is on.

Ask a teammate to sign in to Zendesk and be ready to accept a messaging conversation. On your storefront or in the agent’s Playground, send a message with one of your keywords, such as “Can I talk to a person?” Enter a name and email when asked.

You should see a message that a member of the team will join in a moment. In Zendesk, your teammate should see the conversation with your note and the last 6 messages. Send a message from each side to check that they arrive. Type bye to end the chat. Your closing message should appear next.

A ticket is the way to reach a person when live chat isn’t available. This covers stores on Freshdesk or Gorgias and Zendesk plans without messaging. The custom workflow collects the shopper’s email, opens a ticket and tells the shopper your team will follow up.

Build the workflow with these blocks, in order: Trigger, Form with an email field, a Zendesk, Freshdesk or Gorgias block set to Create Ticket, Message and End. Create a custom workflow that opens a Zendesk ticket walks through it for Zendesk. Send conversations to Gorgias as tickets covers Gorgias.

Problem Fix
The Zendesk Live card won’t connect Check the App ID, Key ID and Secret key against the Conversations API key in Zendesk Admin Center. Create a new key if you no longer have the secret. Check that your Zendesk Suite plan has messaging turned on
Nobody in Zendesk sees the conversation Check that Action event is Live Chat With Agent
The shopper is always told nobody is available Make sure someone in Zendesk is available to accept messaging conversations. Raise Wait for an agent (seconds) if your team needs longer to respond
The chat closes while the shopper is still deciding Raise End chat after inactivity (seconds). The minimum is 60
The Queue value doesn’t route the chat to a group Queue is passed to Zendesk as a label. It doesn’t choose a group
The workflow never starts Check that Status is on and that HIDDEN on the Trigger block is cleared. Add the exact phrases shoppers use as keywords

Frequently asked questions

Can the AI Shopping Assistant hand a live chat to Gorgias or Freshdesk?
Not today. Live chat handoff works with Zendesk only. With Gorgias or Freshdesk, a custom workflow collects the shopper's details and opens a ticket. Your team follows up from the helpdesk.
What happens if nobody in Zendesk accepts the chat?
After the time set in Wait for an agent (seconds), the shopper is told nobody is available. The workflow then continues with the next block, so write a closing message that works in either case.
What does the Zendesk agent see when a chat is handed over?
The Zendesk agent sees your Note for agent and the last 6 messages of the conversation. Messages then pass both ways until the chat ends.
Do I need a separate Zendesk connection for live chat?
Yes. Live chat uses the Zendesk Live connection, with keys from the Conversations API. Tickets use the Zendesk connection. Connect both if you want live chat and tickets.
How does a shopper end a live chat?
The shopper can say bye or ask to end the chat. The chat also ends when the Zendesk agent closes it or when it sits idle longer than End chat after inactivity (seconds).