# LiveChat HITL 整合 此整合允許Botpress 使用 LiveChat 作為 HITL（人機互動）提供者。機器人的訊息將顯示在 LiveChat 中，客服人員的回覆也會被傳送回機器人。 ## 功能 - 無縫集成Botpress 和 LiveChat - 即時訊息同步 - 支援文字訊息 - 自動聊天會話管理 - Webhook基於事件處理## 設定整合需要以下設定： - clientId：您的 LiveChat 用戶端 ID - organizationId：您的 LiveChat 組織 ID - webhookSecret：金鑰webhook 驗證## LiveChat 應用程式設置Botpress 集成本指南將引導您透過 platform.text.com 建立和設定 LiveChat 應用程序，以便與您的Botpress 聊天機器人。 > 📹 影片指南：觀看我們在 Loom 上步設定#a1458-194adcadc #### 1. 建立新應用 * 導航至 https://platform.text.com/console/apps * 點擊 「建置應用程式」 * 輸入你的應用程式名稱 * 確保選擇應用授權 → 伺服器端應用程式 * 複製 客戶 ID * 在您的 ** Botpress LiveChat 整合配置**，貼上此客戶端 ID * 新增以下範圍：chats.conversation--all:rw * *重要：新增您的 Botpress webhook URL* 到此區塊中的 重新導向 URI 欄位 #### 3. 新增您的組織 ID * 前往 https://platform.text.com/console/settings/account * 複製您的組織 ID** * * Botpress LiveChat 整合設定** #### 4. 設定 Webhooks ##### a. 傳入事件Webhook
- 在 Blocks 部分，新增 ** Chat Webhooks** 區塊 * 設定 ** Webhook 您的 ** 的 URL** Botpress LiveChat 集成webhook URL** * 產生一個金鑰並在您的Botpress 配置 * 設定以下內容： * 類型：
license * 觸發器：incoming_event * 過濾器：author_type = agent * 點選儲存 ##### b. Chat 已停用Webhook
- 新增另一個 ** Chat Webhooks** 區塊 * 使用相同webhook URL 和 金鑰 * 設定： * 觸發器：
chat_deactivated * 類型：license * 點選 儲存 ##### c. Chat 已轉移Webhook
- 再增加一個 ** Chat Webhooks** 區塊 * 使用相同webhook URL 和 密鑰 * 設定： * 觸發器：
chat_transferred * 類型：license * 點擊 儲存 #### 5. 完成應用程式設定 ##### a. 新增圖示 * 前往 清單詳細資料 部分 * 為您的應用程式設定 ** 選項「安裝應用程式」 ### 必要摘要Botpress 設定 * 客戶端 ID：來自應用程式授權區塊 * 組織 ID：來自帳戶設定 * 金鑰：來自webhook 設定 * ** Webhook URL**：由提供Botpress
- 範圍：
chats.conversation--all:rw * 重定向 URI：必須包含您的Botpress webhook 應用程序身份驗證塊中的 URL ## 用法 1. 使用您的 LiveChat 憑據配置集成 2. 使用 startHitl 操作啟動聊天會話 3. 來自機器人的消息將出現在 LiveChat 中 4. LiveChat 中的代理響應將發送回機器人 ## 事件 集成處理以下 LiveChat 事件： - incoming_event：來自代理的新消息 - chat_deactivated： Chat 會話結束 - chat_transferred: Chat 轉移到另一個代理##安全- Webhook 使用金鑰進行驗證 - API 呼叫的 OAuth2 驗證 - 安全性令牌管理 ## 支援 如需支持，請聯絡Botpress 團隊或參閱 LiveChat API 文件。
# LiveChat HITL 整合 此整合允許Botpress 使用 LiveChat 作為 HITL（人機互動）提供者。機器人的訊息將顯示在 LiveChat 中，客服人員的回覆也會被傳送回機器人。 ## 功能 - 無縫集成Botpress 和 LiveChat - 即時訊息同步 - 支援文字訊息 - 自動聊天會話管理 - Webhook基於事件處理## 設定整合需要以下設定： - `clientId`：您的 LiveChat 用戶端 ID - `organizationId`：您的 LiveChat 組織 ID - `webhookSecret`：金鑰webhook 驗證## LiveChat 應用程式設置Botpress 集成本指南將引導您透過 [platform.text.com](https://platform.text.com) 建立和設定 LiveChat 應用程序，以便與您的Botpress 聊天機器人。 > 📹 **影片指南**：觀看我們在 [Loom](https://www.loom.com/share/c291c86a10e3496791dd32f6c0b0c64c?sid=84100a6a-b699-4363-89f2-194adad-194ad) 上步設定#a1458-194adcadc #### 1. 建立新應用 * 導航至 [https://platform.text.com/console/apps](https://platform.text.com/console/apps) * 點擊 **「建置應用程式」** * 輸入你的應用程式名稱 * 確保選擇**應用授權 → 伺服器端應用程式** * 複製 **客戶 ID** * 在您的 ** Botpress LiveChat 整合配置**，貼上此客戶端 ID * 新增以下範圍：``` chats.conversation--all:rw ``` * **重要：**新增您的** Botpress webhook URL** 到此區塊中的 **重新導向 URI** 欄位 #### 3. 新增您的組織 ID * 前往 [https://platform.text.com/console/settings/account](https://platform.text.com/console/settings/account) * 複製您的組織 ID** * * Botpress LiveChat 整合設定** #### 4. 設定 Webhooks ##### a. 傳入事件Webhook
* 在 **Blocks** 部分，新增 ** Chat Webhooks** 區塊 * 設定 ** Webhook 您的 ** 的 URL** Botpress LiveChat 集成webhook URL** * **產生一個金鑰**並在您的Botpress 配置 * 設定以下內容： * **類型**：`license` * **觸發器**：`incoming_event` * **過濾器**：`author_type = agent` * 點選**儲存** ##### b. Chat 已停用Webhook
* 新增另一個 ** Chat Webhooks** 區塊 * 使用**相同webhook URL** 和 **金鑰** * 設定： * **觸發器**：`chat_deactivated` * **類型**：`license` * 點選 **儲存** ##### c. Chat 已轉移Webhook
* 再增加一個 ** Chat Webhooks** 區塊 * 使用**相同webhook URL** 和 **密鑰** * 設定： * **觸發器**：`chat_transferred` * **類型**：`license` * 點擊 **儲存** #### 5. 完成應用程式設定 ##### a. 新增圖示 * 前往 **清單詳細資料** 部分 * 為您的應用程式設定 ** 選項**「安裝應用程式」** ### 必要摘要Botpress 設定 * **客戶端 ID**：來自應用程式授權區塊 * **組織 ID**：來自帳戶設定 * **金鑰**：來自webhook 設定 * ** Webhook URL**：由提供Botpress
* **範圍**：`chats.conversation--all:rw` * **重定向 URI**：必須包含您的Botpress webhook 應用程序身份驗證塊中的 URL ## 用法 1. 使用您的 LiveChat 憑據配置集成 2. 使用 `startHitl` 操作啟動聊天會話 3. 來自機器人的消息將出現在 LiveChat 中 4. LiveChat 中的代理響應將發送回機器人 ## 事件 集成處理以下 LiveChat 事件： - `incoming_event`：來自代理的新消息 - `chat_deactivated`： Chat 會話結束 - `chat_transferred`: Chat 轉移到另一個代理##安全- Webhook 使用金鑰進行驗證 - API 呼叫的 OAuth2 驗證 - 安全性令牌管理 ## 支援 如需支持，請聯絡Botpress 團隊或參閱 [LiveChat API 文件](https://developers.livechat.com/docs/)。
