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

# Configure Human Handoff

If you want to allow a live agent to join your agent's conversations, you can configure this in the ** Human Handoff** section of your bot's menu.

> [!WARNING]
>
> For new workspaces, Human Handoff has moved to [Botpress Desk](https://botpress.com/desk), our new AI helpdesk for modern support teams. Go to **Human Handoff > Open Botpress Desk** to get started setting up your workspace.
>
> Users on existing workspaces can follow the steps below and continue using the legacy HITL integration.

## Setup

To get started using Human Handoff, you need to install and configure the official Human-in-the-Loop (HITL) integration:

> [card] [Configure HITL](https://botpress.com/docs/integrations/integration-guides/hitl/introduction.md)
>
> Install and configure the official integration Plus (This feature requires a Botpress Plus plan or higher.)

When you've finished setting up the integration, you'll have access to the Human Handoff **Dashboard**.

***

## Dashboard

When you've finished setting up the integration, you'll have access to the Human Handoff **Dashboard**. Here's how it works:

### View your tickets

When a user triggers Human Handoff, a ticket is opened. You can view your tickets in the left sidebar:

![Pending conversation](https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/pending-conversation.png?fit=max\&auto=format\&n=WjGSJXsFWYihoyaq\&q=85\&s=fb17c0565223ec3cb2daad035275f207)

Select any ticket to view the conversation with the user.

> [!TIP]
>
> You can use the drop-down menus to filter your tickets by their status.

### Assign a ticket

You can assign a ticket to anyone in your Workspace, including yourself. For example, select ** Assign to me**:

![Assign conversation](https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/assign-conversation.png?fit=max\&auto=format\&n=WjGSJXsFWYihoyaq\&q=85\&s=aa04b4066ddc12641329cbb8221db08b)

Now you can chat directly with the user:

![Respond to user](https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/respond-to-user.png?fit=max\&auto=format\&n=WjGSJXsFWYihoyaq\&q=85\&s=a1f78f2c63ac37b40d1a705a30ad168b)

### Close a ticket

When you've resolved the conversation with the user, select **Resume Chatbot **. This removes you from the conversation and lets the user keep chatting with your agent.

## Testing

You can test Human Handoff by using your agent's preview to simulate an escalation.

**Step 1**

Open your agent's [preview](https://botpress.com/docs/get-started/manage-your-agent/preview.md).

**Step 2**

Chat with your agent until it triggers Human Handoff:

![Trigger Human Handoff](https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/trigger-human-handoff.png?fit=max\&auto=format\&n=WjGSJXsFWYihoyaq\&q=85\&s=1595308e04441e2649cf9e44e306f302)

**Step 3**

Navigate to the Dashboard, then go to the bot's \*\* Human Handoff\*\* menu. From there, you can assign and interact with the ticket.


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