What you can do:
Before you start
- A Chatbase account on the Basic plan or higher, with an AI agent
- Your Freshchat Chat URL and API key, from the API Tokens screen in Freshchat (see step 1 below)
How to connect Freshchat
Get your chat URL and API key from Freshchat
Connect Freshchat in Chatbase
- Navigate to your Chatbase dashboard.
- Click the AI agent you want to enable live chat for.
- Navigate to Integrations.
- On the Freshchat card, click Connect.
- Enter your Chat URL, for example
https://yourcompany.freshchat.com, and your API Key. - Click Submit.
Create the Freshchat live chat Action
Chat URL format
The Chat URL field accepts your Freshchat address in a few forms:https://is optional. Chatbase adds it if you leave it out.- A trailing slash or path is ignored. Only the hostname is kept.
http://addresses are rejected.- The address must end in
.freshchat.comor.myfreshworks.com, for exampleyourcompany.freshchat.comoryourcompany.myfreshworks.com.
How the handoff works
When the AI agent decides the customer needs a person, it calls the Freshchat live chat Action. It needs the customer’s email first, so it asks for one unless it already knows it, for example because the customer is signed in.What the customer sees
- Before the handoff, the customer sees the AI agent’s own message about connecting them to a person.
- While waiting, a spinner shows Waiting for support agent to join.
- When the first agent replies, a divider reads <agent name> connected, with the agent’s Freshchat avatar. If the name isn’t known, it reads Live agent connected. Each group of agent replies shows the agent’s name and the time.
- When the agent resolves the chat, an AI Resumed divider appears and the AI agent answers the customer’s next message.
Example flow
For example, a customer on the Chat Bubble writes “My account is locked and I need to talk to someone.”- The AI agent asks for their email, and the customer replies jane@example.com.
- The AI agent hands off, and the customer sees Waiting for support agent to join.
- In Freshchat, a new conversation opens in the channel set on the Action, with the conversation details and the chat so far.
- An agent named Sam replies. The customer sees Sam connected and Sam’s reply in the same chat window.
- Sam unlocks the account and resolves the conversation in Freshchat. The customer sees AI Resumed, and the AI agent answers their next question.
What the Freshchat agent receives
Each handoff creates a new Freshchat user with the customer’s name, email, and, when the contact has one, phone number. The conversation opens with status New in the channel chosen in the Action’s Freshchat channel dropdown. Chatbase doesn’t set a group or assignee, so Freshchat’s own assignment rules usually decide who picks it up. The conversation starts with a message containing the Chatbase conversation ID, an AI-written title, and a link to the conversation in your Chatbase dashboard. What follows depends on the Action’s Conversation context setting:How the conversation returns to the AI agent
The AI agent takes over again when the agent resolves the conversation in Freshchat. What happens next depends on the Action:- By default, the customer sees AI Resumed and keeps chatting with the AI agent in the same conversation.
- With End the conversation when the agent resolves it checked, the conversation ends instead, and the customer starts a new one. If Ask the user to rate the chat after the agent resolves it is also on, the customer sees the satisfaction survey first.
Limitations
- The live chat Action runs on three channels only: Chat Bubble, Center Stage, and Help Page. It isn’t available on WhatsApp, Instagram, Messenger, email, or phone. See Channels for what configured, unconfigured, and incompatible mean.
- Not available on HIPAA-compliant accounts. The Connect button is disabled there.
- No availability check. The handoff happens even when no agent is online, and the customer waits until someone replies.
- One Freshchat account per AI agent.
Troubleshooting
Connecting shows "Invalid chat URL."
Connecting shows "Invalid chat URL."
.freshchat.com or .myfreshworks.com.The Chat URL field says "Enter your Freshchat URL"
The Chat URL field says "Enter your Freshchat URL"
https:// address, or no scheme at all, ending in .freshchat.com or .myfreshworks.com. See Chat URL format.Connecting shows "Freshchat rejected the API key. Check the key and try again."
Connecting shows "Freshchat rejected the API key. Check the key and try again."
Connecting shows that Freshchat refused the API key with 403 Forbidden
Connecting shows that Freshchat refused the API key with 403 Forbidden
Connecting shows "Failed to connect to Freshchat" or a rate limiting message
Connecting shows "Failed to connect to Freshchat" or a rate limiting message
The Freshchat card says it no longer accepts the saved API key
The Freshchat card says it no longer accepts the saved API key
The customer waits but no agent joins
The customer waits but no agent joins
The AI agent never hands off
The AI agent never hands off
Frequently asked questions
Does the Freshchat agent see what the customer already told the AI agent?
Does the Freshchat agent see what the customer already told the AI agent?
What happens if no one is available in Freshchat?
What happens if no one is available in Freshchat?
How does the customer get back to the AI agent?
How does the customer get back to the AI agent?
Can Freshchat take over conversations on WhatsApp or Instagram?
Can Freshchat take over conversations on WhatsApp or Instagram?
Do I need admin access in Freshchat?
Do I need admin access in Freshchat?
Which Freshchat channel do handed-off conversations land in?
Which Freshchat channel do handed-off conversations land in?