事件订阅

简述

事件订阅 用于维护外部系统接收 OpenDesk 事件的 Webhook 地址。您可以把 CRM、数据中台或自有服务的 HTTPS Endpoint 配置为订阅接口，后续由具体业务规则（例如 呼叫中心 → 通话集成 → 事件订阅）决定哪些事件推送到该接口。

事件订阅只负责「推到哪里」；具体「推什么」由各业务模块的订阅规则配置。

功能位置

在管理后台侧边栏 全局设置 → 事件订阅 打开。页面可查看订阅列表、按名称搜索、按状态筛选，并新建、编辑、启用、停用或删除订阅。

配置与规则

新建订阅

点击 新建订阅，填写：

配置项	说明
名称	便于识别接收方，例如「CRM 通话回调」
Endpoint URL	外部系统接收事件的公网 HTTPS 地址
描述	可选，用于说明用途

保存成功后，系统会生成 Webhook Secret 并完整展示一次。请立即复制到接收方服务端保存；关闭弹窗后只会显示脱敏值。

Webhook Secret

OpenDesk 推送事件时，会在请求头中携带 Webhook Secret。接收方应校验该值，校验失败时返回非 2xx 状态。

可在订阅详情中 轮换 Secret。轮换后会生成新的 Secret，旧 Secret 会保留一段时间用于平滑切换；确认接收方已改用新值后，可停止使用旧值。

测试投递

订阅创建后，可点击 发送测试请求。测试请求用于确认 Endpoint 可访问、鉴权逻辑正确、接收方能返回 2xx。测试失败不会自动重试。

启用、停用与删除

• 停用 后，不再产生新的事件投递；重新启用不会补发停用期间的事件。
• 删除 前，系统会检查是否仍被自动外呼任务或通话事件订阅规则引用；若仍被引用，需先解除绑定。
• 每个租户最多可创建 20 个订阅接口。

注意事项

• Endpoint 应使用公网可访问的 HTTPS 地址，不建议使用内网地址、localhost 或带账号密码的 URL。
• 接收方应尽快返回 2xx；耗时的业务处理建议异步执行。
• Webhook Secret 不应写入前端代码、截图、工单或日志。
• 同一订阅接口可被不同业务模块引用，但具体限制以业务规则页面提示为准。

与其他功能的关系

• 呼叫中心 → 通话集成 → 事件订阅：选择此处创建的订阅接口，并配置通话事件规则。
• 触达中心 → 自动外呼任务：部分自动外呼回调能力也会引用事件订阅。
• API Key：通话录音下载地址过期后，可使用 API Key 重新签发下载地址。

业务场景示例

将通话事件推送到 CRM

角色与目标： 管理员希望通话结束后，CRM 能收到通话结果并关联到客户跟进记录。

系统配置： 先在 全局设置 → 事件订阅 新建 CRM 的 Webhook 地址，并完成测试投递；再到 呼叫中心 → 通话集成 → 事件订阅 配置通话事件规则。

场景效果： 新发生且命中规则的通话事件会推送到 CRM，CRM 可按通话公开标识把多条事件归并到同一通电话。