Skip to main content

​
Overview

The Escalations action lets your AI agent hand a conversation to a human. When triggered, it creates a ticket in the helpdesk platform you choose, including the customer’s details and the conversation so your team can pick up where the agent left off.

Best for:

Issues the agent can’t resolve and that don’t need an answer this second: anything your team can work as a ticket and follow up on.
Common Use Cases:
  • “I want to speak to a human”
  • “Connect me to support”
  • “This didn’t solve my issue”
  • “I need help with my billing”
The Escalations action in the Chatbase dashboard
Escalations open a ticket for asynchronous follow-up. If you’d rather route the customer to a human in real time, use Chatbase live chat instead.

​
Before you start

The action can only create tickets in a platform you have already set up. Only connected platforms appear in the Ticket platform dropdown when you create the action.
  • To use Chatbase Helpdesk, click Helpdesk inbox in the sidebar and enable it from there.
  • To use a third-party platform, go to Integrations in the sidebar and connect it.
Supported platforms:

​
How to create the action

1

Navigate to Actions

Go to your Chatbase dashboard and select your agent. Click Build > Actions in the left sidebar.
2

Create the Action

Click Create action, then select Create ticket under Escalations.
3

Configure General Settings

Action Name: A descriptive name that helps the agent understand when to trigger the action, such as create_ticket, create_ticket_refunds, or create_ticket_whatsapp.Ticket platform: The platform where tickets are created. The options in the next section depend on this choice.When to use: Explain clearly when the agent should create a ticket. The field comes prefilled with a default you can edit, and Reset restores it:
To restrict the action to procedure steps only, turn on Only use in procedures. When it’s on, the When to use field is hidden, because the agent no longer decides when to call the action.
4

Configure details collection

This section changes based on the ticket platform you picked. See Details collection by platform below.
5

Choose Channels

Use Channels to control where the action is available. Toggle the action on or off for each configured channel, such as Chat bubble, Help page, or WhatsApp, then click Save. Some channels may be incompatible with the action and won’t be available for selection.
6

Enable and Test

Click Save & enable to make the action available to your agent, then test it.

​
Details collection by platform

​
Chatbase Helpdesk

When the ticket platform is Chatbase Helpdesk, you choose how the agent collects the customer’s details before opening the ticket. How should details be collected? This setting applies to the chat bubble and Help page. Other channels, such as WhatsApp and Instagram, always collect details conversationally. Collect additional details: The fields the agent gathers before creating the ticket. Subject and Description are built in and always collected. Click Add field to add your own, each with a name, a type, and a description that tells the agent what to ask for. Use the pencil icon to edit a field or the X to remove it from this action. The agent must collect every required field before it opens the ticket. Turn off Required to let the agent create the ticket even if the customer never provides that field.
Chatbase Helpdesk details collection
Fields are shared across your helpdesk. Click Manage fields to open Custom fields, where you can create and edit them for every action.

​
Zendesk

When the ticket platform is Zendesk, you control what goes on the ticket. Conversation context: What the ticket contains. Internal note (optional): A private note added to the ticket for your team. Use variables in double curly braces to have the agent fill in details from the conversation. For example:
Custom fields (optional): Chatbase reads the custom fields defined in your Zendesk account and lists them here. Select the ones you want on the ticket, and the agent fills them in automatically from the conversation.
Zendesk details collection

​
Other platforms

Salesforce, Intercom, Zoho Desk, Freshdesk, HubSpot, Help Scout, Gorgias, and Odoo have no platform-specific options. Complete the General and Channels sections and the agent creates the ticket with the customer’s details and an AI-written summary of the conversation.

​
How it works

When the action triggers, the agent:
  1. Collects any details it still needs from the customer.
  2. Creates a ticket in the selected platform.
  3. Includes the customer’s information and the conversation on the ticket.
Your team continues the conversation from the helpdesk platform.
Test the action by asking your agent to speak to a human, and confirm a ticket appears in your chosen platform with the details and conversation attached.

​
Limitations

  • The full transcript is only available for Zendesk. Every other platform receives an AI-written summary of the conversation.
  • The form collection mode applies to the chat bubble and Help page only. Other channels always collect details conversationally.

​
Best Practices

Clear Escalation Criteria

Spell out when the agent should escalate and when it should keep trying, so customers aren’t handed off prematurely or left stuck.

One Action per Context

Create separate actions for different contexts, such as create_ticket_refunds and create_ticket_whatsapp, when they need different rules or fields.

Collect What Your Team Needs

Add the fields your team would otherwise have to ask for, so the ticket arrives ready to work.

Require Sparingly

Every required field is another thing the agent must extract before it can open the ticket. Mark the rest optional.