المنصة
الميزات
استوديو الوكيل
أنشئ وكيلك وخصصه بسرعة
المحرك المستقل
استخدم LLMs لتوجيه المحادثات والمهام
قواعد المعرفة
تدريب الروبوت الخاص بك باستخدام مصادر المعرفة المخصصة
الجداول
تخزين بيانات المحادثة وإدارتها
القنوات
Whatsapp الشعار
WhatsApp
Instagram الشعار
Instagram
فيسبوك Messenger الشعار
Messenger
Slack Logo
Slack
جميع القنوات
التكاملات
شعار هبسبوت
هوب سبوت
شعار Notion
Notion
شعار جيرا
جيرا
Calendly الشعار
Calendly
جميع عمليات الدمج
LLM المزودون
شعار OpenAI
OpenAI
شعار Anthropic
Anthropic
شعار Groq
Groq
شعار HuggingFace
Hugging Face
الكل LLMs
محاليل
بالنسبة لـ
مؤسسة
أتمتة عمليات سير عمل الإنتاج ذات المهام الحرجة
الوكالات
تقديم خدمات الوكيل المتطورة
المطورين
استكشاف واجهة برمجة تطبيقات API قوية لتطوير الوكلاء
قصص العملاء
اكتشف من العملاء الناجحين كيف يقوم Botpress بتحويل الأعمال التجارية في جميع أنحاء العالم.
حسب الصناعة
التجارة الإلكترونية
التعليم
التمويل
الضيافه
جميع الصناعات
حسب القسم
المبيعات
الهندسة
المنتج
إدارة خدمات تكنولوجيا المعلومات والاتصالات
جميع الأقسام
حسب حالة الاستخدام
مساعد تسوق
توليد العملاء المحتملين
تجربة الموظف
إدارة التذاكر
جميع حالات الاستخدام
موارد
أساسي
Academy
تعلّم البناء من خلال الدورات التدريبية المنسقة
المكتبة
موارد لتحسين سير عمل الذكاء الاصطناعي لديك
مدونة
رؤى وتحديثات حول Botpress وعوامل الذكاء الاصطناعي
المبنى
ديسكورد
انضم إلى آلاف الأقران وشارك الأفكار
مستندات
أدلة ومراجع شاملة
واجهة برمجة التطبيقات
مواد مرجعية للاستخدام مع الأنظمة الخارجية
LLM الترتيب
مقارنة الأداء والتكلفة لمقدمي الخدمات النموذجية
مقاطع الفيديو
برامج تعليمية وعروض توضيحية وعروض تجول للمنتج
سجل التغييرات
ابق على اطلاع دائم بآخر تحديثات Botpress
شركاء
كن شريكًا
انضم إلى شبكتنا من الخبراء المعتمدين
استعن بخبير
تواصل مع الشركاء والاستشاريين
مستندات
مؤسسة
الأسعار
تسجيل الدخول
اتصل بناالتسجيل
العودة إلى Hub

الدردشة المباشرة 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

صمم تجارب عملاء الذكاء الاصطناعي المذهلة.

ابدأ الآن- مجانًا
أيقونة سهم
تعرف على المزيد في Botpress Academy

أنشئ وكلاء الذكاء الاصطناعي بشكل أفضل وأسرع مع مجموعتنا المنسقة من الدورات التدريبية والأدلة والبرامج التعليمية.

استعن بخبير

تواصل مع مطورينا المعتمدين للعثور على مطور خبير يناسب احتياجاتك.

جميع الأنظمة قيد التشغيل
SOC 2
معتمد
اللائحة العامة لحماية البيانات العامة
متوافق
© 2025
المنصة
الأسعار
استوديو الوكيل
المحرك المستقل
قواعد المعرفة
الجداول
مجمع
التكاملات
القنوات
LLMs
موارد
تحدث إلى مسؤولي المبيعات
مستندات
استعن بخبير
مقاطع الفيديو
قصص العملاء
مراجع واجهة برمجة التطبيقات
مدونة
الحالة
مصادر الإصدار رقم 12
المجتمع
دعم المجتمع
كن شريكًا
كن سفيراً
كُن شريكًا
الشركة
عننا
الوظائف
الأخبار والصحافة
قانوني
الخصوصية
Botpress 2025