> ## 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 Chatbase Helpdesk

> Hand a conversation from your AI agent to a human agent in the Chatbase Helpdesk, in real time

The Chatbase Live Chat Action lets your AI agent hand a conversation over to a human support agent in the Chatbase Helpdesk. When it runs, Chatbase opens a **Live chat** ticket, the AI agent stops replying, and your team continues the conversation from the Helpdesk while the customer stays in the same chat. It works on the Chat Bubble, Help Page, Center Stage, Email, WhatsApp, Messenger, and Instagram.

> [card] Best for:
>
> Sensitive, urgent, or account-specific issues where the customer needs a person now, rather than a ticket and a follow-up later.

**Common Use Cases:**

* "I want to speak to someone right now"
* "This is urgent"
* "The AI isn't helping me"

> [!NOTE]
>
> **Prerequisite:** The Chatbase Helpdesk must be enabled. Click **Helpdesk inbox** in the sidebar and enable it from there. See the [Helpdesk overview](https://chatbase.co/docs/user-guides/chatbot/help-desk/help-desk-overview.md) for how conversations are handled once they arrive.

> [!NOTE]
>
> The Action itself doesn't collect any details: it hands the conversation to your team as soon as it runs. To ask the customer questions first, such as an order number or what they need help with, add the Action to a [Procedure](https://chatbase.co/docs/user-guides/chatbot/procedures/procedures-overview.md) step after those questions. The answers stay in the conversation, so your team sees them when they join. To save the details as ticket fields (subject, description, or custom fields), use [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) instead. See [Live chat vs. Escalations](#live-chat-vs-escalations).

## Before you start

* **Helpdesk enabled.** Until it is, the **Chatbase live chat** card in **Create Action** shows **Enable Helpdesk** and an **Enable Chatbase Helpdesk** button instead of the Action.
* **Basic plan or higher.** The Action needs a plan that includes the Helpdesk. It's blocked again if you downgrade to a plan without it.
* **Not on HIPAA accounts.** The Action can't be used on HIPAA-compliant accounts.
* **A free Action slot.** Live chat counts toward your plan's Actions limit per AI agent.

## 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. Open the Chatbase live chat card**

Click **Create Action**. Under the **Escalations** filter, open the **Chatbase live chat** card ("Hand over from the AI agent to live chat with a human support agent"), then select **Live chat**.

**3. Configure General settings**

**When to use:** Tells the AI agent when to hand the conversation over. It's prefilled with a default you can edit. The default includes the instruction "Reply that an agent will be connected to the chat shortly only if the action is successful.", which is what produces the customer's confirmation message.

There's no Action name field: the Action's name is set for you.

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).

**4. Choose Channels**

Under **Channels**, turn the Action on or off for each channel. See [Channels](#channels).

**5. Enable and test**

Make sure the Action is enabled, then ask your AI agent to speak to a human. Confirm the conversation appears in your Helpdesk inbox as a **Live chat** ticket.

## How it works

When the AI agent calls the Action, Chatbase:

1. Creates a ticket of type **Live chat**. The AI agent writes a summary of the conversation, and its first 80 characters become the ticket subject.
2. Takes over the conversation, so the AI agent stops replying.
3. Runs your Helpdesk [Triggers](https://chatbase.co/docs/user-guides/chatbot/help-desk/triggers.md) on the new ticket, which decide its team and assignee.

The Action doesn't check whether any agent is available, and it always runs. To hand over only when someone can answer, call it from a [Procedure](https://chatbase.co/docs/user-guides/chatbot/procedures/procedures-overview.md) that checks the `{{agentAvailable}}` variable first. The variable is `true` when at least one Helpdesk agent's status is **Available**. The **Live agent availability** template in the Procedures **Templates** tab does this: if `{{agentAvailable}}`, it uses live chat, otherwise it uses `create_ticket` so your team can follow up.

To hand over only during your support hours, use a time condition instead. The **Live agent availability by hours** template branches on "The current time in UTC+3 is between 9:00 AM and 5:00 PM": inside those hours it uses live chat, otherwise it uses `create_ticket`. Edit the hours and timezone to match your team. Always name the timezone, because the AI agent compares the condition against the current time in UTC. There's no timeout and no fallback to the AI agent: the conversation stays with your team until the ticket is closed. The only failure is the ticket itself failing to be created, which shouldn't happen in normal use. If it does, the AI agent lets the customer know.

### Example

For example, a customer on the Chat Bubble writes "My account is locked and I need a person now."

1. The AI agent calls the Action and replies "I'm connecting you with a member of our team. An agent will join the chat shortly."
2. The customer sees **Waiting for support agent to join**.
3. A **Live chat** ticket appears in the Helpdesk, and your Triggers route it to a team.
4. An agent replies from the Helpdesk, and the reply appears in the customer's chat.
5. The agent closes the ticket, and the AI agent answers the customer's next message.

## What the customer sees

The confirmation message isn't a fixed text. The AI agent writes it after the Action succeeds, guided by your **When to use** instructions. Edit **When to use** to change what it says.

![The message a customer sees after being handed to live chat](https://mintcdn.com/chatbase/_IymDiKC0ShvvrQq/user-guides/chatbot/images/actions/actions-48.png?fit=max\&auto=format\&n=_IymDiKC0ShvvrQq\&q=85\&s=eb2e5a5dd87251b2b564376ba5baeb48)

**Chat Bubble, Help Page, and Center Stage.** After the AI agent's message, a spinner shows **Waiting for support agent to join** until the first agent reply arrives. It's the same spinner as a manual [takeover](https://chatbase.co/docs/user-guides/chatbot/help-desk/takeover.md#what-the-customer-sees). It appears in the widget's language and can't be edited per Action. No ticket card is shown.

**WhatsApp, Messenger, and Instagram.** The AI agent's handoff message is still sent. After that the AI agent stays silent, the customer's messages go to the ticket, and agent replies arrive in the same thread. There's no spinner or other status indicator on these channels.

**Email.** The handoff follows the same pattern: agent replies from the Helpdesk reach the customer by email.

If the customer closes the widget while waiting, they don't miss the reply. Agent replies are saved to the conversation, so they appear when the customer reopens the widget. Each agent reply is also emailed to the customer when Chatbase has their email address.

## What your team sees

The conversation appears in the Helpdesk inbox in real time, labeled as a **Live chat** ticket, with the AI summary.

![A live chat session labeled in the Chatbase Helpdesk inbox](https://mintcdn.com/chatbase/_IymDiKC0ShvvrQq/user-guides/chatbot/images/actions/actions-49.png?fit=max\&auto=format\&n=_IymDiKC0ShvvrQq\&q=85\&s=82191dc4e25775140adbd5e5e5a83bda)

Agents can then:

* Reply directly to the customer in real time
* Add internal notes
* Continue the conversation from the existing thread

### Assignment

The ticket is created without a team or assignee, so assignment is handled by your Triggers. The default **Route to default team** Trigger sends the ticket to your [default team](https://chatbase.co/docs/user-guides/chatbot/help-desk/teams.md#the-default-team) and applies that team's [assignment method](https://chatbase.co/docs/user-guides/chatbot/help-desk/assignment-algorithm.md) (**Manual**, **Round robin**, or **Balanced**), its max tickets per agent, and **Assign to next available shift**.

> [!WARNING]
>
> The default **General** team uses **Manual** assignment, so out of the box no agent is picked automatically. Switch the team to **Round robin** or **Balanced** if you want live chats assigned as they arrive.

If no agent can be assigned, for example because nobody is **Available**, the ticket goes to the team as unassigned. See [Unassigned tickets](https://chatbase.co/docs/user-guides/chatbot/help-desk/assignment-algorithm.md#unassigned-tickets).

### Notifications

The Action doesn't send its own push or email alert.

* **Sound and tab counter:** the sound and the "(n)" counter in the browser tab fire only for the agent the ticket is assigned to, and only if that agent has sounds on.
* **Unassigned tickets alert no one.** A ticket waiting in the team pool is visible in the inbox but triggers no sound.
* **No desktop notifications.** There are no browser desktop notifications.
* **Email or Slack alerts:** add a [Trigger](https://chatbase.co/docs/user-guides/chatbot/help-desk/triggers.md) with a **Send email** or **Send Slack message** action that matches live chat tickets.

## Handing the conversation back to the AI agent

Close the ticket. When the last open ticket on the conversation moves to a closed or cancelled status, the AI agent takes the conversation back and answers the customer's next message. There's no separate "hand back" button in **Activity > Conversations**, which only offers **Takeover** and **View Ticket**. See [Handing the conversation back to the AI](https://chatbase.co/docs/user-guides/chatbot/help-desk/takeover.md#handing-the-conversation-back-to-the-ai).

## Live chat vs. Escalations

Both Actions hand the conversation to your team when [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) uses Chatbase Helpdesk as the platform: the AI agent stops replying and the customer sees the same waiting spinner. The differences:

| | Chatbase Live Chat | Escalations (Chatbase Helpdesk) |
| - | - | - |
| Customer's email | Not required | Required, the AI agent asks for it (except on Phone) |
| Details collected | None by the Action. A Procedure can ask questions before the handoff, and the answers stay in the conversation and the AI summary | Subject, description, custom fields, and tags, saved as ticket fields |
| Ticket type | **Live chat** | **Standard ticket** |
| Card in the widget | None | A submitted-ticket card |
| Channels | Chat Bubble, Help Page, Center Stage, Email, WhatsApp, Messenger, Instagram | Also API, the mobile SDKs, and Phone |

## Channels

The Chatbase live chat Action is compatible with the **Chat Bubble**, **Help Page**, **Center Stage**, **Email**, **Instagram**, **Messenger**, and **WhatsApp** channels. Every other channel is incompatible and can't be selected. Use **Channels** in the Action's configuration to enable or disable it per channel. See [Channels](https://chatbase.co/docs/user-guides/chatbot/actions/actions-overview.md#channels) for what configured, unconfigured, and incompatible mean.

## Best Practices

> [card] Staff It Before You Enable It
>
> The Action runs even when no one is available. Only enable it when agents can respond, and set an auto-assigning team so live chats reach someone.

> [card] Keep Triggers Strict
>
> Write tight **When to use** instructions so the AI agent doesn't escalate conversations it could have resolved.

> [card] Let the AI Try First
>
> Handle common questions with the AI agent and reserve live chat for what it can't resolve.

> [card] Reserve It for Urgency
>
> Use live chat for sensitive, urgent, or account-specific issues, and [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) for everything that can wait.

## Frequently asked questions

> [accordion] What happens if no agent is available?
>
> On its own, the Action still runs: the ticket is created, the conversation is taken over, and if no agent can be assigned, the ticket waits unassigned in the team's pool. There's no timeout and no fallback to the AI agent, so the customer keeps waiting until an agent replies or the ticket is closed.
>
> To avoid this, call the Action from a [Procedure](https://chatbase.co/docs/user-guides/chatbot/procedures/procedures-overview.md) that checks first. Branch on `{{agentAvailable}}` to use live chat only when at least one Helpdesk agent is **Available**, or on a time condition to use it only during your support hours, and open a ticket with Escalations otherwise. The **Live agent availability** and **Live agent availability by hours** templates in the Procedures **Templates** tab are set up this way. See [How it works](#how-it-works).

> [accordion] Can I change the message the customer sees after the handoff?
>
> Yes, through **When to use**. The AI agent writes the confirmation itself, following those instructions. The **Waiting for support agent to join** spinner on the widget is fixed and shown in the widget's language.

> [accordion] Why wasn't a live chat assigned to anyone?
>
> The default **General** team uses **Manual** assignment, so tickets wait in the pool. Change the team's assignment method to **Round robin** or **Balanced**, or route live chats to a team that auto-assigns with a [Trigger](https://chatbase.co/docs/user-guides/chatbot/help-desk/triggers.md). Tickets also stay unassigned when every agent is away or at their ticket limit.

> [accordion] Which agents get notified?
>
> Only the agent the ticket is assigned to hears a sound and sees the tab counter. Unassigned tickets alert no one. For email or Slack alerts, set up a Trigger with **Send email** or **Send Slack message**.

> [accordion] How does the conversation go back to the AI agent?
>
> Close or cancel the ticket. Once the conversation has no open tickets left, the AI agent answers the customer's next message.

> [accordion] Which plan do I need?
>
> Basic plan or higher, with the Chatbase Helpdesk enabled. The Action isn't available on HIPAA-compliant accounts, and it counts toward your plan's Actions limit.


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