Plataforma
Features
Estúdio de agentes
Crie e personalize o seu agente rapidamente
Motor autónomo
Utilizar LLMs para orientar as conversas e as tarefas
Bases de conhecimento
Treine seu bot com fontes de conhecimento personalizadas
Tabelas
Armazene e gerencie dados de conversa
Canais
Emblema do Whatsapp
WhatsApp
Instagram Emblema
Instagram
Logótipo do Facebook Messenger
Messenger
Logotipo do Slack
Slack
Todos os canais
Integrações
Logótipo da Hubspot
HubSpot
Logótipo Notion
Notion
Logótipo Jira
Jira
Calendly logótipo
Calendly
Todas as integrações
Provedores de LLM
Logótipo OpenAI
OpenAI
Logótipo Anthropic
Anthropic
Logótipo Groq
Groq
Logótipo HuggingFace
Hugging Face
Todos os LLMs
Soluções
Para
Enterprise
Automatize fluxos de trabalho de produção essenciais.
Agências
Ofereça serviços de agentes sofisticados.
Programadores
Explore uma API robusta para desenvolvimento de agentes.
Histórias de clientes
Descubra, através de clientes bem sucedidos, como o Botpress está a transformar os negócios em todo o mundo.
Por sector
Ecommerce
Educação
Finanças
Hospitalidade
Todos os setores
Por Departamento
Vendas
Engenharia
Produto
ITSM
Todos os departamentos
Por caso de utilização
Assistente de compras
Geração de leads
Experiência do Funcionário
Gestão de Tickets
Todos os casos de utilização
Recursos
Essencial
Academy
Aprenda a construir por meio de cursos selecionados.
Biblioteca
Recursos para melhorar os seus fluxos de trabalho de IA.
Blogue
Insights e atualizações sobre o Botpress e agentes de IA.
edifício
Discord
Junte-se a milhares de colegas e partilhe ideias
Documentos
Guias e referências abrangentes.
API
Material de referência para utilização com sistemas externos
LLM Classificação
Compare o desempenho e o custo para provedores de modelos.
Vídeos
Tutoriais, demonstrações e orientações sobre produtos
Registro de Alterações
Mantenha-se atualizado sobre as últimas atualizações do Botpress.
Parceiros
Torne-se um Parceiro
Junte-se à nossa rede de especialistas certificados.
Contrate um Especialista
Ligação com parceiros e consultores
Documentos
Enterprise
Preços
Iniciar sessão
ContatoInscrever-se
voltar para Hub

LiveChat HITL

v3.0.1
Instalar no seu espaço de trabalho
Mantido por Botpress Equipa de crescimento
  # 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
- Group-based routing for HITL conversations

## Configuration

The integration requires the following configuration:

- `clientId`: Your LiveChat client ID
- `organizationId`: Your LiveChat organization ID
- `webhookSecret`: Secret key for webhook verification
- `agentToken`: Your LiveChat personal agent token (Base64 encoded)
- `groupId`: LiveChat Group ID for routing HITL conversations

## 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. Get Your Personal Agent Token

- Navigate to [https://platform.text.com/console/settings/authorization/personal-access-tokens](https://platform.text.com/console/settings/authorization/personal-access-tokens)
- Click **"Create Token"**
- Give your token a descriptive name (e.g., "Botpress HITL Integration")
- Select the following scopes:
  - `chats--access:rw`
- Click **"Create Token"**
- **Important:** Copy the Base64 encoded token immediately as it won't be shown again
- In your **Botpress LiveChat integration config**, paste this Base64 encoded token in the `agentToken` field

#### 5. Configure Group Routing

- In LiveChat, go to **Settings → Groups**
- Create a new group specifically for HITL conversations or note the ID of an existing group
- Copy the **Group ID** (this will be a number)
- In your **Botpress LiveChat integration config**, paste this Group ID in the `groupId` field
- **Note:** All HITL conversations will be routed to this group
- **Important:** By default, the initial agent assignment will be the agent that created the chat, so that agent must be in the specified group. Additionally, there need to be other available agents in the group besides the initial agent for the assignment to work properly. If necessary, you can set primary/backup agents in the group configuration.

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

#### 7. 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
- **Agent Token**: From Personal Access Tokens (Base64 encoded)
- **Group ID**: From LiveChat Groups settings
- **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
5. All HITL conversations will be automatically routed to the specified group

## 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
- Personal agent token authentication
- Secure token management

## Support

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

Construir melhor com Botpress

Crie experiências incríveis para agentes de IA.

Comece agora - é grátis
Ícone de uma seta
Saiba mais na Botpress Academy

Crie agentes de IA melhor e mais rapidamente com a nossa coleção de cursos, guias e tutoriais.

Contrate um Especialista

Conheça nossos desenvolvedores certificados para encontrar um construtor especializado que atenda às suas necessidades.

Todos os sistemas operacionais
SOC 2
Certificado
RGPD
Em conformidade
© 2025
Plataforma
Preços
Estúdio de agentes
Motor autónomo
Bases de conhecimento
Tabelas
Hub
Integrações
Canais
LLMs
Recursos
Fale com Vendas
Documentação
Contrate um Especialista
Vídeos
Histórias de clientes
Referência da API
Blogue
Status
v12 Recursos
Comunidade
Suporte da Comunidade
Torne-se um Parceiro
Torne-se um Embaixador
Torne-se um Afiliado
Empresa
Sobre
Carreiras
Notícias e imprensa
Legal
Privacidade
© Botpress 2025