플랫폼
특징
상담원 스튜디오
신속한 에이전트 구축 및 사용자 지정
자율 엔진
LLMs 사용하여 대화 및 작업 안내
지식 베이스
사용자 지정 지식 소스로 봇을 학습시키세요
테이블
대화 데이터 저장 및 관리
채널
Whatsapp 엠블럼
WhatsApp
Instagram 엠블럼
Instagram
Facebook Messenger 로고
Messenger
Slack 로고
Slack
모든 채널
통합
허브스팟 로고
HubSpot
Notion 로고
Notion
Jira 로고
Jira
Calendly 로고
Calendly
모든 통합
LLM 공급자
OpenAI 로고
OpenAI
Anthropic 로고
Anthropic
Groq 로고
Groq
허깅페이스 로고
Hugging Face
모두 LLMs
솔루션
For
엔터프라이즈
미션 크리티컬 프로덕션 워크플로우 자동화
대행사
정교한 상담원 서비스 제공
개발자
상담원 개발을 위한 강력한 API 살펴보기
고객 사례
성공적인 고객 사례를 통해 Botpress 이 전 세계 비즈니스를 어떻게 혁신하고 있는지 알아보세요.
산업별
전자 상거래
교육
금융
호스피탈리티
모든 산업
부서별
판매
엔지니어링
제품
ITSM
모든 부서
사용 사례별
쇼핑 도우미
리드 생성
직원 경험
티켓 관리
모든 사용 사례
자원
필수
Academy
선별된 강좌를 통해 빌드 배우기
라이브러리
AI 워크플로우를 개선하기 위한 리소스
블로그
Botpress 및 AI 에이전트에 대한 인사이트 및 업데이트
건물
디스코드
수천 명의 동료와 함께 아이디어를 공유하세요
문서
종합 가이드 및 참고 자료
API
외부 시스템과 함께 사용하기 위한 참고 자료
LLM 순위
모델 제공업체의 성능 및 비용 비교
영상
튜토리얼, 데모 및 제품 워크스루
변경 로그
최신 Botpress 업데이트에 대한 최신 정보
파트너
파트너가 되세요
인증된 전문가 네트워크에 가입하세요
전문가 고용하기
파트너 및 컨설턴트와 연결
문서
엔터프라이즈
가격정책
로그인
연락처가입하기
돌아가기 Hub

LiveChat HITL

v3.0.1
워크스페이스에 설치
관리: Botpress 성장 팀
  # 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/).

더 나은 구축 Botpress

놀라운 AI 상담원 경험을 만들어 보세요.

시작하세요 - 무료입니다
화살표 아이콘
자세한 내용은 다음에서 확인하세요. Botpress Academy

엄선된 교육 과정, 가이드 및 튜토리얼 컬렉션을 통해 AI 에이전트를 더 빠르고 효과적으로 구축하세요.

전문가 고용하기

인증된 개발자와 연결하여 필요에 맞는 전문 빌더를 찾아보세요.

모든 시스템 운영
SOC 2
인증
GDPR
규정 준수
© 2025
플랫폼
가격정책
상담원 스튜디오
자율 엔진
지식 베이스
테이블
허브
통합
채널
LLMs
자원
판매 부서와 대화하기
문서화
전문가 고용하기
영상
고객 사례
API 참조
블로그
상태
V12 자원
커뮤니티
커뮤니티 지원
파트너가 되세요
홍보대사 되기
제휴사 되기
회사
회사에 대해서
경력
뉴스 & 보도자료
법적
개인 정보 보호
© Botpress 2025