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