> ## 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 **<Icon icon="message-square-reply" /> 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.
</Warning>

## Setup

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

<Card title="Configure HITL" href="/integrations/integration-guides/hitl/introduction" icon="plug" horizontal>
  Install and configure the official integration <Tooltip tip="This feature requires a Botpress Plus plan or higher."><Badge stroke color="blue">Plus</Badge></Tooltip>
</Card>

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:

<Frame>
  <img alt="Pending conversation" className="block dark:hidden" src="https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/pending-conversation.png?fit=max&auto=format&n=WjGSJXsFWYihoyaq&q=85&s=fb17c0565223ec3cb2daad035275f207" width="1400" height="374" data-path="get-started/manage-your-agent/assets/pending-conversation.png" />

  <img alt="Pending conversation" className="hidden dark:block" src="https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/pending-conversation-dark.png?fit=max&auto=format&n=WjGSJXsFWYihoyaq&q=85&s=d15a0a1f3fa262d40075b2f23aafff74" width="1400" height="374" data-path="get-started/manage-your-agent/assets/pending-conversation-dark.png" />
</Frame>

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.
</Tip>

### Assign a ticket

You can assign a ticket to anyone in your Workspace, including yourself. For example, select **<Icon icon="user-round" /> Assign to me**:

<Frame>
  <img alt="Assign conversation" className="block dark:hidden" src="https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/assign-conversation.png?fit=max&auto=format&n=WjGSJXsFWYihoyaq&q=85&s=aa04b4066ddc12641329cbb8221db08b" width="2416" height="814" data-path="get-started/manage-your-agent/assets/assign-conversation.png" />

  <img alt="Assign conversation" className="hidden dark:block" src="https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/assign-conversation-dark.png?fit=max&auto=format&n=WjGSJXsFWYihoyaq&q=85&s=346e100f123503fbd20ffe3611d1e73f" width="2416" height="814" data-path="get-started/manage-your-agent/assets/assign-conversation-dark.png" />
</Frame>

Now you can chat directly with the user:

<Frame>
  <img alt="Respond to user" className="block dark:hidden" src="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" width="2444" height="814" data-path="get-started/manage-your-agent/assets/respond-to-user.png" />

  <img alt="Respond to user" className="hidden dark:block" src="https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/respond-to-user-dark.png?fit=max&auto=format&n=WjGSJXsFWYihoyaq&q=85&s=94b3ade6547fa17497879a560a4eeeee" width="2444" height="814" data-path="get-started/manage-your-agent/assets/respond-to-user-dark.png" />
</Frame>

### Close a ticket

When you've resolved the conversation with the user, select **Resume Chatbot <Icon icon="undo-2" />**. 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.

<Steps>
  <Step>Open your agent's [preview](/get-started/manage-your-agent/preview).</Step>

  <Step>
    Chat with your agent until it triggers Human Handoff:

    <Frame>
      <img alt="Trigger Human Handoff" className="block dark:hidden" src="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" width="1366" height="702" data-path="get-started/manage-your-agent/assets/trigger-human-handoff.png" />

      <img alt="Trigger Human Handoff" className="hidden dark:block" src="https://mintcdn.com/botpress/WjGSJXsFWYihoyaq/get-started/manage-your-agent/assets/trigger-human-handoff-dark.png?fit=max&auto=format&n=WjGSJXsFWYihoyaq&q=85&s=b82d7eb3a9f46c008bb59174be0bcfae" width="1366" height="702" data-path="get-started/manage-your-agent/assets/trigger-human-handoff-dark.png" />
    </Frame>
  </Step>

  <Step>
    Navigate to the Dashboard, then go to the bot's **<Icon icon="message-square-reply" /> Human Handoff** menu. From there, you can assign and interact with the ticket.
  </Step>
</Steps>