#Botpress HITL 整合
此整合可讓您將Botpress 機器人與 Brevo 的對話平台連線,實現 Human-in-the-Loop (HITL) 設定。這表示您的Botpress 機器人可以處理初始使用者互動,並在必要時將對話無縫升級至 Brevo 的人工代理。
如何運作
當用戶與您的Botpress 機器人互動時,對話可以轉移到 Brevo 的人工代理。該代理可以接手對話,並提供個人化的支援。Botpress 使用者的訊息會轉達給 Brevo 代理,反之亦然。
主要限制
使用此整合時,請注意下列限制:
** 訊息歸屬:** 由Botpress 使用者傳送至 Brevo 代理的訊息,將顯示為由整合設定的 Brevo 代理帳號所傳送。但是,為了區分這些訊息,它們會以Botpress User: "作為前綴。例如:Botpress User: Hello, I need help with my order.`。 ** 狀態更新:**Botpress 使用者將不會自動收到關於代理指派的通知或狀態更新(例如:「代理 John 已加入聊天」)。
設定指南
要設定Botpress HITL 整合,您將需要以下項目:
- Brevo API Key:
- 您可以按照 Brevo 官方幫助頁面上的指示來創建和管理您的 API 密鑰:Create and manage your API keys
- 停用IP封鎖:** **
- 為了讓Botpress 與Brevo之間的溝通更順暢,您必須停用Botpress 帳號中的IP封鎖功能。
- 導覽至 Brevo IP Authorisation 並確保 IP 封鎖已停用,以允許從您的Botpress 環境發出的請求。
- Brevo 代理 ID:
- 您需要指定整合使用哪個 Brevo 代理帳號來傳送和接收訊息。
- 導覽到 Brevo 代理設定頁面:Brevo 代理設定
- 確定您希望整合使用的代理,並複製其代理 ID。
Webhook 設定 (必要)
若要在您的Botpress 整合中接收來自 Brevo 的事件,您必須在 Brevo 中設定webhook :
1.前往 Brevo 面板中的 ** 整合 > Webhooks**(直接連結)。 2.點選 **新增webhook(或編輯現有的webhook)。 3.在 URL 欄位中,輸入您的Botpress Brevo 整合webhook 端點。範例:
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
4.在 ** 事件類型** 下,選擇:
- 對話開始
- 對話記錄
- 對話片段 5.按一下 Save 啟用webhook。
注意: 確保 URL 與您的Botpress 整合端點相符,並檢查所有必要的事件類型以獲得完整功能。
一旦設置完成,您的Botpress 整合將收到來自 Brevo 的即時事件,並可進行相應處理。
獲得這些詳細資訊後,您就可以根據整合的特定設定指示,在您的Botpress 環境中進行整合設定。