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

# Human-in-the-Loop (HITL)

> Allow a live agent to participate directly in the bot's conversation.

{/* vale on */}

[Open in Hub](https://studio.botpress.cloud/home?exploreHub=1\&hubItemId=intver_01K0SV5HZAT9FSVVEB7S91SH4F)
*v2.0.2*

> [!WARNING]
>
> For new workspaces, HITL has moved to [Botpress Desk](https://botpress.com/desk), our new AI helpdesk for modern support teams. From your dashboard, 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.

The Human-in-the-Loop (HITL) integration allows members of your Workspace to:

* Chat directly with users
* Approve AI-generated outputs before they're sent
* Handle complex or sensitive scenarios

> [!NOTE]
>
> The HITL integration needs to be configured before you can use [Human Handoff](https://botpress.com/docs/get-started/manage-your-agent/human-handoff.md).

## Setup

> [!NOTE]
>
> You will need:
>
> * A [Botpress Plus plan](https://botpress.com/pricing) or higher

### Step 1: Install the HITL integration

First, install the official HITL integration:

**Step 1**

In Botpress Studio, select **Explore Hub** in the upper-right corner.

**Step 2**

Search for the HITL integration, then select **Install Integration**.

### Step 2: Install the HITL plugin

Next, install the official HITL plugin. This will allow you to start HITL from any point in your Workflow.

**Step 1**

Navigate back to Botpress Hub and search for the HITL plugin.

**Step 2**

Select it, then select **Install Plugin**.

**Step 3**

In the **Configuration** menu, open the dropdown under **HITL integration**.

> [!NOTE]
>
> This dropdown will display all HITL-compatible integrations you've installed. Since this is a guide to the official Botpress HITL integration, we'll select that one for now.

Select **HITL**.

**Step 4**

Scroll down and select **Save**.

> [!TIP]
>
> The plugin's **Configuration** section contains many optional fields. You can use these to customize your HITL experience.

### Step 3: Add the Start HITL card to your Workflow

**Step 1**

Open a Workflow in Studio and create (or select) any Node.

**Step 2**

Add the **Start HITL** Card at the point where you want to hand off conversations to a live agent:

![Start HITL Card](https://mintcdn.com/botpress/xMO2iLgMMQQYQofR/integrations/integration-guides/assets/start-hitl-card.png?fit=max\&auto=format\&n=xMO2iLgMMQQYQofR\&q=85\&s=8e5d4d25a5638275a3319a6010e76f15)

**Step 3**

In the Card's [inspector](https://botpress.com/docs/studio/concepts/cards/introduction.md#configure-a-card), fill in the required fields:

| Fields | Description |
| :- | :- |
| **Ticket Title** | The name of the ticket created for the live agent. |
| **User ID** | The user ID associated with the ticket. Enter the `{{event.userId}}` variable to use the current user's ID. |
| **Conversation ID** | The conversation ID associated with the ticket. Enter the `{{event.conversationId}}` variable to use the current conversation's ID. |

> [!TIP]
>
> Done! HITL will begin whenever the **Start HITL** card executes.
>
> For more information about assigning live agents and managing conversations, check out the [Human Handoff](https://botpress.com/docs/get-started/manage-your-agent/human-handoff.md) guide.


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