集成
集成页面管理角色与第三方系统的连接，支持 webhook 入站、轮询和手动三种数据接入方式，可创建角色私有连接，并记录所有入站事件日志。
页面概览
页面顶部为角色名称和运行状态，右上角为「编辑配置」和「停止」按钮。
连接说明
页面顶部绿色提示框说明集成的核心功能：
连接第三方系统：把外部数据接进来，交给工单 / 技能 / 对话流处理
三种接入方式
| 方式 | 说明 |
|---|---|
| 入站 | 对方推 webhook 过来（把下面的地址配给对方） |
| 轮询 | 我们定期去查（间隔 0 = 只等 webhook 不查） |
| 手动 | 工单详情里点「刷新外部状态」现查 |
可用连接
新建连接
右上角「+ 新建角色私有连接」按钮，创建仅当前角色可用的私有连接。
备注
组织共享的连接由管理员在「集成连接」页维护；这里可以建只有本角色能用的私有连接。
连接列表
空状态时显示：
- 插头图标
- "还没有可用连接"
- 说明文字：组织共享的连接由管理员在「集成连接」页维护；这里可以建只有本角色能用的私有连接
入站事件
筛选控制
| 控制 | 说明 |
|---|---|
| 全部 | 显示所有入站事件 |
| 处理失败 | 仅显示处理失败的事件 |
| 刷新 | 手动刷新事件列表 |
事件表格
入站事件以表格形式记录，包含以下列：
| 列名 | 说明 |
|---|---|
| 时间 | 事件接收时间 |
| 来源 | 事件来源系统 |
| 事件类型 | 事件的类型标识 |
| 业务单号 | 关联的业务单据号 |
| 落到哪 | 事件路由到的目标（工单/技能/对话） |
| 结果 | 事件处理结果 |
| 操作 | 可用操作 |
空状态
当没有入站事件时显示：
还没有收到入站事件。把上面的 webhook 地址配到对方系统即可。
集成工作流程
- 创建连接：点击「+ 新建角色私有连接」，配置第三方系统的连接信息
- 获取 webhook 地址：系统为每个连接生成唯一的 webhook 地址
- 配置第三方系统：将 webhook 地址配置到第三方系统中
- 接收事件：第三方系统推送事件到 webhook 地址
- 路由处理：系统根据配置将事件路由到工单、技能或对话流处理
- 查看日志：在「入站事件」表格中查看所有事件的处理状态和结果
连接类型
| 类型 | 说明 |
|---|---|
| 组织共享连接 | 管理员创建，所有角色可用 |
| 角色私有连接 | 当前角色创建，仅当前角色可用 |
提示
配置 webhook 集成时，建议先在第三方系统中使用测试事件验证连接是否正常。在「入站事件」表格中可以确认事件是否成功接收和处理。如果事件处理失败，切换到「处理失败」标签快速定位问题。