#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整合，您需要以下條件：
1. **Brevo API Key:**
- 您可以按照 Brevo 官方幫助頁面上的指示來創建和管理您的 API 密鑰：[Create and manage your API keys](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **停用IP封鎖：** 2.
- 為了讓Botpress 與Brevo之間的溝通更順暢，您必須在您的Brevo帳號中停用IP封鎖功能。
- 導航至 [Brevo IP Authorisation](https://app.brevo.com/security/authorised_ips)，並確保 IP 封鎖已停用，以允許Botpress 環境的請求。
3. ** Brevo 代理 ID:**
- 您需要指定整合使用哪個 Brevo 代理帳號來傳送和接收訊息。
- 導航到 Brevo 代理設定頁面：[Brevo 代理設定](https://conversations-app.brevo.com/settings/agents)
- 識別您希望整合使用的代理，並複製其代理 ID。
##Webhook 設定 (必要)
要在您的Botpress 整合中接收來自 Brevo 的事件，您必須在 Brevo 中設定一個webhook ：
1.前往 Brevo 面板中的 ** 整合 > Webhooks**（[直接連結](https://conversations-app.brevo.com/settings/integrations/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 環境中進行整合設定。
