Platform
Features
Agent Studio
Build and customize your agent rapidly
Autonomous Engine
Use LLMs to guide conversations and tasks
Knowledge Bases
Train your bot with custom knowledge sources
Tables
Store and manage conversation data
Channels
Whatsapp Emblem
WhatsApp
Instagram Emblem
Instagram
Facebook Messenger logo
Messenger
Slack logo
Slack
All channels
Integrations
HubSpot
Notion
Jira
Calendly
All integrations
LLM Providers
OpenAI
Anthropic
Groq
HuggingFace logo
Hugging Face
All LLMs
Solutions
For
Enterprise
Automate mission-critical production workflows
Agencies
Provide sophisticated agent services
Developers
Explore a robust API for agent development
Customer Stories
Discover from successful customers how Botpress is transforming business worldwide.
By Industry
Ecommerce
Education
Finance
Hospitality
All industries
By Department
Sales
Engineering
Product
ITSM
All departments
By Use Case
Shopping Assistant
Lead Generation
Employee Experience
Ticket Management
All use cases
Resources
Essential
Academy
Learn to build through curated courses
Library
Resources to enhance your AI workflows
Blog
Insights and updates on Botpress and AI agents
building
Discord
Join thousands of peers and share ideas
Docs
Comprehensive guides and references
API
Reference material for use with external systems
LLM Ranking
Compare performance and cost for model providers
Videos
Tutorials, demos, and product walkthroughs
Changelog
Stay up-to-date on the latest Botpress updates
Partners
Become a Partner
Join our network of certified experts
Hire an Expert
Connect with partners and consultants
Docs
Enterprise
Pricing
Log in
ContactSign up
back to Hub

HITL

v1.0.2
Install on your Workspace
Maintained by Botpress Team
  # HITL Integration

## Overview

HITL, or Human-in-the-Loop, is a Botpress feature that allows you to take over control of a conversation from your bot. It enables seamless interaction between your end-user and your live agents.
For example, if the conversation involves sensitive personal data, triggers specific legal language, or moves into territory that may require human expertise, the conversation is automatically handed off to a human agent for further handling.
You can configure the system to identify specific keywords, scenarios, or actions that require human oversight. This level of customizability ensures that only relevant conversations are escalated, preserving efficiency while safeguarding privacy.

<iframe src="https://www.youtube.com/embed/AAkARl8_cTo?si=X34o2Ajp7LmlxOoR" ></iframe>

## Configuration

Ensure that both the HITL Integration and the HITL Agent are installed and enabled. You can enable the HITL Agent from the Agent menu in the Studio.

## Usage

Once you’ve configured the HITL integration, you can use the ‘Escalate to a Human’ card in the ‘Agents’ menu of the card tray to identify points in the conversation at which you want the conversation to be handed over to a live agent.
The conversation will appear in the HITL tab of your bot’s dashboard, and can then be assigned to a live agent, who will be able to participate in the conversation directly from the dashboard.
The live agent can then hand control of the conversation back over to your bot whenever the conversation has been resolved.

![HITL Tab](https://i.imgur.com/mlQ6fzX.png)

HITL is only available to Team and Enterprise customers.

Build Better with Botpress

Craft amazing AI agent experiences.

Get started - it's free
Icon of an arrow
Learn more at Botpress Academy

Build AI agents better and faster with our curated collection of courses, guides, and tutorials.

Hire an Expert

Connect with our certified developers to find an expert builder that suits your needs.

All Systems Operational
SOC 2
Certified
GDPR
Compliant
© 2025
Platform
Pricing
Agent Studio
Autonomous Engine
Knowledge Bases
Tables
Hub
Integrations
Channels
LLMs
Resources
Talk to Sales
Documentation
Hire an Expert
Videos
Customer Stories
API Reference
Blog
Status
v12 Resources
Community
Community Support
Become a Partner
Become an Ambassador
Become an Affiliate
Company
About
Careers
News & Press
Legal
Privacy
© Botpress 2025