流程
- 一个完整的事件订阅操作包含了 配置请求网址URL及事件订阅 和 接收并响应事件
第一步 启用事件订阅功能
企业管理员登录企业管理平台,在应用管理菜单下选择编辑对应应用。在事件订阅菜单下打开事件订阅开关
第二步 配置请求地址URL
在请求网址URL输入框中输入URL,保存后,会校验该URL的可达性,避免设置无效的订阅地址。
- 请求网址URL用于接收事件并响应事件
- 当应用订阅的事件触发时,会向配置的请求网址URL发送对应的事件通知
第三步 添加订阅事件
点击添加事件,并按需订阅,如机器人接收消息事件,确认添加后,点击保存
第四步 接收并响应事件
-
当订阅的事件发生时,UC会将通知报文发送到你预先配置的请求地址URL,应用服务器接收并进行响应处理。
-
通知报文以
HTTPS
或HTTP
的方式进行传输,使用POST
方法,报文格式限定为 JSON 格式。
完成以上步骤即可订阅一个完整的事件
重试策略
在收到UC发送的通知请求后,应用服务器需要在 5s 内返回 200
或 204
的响应,如果在5s内没有响应该通知请求,UC将视此次通知失败,并重新发送通知请求
重试策略
- 采用一定时间间隔重试,支持最大重试24次,具体间隔为:30s, 5m, 10m, 30m, 1h, ... 1h(共 20 个 1h )当重试周期结束还未投递成功,将不再重试,直到有新的事件到达。
- 当重试过程中,服务器在 5s 内返回
200
或204
的响应,就认为消息投递成功,不再重试。