What you can do:
Before you start
- A Chatbase account on the Basic plan or higher, with an AI agent
- Your Gorgias subdomain, account email, and API key (see Find your Gorgias API key)
How to connect Gorgias
Open your Chatbase AI agent
Connect Gorgias
Enter your subdomain, email, and API key
Create the Escalations Action
Find your Gorgias API key
- Log in to your Gorgias account.
- Go to Settings > REST API.
- Create a new API key, or copy an existing one.
- Paste the API key into the Chatbase integration form, along with your account email and subdomain.

What the ticket contains
When the AI agent escalates, it first asks the customer for their email and name. If the channel or contact record already has them, such as the sender’s address on the email channel, those are used. Chatbase then creates the ticket through the Gorgias API:Example ticket
For example, a customer on the Chat Bubble asks to change the shipping address on an order they placed this morning. No Shopify Action can change the address, so the AI agent asks for their name and email and creates a ticket like this:- Subject: Change shipping address on recent order
- Customer: Jane Doe, jane@example.com
- First message: I placed an order this morning and need the shipping address changed to my new address before it ships.
- Internal note: conversation link in Chatbase, followed by the link to the conversation
Repeat escalations in the same conversation
If the same conversation already created a Gorgias ticket that’s still open, a new escalation doesn’t open a second ticket. The new request is added to the existing ticket as a message starting with “Update:”, and the AI agent tells the customer their existing ticket was updated. If that ticket is closed, deleted, or can’t be found, Chatbase creates a new one.Ecommerce escalation examples
Escalate to Gorgias when the AI agent can’t complete a request on its own. Common cases:- Order changes that no Action can make. Shopify Actions can’t cancel an order or change its shipping address. Add these to the Action’s When to use so the AI agent opens a Gorgias ticket for them. See When should the AI agent escalate?
- The customer asks for a person. For example, a customer unhappy with a delivery asks to speak to someone. The AI agent collects their email and name and creates the ticket.
- Questions the AI agent can’t answer from its content, after confirming with the customer, as the default When to use does.
What the customer sees
The AI agent tells the customer the ticket was created and shares the ticket number. On the Chat Bubble and other widget channels, a Ticket Created card also shows the ticket number and the name and email it was submitted with. If the ticket can’t be created, the card reads Failed to create ticket. On WhatsApp, Instagram, and email, the customer gets the AI agent’s message only. The AI agent keeps replying in the chat after the ticket is created. Because the ticket is an email ticket, your team’s replies from Gorgias usually reach the customer by email, not in the original chat. Nothing syncs back from Gorgias. Chatbase stores the ticket number on the conversation, but not the ticket’s status or your team’s replies.Troubleshooting
Connecting shows "Invalid email or API key."
Connecting shows "Invalid email or API key."
Connecting shows "Invalid subdomain." or "Failed to connect to Gorgias. Please check your subdomain."
Connecting shows "Invalid subdomain." or "Failed to connect to Gorgias. Please check your subdomain."
.gorgias.com, for example yourstore.The customer saw "Failed to create ticket"
The customer saw "Failed to create ticket"
- The API key was revoked or regenerated. The Gorgias card still shows Connected, so disconnect and connect again with a current key.
- The customer didn’t give an email address. Gorgias may reject a ticket without one.
A second escalation didn't open a new ticket
A second escalation didn't open a new ticket
Tickets aren't appearing in Gorgias
Tickets aren't appearing in Gorgias
Frequently asked questions
Why does the Gorgias ticket look like the customer emailed us?
Why does the Gorgias ticket look like the customer emailed us?
Does Chatbase send the Shopify order number to Gorgias?
Does Chatbase send the Shopify order number to Gorgias?
Can the AI agent tag the ticket or set ticket fields?
Can the AI agent tag the ticket or set ticket fields?
Can my team reply to the customer in the chat from Gorgias?
Can my team reply to the customer in the chat from Gorgias?
Does creating a ticket use extra message credits?
Does creating a ticket use extra message credits?
What happens to my Escalations Actions if I disconnect Gorgias?
What happens to my Escalations Actions if I disconnect Gorgias?