#Intercom HITL 整合 此整合可讓Botpress 使用Intercom 作為 HITL (Human in the Loop) 提供者。來自機器人的訊息會顯示在Intercom 中,而代理的回應則會傳送回機器人。 ## 功能 -Botpress 與Intercom 之間的無縫整合 - 即時同步訊息 - 支援文字訊息 - 自動對話會話管理 Webhook事件處理 - 代理指派和會話管理 ## 配置 整合需要以下設定: - `accessToken`:您的Intercom 存取代碼 (API 認證所需) ##Botpress 整合的Intercom 應用程式設定 本指南將教您如何設定Intercom 與Botpress 聊天機整合。 ###步驟說明 #### 1.建立Intercom App * 導覽到intercomintercom * 登入您的Intercom 帳戶 * 前往開發者hub 的**應用程式** * 按一下 **「建立應用程式」** * 輸入您的應用程式名稱 (例如:Botpress HITL Integration") * 按一下 **「建立應用程式 」**。 #### 2.複製存取權限 * 在您的應用程式儀表板中,前往 **驗證**。 * 複製 Access token 區段中顯示的 **Access Token** * 在您的Botpress Intercom 整合設定** 中,貼上此存取權限。 #### 3.配置 Webhooks ##### a. 會話事件Webhook * 移至應用程式儀表板中的 **Webhooks**。 * 按一下 **「新增Webhook 」**。 * 將 **Webhook URL** 設定為您的Botpress Intercom 整合webhook URL** ** 只訂閱這些事件:** ** * 對話.管理.分配 * 對話.管理.關閉 * 對話.管理.回覆 * 按一下 **「儲存Webhook 」** ### 所需的Botpress 配置摘要 ** 存取令牌**:來自Intercom 應用程式驗證 Webhook URL**:由Botpress 提供Botpress ## 使用方法 1.設定與您的Intercom 存取令牌整合 2.使用 `startHitl` 動作啟動對話會話 3.來自機器人的訊息會出現在Intercom 對話中 4.Intercom 中的代理回應會傳回給機器人 5.對話狀態會在Botpress 和Intercom 之間自動管理Intercom > **注意:** 當開始 HITL 會話時,如果使用者的電子郵件在Intercom 中不存在於連絡人中,則會自動建立新的連絡人。如果電子郵件已經存在,則會在 HITL 過程中使用現有的聯絡人。 ## 支援 如需支援,請聯絡Botpress 團隊或參考Intercom API 文件]intercom。 ## 疑難排解 ### 常見問題 1.**Webhook 無法接收事件**:確保您的webhook URL 可公開存取並已正確設定 2.**驗證錯誤**:驗證您的存取權杖是否正確,並具有所需的權限 3.**訊息未同步**:檢查對話是否已正確建立,且連絡人是否存在於Intercom 中。Intercom ### 調試模式 在您的Botpress 設定中啟用除錯紀錄,以排除整合問題。