What you can do:
Before you start
- A Chatbase account on the Basic plan or higher, with an AI agent
- Your Freshdesk subdomain and API key (see Find your Freshdesk API key)
How to connect Freshdesk
Open your Chatbase AI agent
Connect Freshdesk
Enter your subdomain and API key
yourcompany. The field already sits between https:// and .freshdesk.com, so don’t type the full address.Create the Escalations Action
Find your Freshdesk API key
- Log in to your Freshdesk account.
- Click your profile picture (top-right corner).
- Select Profile Settings.
- On the right-hand side, locate Your API Key.

Setup checklist
Use this list to go from a Freshdesk account to working escalations:- Make sure your Chatbase plan is Basic or higher.
- Connect Freshdesk on the AI agent’s Integrations page, entering only the subdomain (for example
yourcompany), and check that the card shows Connected. - Create a Create ticket Action under Escalations with Freshdesk as the Ticket Platform, and write a clear When to use.
- If your Freshdesk marks Type as required, set the Action’s Freshdesk ticket type field.
- Turn the Action on for the channels where customers should be able to escalate.
- Publish your changes, then ask the AI agent to speak to a human and confirm the ticket appears in Freshdesk.
What the AI agent sends to Freshdesk
When the AI agent creates a ticket, 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. The AI agent then creates the ticket with these fields:Example ticket
For example, a customer on the Chat Bubble writes that they were charged twice for one order and wants a refund. The AI agent asks for their name and email, then creates a ticket like this:- Subject: Double charge on order, refund requested
- Description: I was charged twice for the same order and would like the duplicate charge refunded.
- Requester: Jane Doe, jane@example.com
- Priority: High
- Status: Open
- Private note: conversation link in Chatbase, followed by the link to the conversation
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. Your team’s replies from Freshdesk reach the customer the way Freshdesk sends them, which is usually by email, and don’t appear in the original chat. Nothing syncs back from Freshdesk. Chatbase stores the ticket number on the conversation, but not the ticket’s status or your team’s replies.Troubleshooting
Connecting shows "Invalid API key or subdomain."
Connecting shows "Invalid API key or subdomain."
Connecting shows "Invalid subdomain" or "Failed to connect to Freshdesk. Please check your subdomain."
Connecting shows "Invalid subdomain" or "Failed to connect to Freshdesk. Please check your subdomain."
.freshdesk.com, for example yourcompany. If you reach Freshdesk through a custom domain, use your original freshdesk.com subdomain instead.The subdomain field says it can only contain alphanumeric characters and hyphens
The subdomain field says it can only contain alphanumeric characters and hyphens
yourcompany.freshdesk.com. Remove the dots and everything after them.The customer saw "Failed to create ticket"
The customer saw "Failed to create ticket"
- The API key was revoked or regenerated. The Freshdesk card still shows Connected, so disconnect and connect again with the current key.
- Your Freshdesk marks Type as required and the Action’s Freshdesk ticket type field is empty. The field warns you about this when you set up the Action.
- The customer didn’t give an email address. Freshdesk may reject a ticket without one.
Tickets aren't appearing in Freshdesk
Tickets aren't appearing in Freshdesk
Frequently asked questions
Does Freshdesk receive the full conversation?
Does Freshdesk receive the full conversation?
Can my team reply to the customer in the chat from Freshdesk?
Can my team reply to the customer in the chat from Freshdesk?
Can I set the ticket type or priority?
Can I set the ticket type or priority?
Can I connect more than one Freshdesk account?
Can I connect more than one Freshdesk account?
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 Freshdesk?
What happens to my Escalations Actions if I disconnect Freshdesk?