#Botpress HITL 集成
通过该集成，您可以将Botpress 机器人与 Brevo 会话平台连接起来，实现 "人在回路中"（HITL）设置。这意味着您的Botpress 机器人可以处理初始用户交互，并在必要时将对话无缝升级到 Brevo 的人工代理。
## 工作原理
当用户与您的Botpress 机器人进行交互时，对话会被转给 Brevo 中的人工代理。然后，人工座席可以接管对话并提供个性化支持。Botpress 用户的信息将转发给 Brevo 代理，反之亦然。
## 关键限制
使用此集成时，请注意以下限制：
- 信息归属：**Botpress 用户向 Brevo 代理发送的信息将显示为由集成配置的 Brevo 代理账户发送。不过，为了区分这些信息，它们将以Botpress 用户："作为前缀。例如："Botpress 用户：你好，我的订单需要帮助。
- 状态更新：**Botpress 用户不会自动收到有关代理分配的通知或状态更新（例如，"代理 John 已加入聊天"）。
## 设置指南
要配置Botpress HITL 集成，您需要具备以下条件：
1. **Brevo API 密钥：**
- 您可以按照 Brevo 官方帮助页面上的说明创建和管理您的 API 密钥：[创建和管理您的 API 密钥](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **停用 IP 屏蔽：** 2.
- 为了实现Botpress 和 Brevo 之间的无缝通信，有必要在您的 Brevo 账户中停用 IP 禁止。
- 导航至[Brevo IP授权](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.点击**保存**激活webhook。
> **注意：** 确保 URL 与Botpress 集成的端点相匹配，并检查所有必要的事件类型以实现完整功能。
设置完成后，您的Botpress 集成将从 Brevo 接收实时事件，并进行相应处理。
获得这些详细信息后，您就可以根据集成的具体设置说明，在Botpress 环境中配置集成了。
