> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-pb-update-api.mintlify.site/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-pb-update-api/g2peRIBG6c_QSKRe/get-started/manage-your-agent/assets/pending-conversation.png?fit=max&auto=format&n=g2peRIBG6c_QSKRe&q=85&s=e0d2c9c015f7b258b245728c2429bb15" 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-pb-update-api/g2peRIBG6c_QSKRe/get-started/manage-your-agent/assets/pending-conversation-dark.png?fit=max&auto=format&n=g2peRIBG6c_QSKRe&q=85&s=fb22a67eaee22448a41f85fdcd0651f0" 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-pb-update-api/g2peRIBG6c_QSKRe/get-started/manage-your-agent/assets/assign-conversation.png?fit=max&auto=format&n=g2peRIBG6c_QSKRe&q=85&s=a02a0cdc512c8166a504b3323401157f" 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-pb-update-api/g2peRIBG6c_QSKRe/get-started/manage-your-agent/assets/assign-conversation-dark.png?fit=max&auto=format&n=g2peRIBG6c_QSKRe&q=85&s=b9e3ebdab94ca4c96dd470c9dc5d12d0" 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-pb-update-api/g2peRIBG6c_QSKRe/get-started/manage-your-agent/assets/respond-to-user.png?fit=max&auto=format&n=g2peRIBG6c_QSKRe&q=85&s=d5de67523df4e16785c8d356cfbcdf9b" 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-pb-update-api/g2peRIBG6c_QSKRe/get-started/manage-your-agent/assets/respond-to-user-dark.png?fit=max&auto=format&n=g2peRIBG6c_QSKRe&q=85&s=1c8817dc120bca210021f674d2e18893" 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-pb-update-api/g2peRIBG6c_QSKRe/get-started/manage-your-agent/assets/trigger-human-handoff.png?fit=max&auto=format&n=g2peRIBG6c_QSKRe&q=85&s=f151d316f1f7b9d6adfb1446b8fad53d" 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-pb-update-api/g2peRIBG6c_QSKRe/get-started/manage-your-agent/assets/trigger-human-handoff-dark.png?fit=max&auto=format&n=g2peRIBG6c_QSKRe&q=85&s=43e52eb4e35ffa19a7f7725d94c758c5" 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>