Skip to main content
The Freshchat live chat Action hands a conversation over from your AI agent to a human agent in Freshchat. It’s for teams that already answer customers in Freshchat: the customer keeps chatting in the same window on the Chat Bubble, Help Page, or Center Stage, and your team replies from Freshchat in real time.

Best for:

Urgent or sensitive issues that need a person right away, such as billing disputes, account problems, or frustrated customers.
Prerequisite: Before using this Action, connect Freshchat under Integrations. The Freshchat integration is available on the Basic plan or higher, and not on HIPAA-compliant accounts.

How to create the Action

1

Navigate to Actions

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

Create the Action

Click Create Action, then select Freshchat live chat. It’s listed under the Live chat type.
3

Configure general settings

Action name: A unique, descriptive name for the Action.When to use: Instructions for when the AI agent should hand the conversation over. For example: “Use when the customer asks to speak to a human, or when you can’t resolve a billing or account issue.”Freshchat channel: The Freshchat channel the new conversation opens in.Conversation context: What the Freshchat agent receives with the handoff. See What the Freshchat agent receives.End of chat: Check End the conversation when the agent resolves it to end the conversation when the Freshchat agent resolves it, so the customer starts a new one. When it’s unchecked, the customer keeps chatting with the AI agent in the same conversation.Satisfaction survey: Check Ask the user to rate the chat after the agent resolves it to send a survey when the chat ends. It’s off by default. See Satisfaction survey.
The Satisfaction survey setting in the Freshchat live chat Action
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 AI agent no longer decides when to call the Action.
4

Choose channels

Use Channels to control where the Action is available. Freshchat live chat works on Chat Bubble, Help Page, and Center Stage only. Any other channel is incompatible and can’t be selected. See Channels for details.
5

Enable and test

Make sure the Action is toggled to Enabled. Then ask your AI agent to speak to a human, and confirm the conversation reaches a live agent in Freshchat.

What the Freshchat agent receives

The AI agent needs the customer’s email before it can hand off, so it asks for one unless it already knows it. Each handoff then creates a new Freshchat user with the customer’s name, email, and phone number when Chatbase has them. The Freshchat conversation opens in the channel you selected, with a first message containing the Chatbase conversation ID, an AI-written title, and a link to the conversation in Chatbase Activity > Conversations. What follows depends on Conversation context: During the handoff, the customer’s messages and the Freshchat agent’s replies are also saved in Chatbase, so you can read the whole conversation in Activity. See How the handoff works for what the customer sees.

Satisfaction survey

When the survey is on and a Freshchat agent resolves the chat, the customer sees a short survey in the chat window:
  1. Was your issue resolved? Yes or No.
  2. If they answer Yes, they rate the experience from 1 to 5 stars.
  3. They can add an optional comment, then click Submit.
The satisfaction survey in the chat window
The survey appears in the widget’s language. Chatbase sends the answer to Freshchat, where it shows up in your CSAT reports and on the conversation.
The survey answer on a resolved conversation in Freshchat
In Activity > Conversations, the conversation shows Satisfaction survey sent · No answer yet until the customer answers, then Satisfaction survey answered. The rating and comment are stored in Freshchat, not in Chatbase.
Answers are recorded in Freshchat’s CSAT reports if your Freshchat API token allows it. If Freshchat refuses the answer, Chatbase still marks the survey as answered in Activity > Conversations. If answers don’t appear in Freshchat, generate a new token in Freshchat, then reconnect the integration.

Frequently asked questions

Yes. The Action needs the customer’s email to create the Freshchat user, so the AI agent asks for it unless it already knows it.
With Conversation context set to Full conversation, yes: the chat so far is posted as “Visitor:” and “Bot:” lines, with files. With AI summary, the agent gets a summary and the attachments only. Every handoff also includes a link to the conversation in Chatbase.
Yes. The customer’s messages and the Freshchat agent’s replies during the handoff are saved in Chatbase, so the full conversation appears in Activity.
No. The Action runs on the Chat Bubble, Help Page, and Center Stage only. For other channels, use Chatbase Live Chat or Escalations.
The Basic plan or higher. Freshchat live chat isn’t available on HIPAA-compliant accounts.

Next steps

Freshchat integration

Connect or manage your Freshchat account.

Escalations

Open a ticket instead when the issue doesn’t need a live agent.