> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hand off conversations to live chat in Freshchat

> Hand over from your AI agent to live chat with a human agent in Freshchat

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.

> [card] Best for:
>
> Urgent or sensitive issues that need a person right away, such as billing disputes, account problems, or frustrated customers.

> [!NOTE]
>
> **Prerequisite:** Before using this Action, [connect Freshchat](https://chatbase.co/docs/user-guides/integrations/freshchat.md) 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](https://www.chatbase.co/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](#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](#satisfaction-survey).

![The Satisfaction survey setting in the Freshchat live chat Action](https://mintcdn.com/chatbase/RhXDeJ_ZWNmVyM8u/user-guides/chatbot/images/actions/freshchat-csat-setting.png?fit=max\&auto=format\&n=RhXDeJ_ZWNmVyM8u\&q=85\&s=44937f92e26554ba25505b9e012546b5)

To restrict the Action to [Procedure](https://chatbase.co/docs/user-guides/chatbot/procedures/procedures-overview.md) steps only, turn on [**Only use in Procedures**](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#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](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#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**:

| Conversation context | What the Freshchat agent sees |
| - | - |
| **Full conversation** | The whole chat so far, posted as "Visitor:" and "Bot:" lines, with the files the customer sent. |
| **AI summary** | An AI-written summary added to the first message. Only the attachments from the chat are posted. |

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](https://chatbase.co/docs/user-guides/chatbot/activity.md). See [How the handoff works](https://chatbase.co/docs/user-guides/integrations/freshchat.md#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](https://mintcdn.com/chatbase/RhXDeJ_ZWNmVyM8u/user-guides/chatbot/images/actions/freshchat-csat-survey.png?fit=max\&auto=format\&n=RhXDeJ_ZWNmVyM8u\&q=85\&s=7b94b9ec1ac0d7c20629d5a690b4b767)

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](https://mintcdn.com/chatbase/RhXDeJ_ZWNmVyM8u/user-guides/chatbot/images/actions/freshchat-csat-report.png?fit=max\&auto=format\&n=RhXDeJ_ZWNmVyM8u\&q=85\&s=df829f8f8eb6b9e33d0d6260c91b5869)

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.

> [!NOTE]
>
> 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](https://chatbase.co/docs/user-guides/integrations/freshchat.md#how-to-connect-freshchat).

## Frequently asked questions

> [accordion] Does the customer need to give an email before the handoff?
>
> 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.

> [accordion] Does the Freshchat agent see the whole conversation?
>
> 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.

> [accordion] Are Freshchat replies saved 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.

> [accordion] Can I use Freshchat live chat on WhatsApp or email?
>
> No. The Action runs on the Chat Bubble, Help Page, and Center Stage only. For other channels, use [Chatbase Live Chat](https://chatbase.co/docs/user-guides/chatbot/actions/chatbase-live-chat.md) or [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md).

> [accordion] Which plan do I need?
>
> The Basic plan or higher. Freshchat live chat isn't available on HIPAA-compliant accounts.

## Next steps

> [card] [Freshchat integration](https://chatbase.co/docs/user-guides/integrations/freshchat.md)
>
> Connect or manage your Freshchat account.

> [card] [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md)
>
> Open a ticket instead when the issue doesn't need a live agent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.