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

LiveChat HITL

v1.0.0
Install on your Workspace
Maintained by Botpress Growth Team
  # LiveChat HITL Integration

This integration allows Botpress to use LiveChat as a HITL (Human in the Loop) provider. Messages from the bot will appear in LiveChat, and agent responses will be sent back to the bot.

## Features

- Seamless integration between Botpress and LiveChat
- Real-time message synchronization
- Support for text messages
- Automatic chat session management
- Webhook-based event handling

## Configuration

The integration requires the following configuration:

- `clientId`: Your LiveChat client ID
- `organizationId`: Your LiveChat organization ID
- `webhookSecret`: Secret key for webhook verification

## LiveChat App Setup for Botpress Integration

This guide walks you through the creation and configuration of a LiveChat app via [platform.text.com](https://platform.text.com) to enable integration with your Botpress chatbot.

> 📹 **Video Guide**: Watch our step-by-step setup guide on [Loom](https://www.loom.com/share/c291c86a10e3496791dd32f6c0b0c64c?sid=84100a6a-b699-4363-89f2-194458c4a8ad)

### Step-by-Step Instructions

#### 1. Create a New App

* Navigate to [https://platform.text.com/console/apps](https://platform.text.com/console/apps)
* Click **"Build App"**
* Enter your app name
* Ensure **Livechat** is selected as the product
* Click **"Create App"**

#### 2. Add the App Authorization Block

* Go to **Blocks**
* Click **"Add Building Block"**
* Choose **App Authorization → Server-side App**
* Copy the **Client ID**
* In your **Botpress LiveChat integration config**, paste this Client ID
* Add the following scope:

  ```
  chats.conversation--all:rw
  ```
* **Important:** Add your **Botpress webhook URL** to the **Redirect URIs** field in this block

#### 3. Add Your Organization ID

* Go to [https://platform.text.com/console/settings/account](https://platform.text.com/console/settings/account)
* Copy your **Organization ID**
* Paste it into your **Botpress LiveChat integration config**

#### 4. Configure Webhooks

##### a. Incoming Event Webhook

* In the **Blocks** section, add a **Chat Webhooks** block
* Set the **Webhook URL** to your **Botpress LiveChat integration webhook URL**
* **Generate a secret key** and use the same key in your Botpress config
* Set the following:

  * **Type**: `license`
  * **Trigger**: `incoming_event`
  * **Filter**: `author_type = agent`
* Click **Save**

##### b. Chat Deactivated Webhook

* Add another **Chat Webhooks** block
* Use the **same webhook URL** and **secret key**
* Set:

  * **Trigger**: `chat_deactivated`
  * **Type**: `license`
* Click **Save**

##### c. Chat Transferred Webhook

* Add one more **Chat Webhooks** block
* Use the **same webhook URL** and **secret key**
* Set:

  * **Trigger**: `chat_transferred`
  * **Type**: `license`
* Click **Save**

#### 5. Finalize App Setup

##### a. Add an Icon

* Go to the **Listing Details** section
* Upload a **random icon** for your app (any image will work)

##### b. Install the App

* Go to the **Private Installation** tab
* Click **"Install App"**

### Summary of Required Botpress Config

* **Client ID**: From App Authorization block
* **Organization ID**: From Account Settings
* **Secret Key**: From webhook setup
* **Webhook URL**: Provided by Botpress
* **Scopes**: `chats.conversation--all:rw`
* **Redirect URI**: Must include your Botpress webhook URL in the App Auth block

## Usage

1. Configure the integration with your LiveChat credentials
2. Start a chat session using the `startHitl` action
3. Messages from the bot will appear in LiveChat
4. Agent responses in LiveChat will be sent back to the bot

## Events

The integration handles the following LiveChat events:

- `incoming_event`: New messages from agents
- `chat_deactivated`: Chat session ended
- `chat_transferred`: Chat transferred to another agent

## Security

- Webhook verification using a secret key
- OAuth2 authentication for API calls
- Secure token management

## Support

For support, please contact the Botpress team or refer to the [LiveChat API documentation](https://developers.livechat.com/docs/).

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