#Intercom HITL 集成 该集成允许Botpress 将Intercom 用作 HITL(Human in the Loop)提供商。来自机器人的消息将显示在Intercom 中,而代理的回复将发回给机器人。 ##功能 -Botpress 和Intercom 之间的无缝集成 - 实时信息同步 - 支持文本消息 - 自动对话会话管理 Webhook事件处理 - 代理分配和会话管理 ## 配置 集成需要以下配置: - accessToken`:您的Intercom 访问令牌(API 验证所需的令牌) ### 集成Botpress 的Intercom 应用程序设置 本指南指导您设置和配置Intercom ,以便与Botpress 聊天机器人集成。 ### 分步说明 #### 1.创建Intercom 应用程序 * 导航至intercomintercom * 登录您的Intercom 账户 * 转到开发者hub 的**应用程序** * 点击 **"创建应用程序 "** * 输入您的应用程序名称(例如,Botpress HITL Integration) * 点击 **"创建应用程序 "** #### 2.复制访问令牌 * 在应用程序仪表板中,转到**身份验证** * 复制访问令牌部分显示的**访问令牌** * 在**Botpress Intercom 集成配置**中,粘贴此访问令牌 #### 3.配置网络钩子 ##### a. 对话事件Webhook * 进入应用程序控制面板中的**网络钩子**。 * 点击**"添加Webhook"** * 将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 配置中启用调试日志,以排除集成问题。