事件推送机制 - 伯索开放平台

课堂事件发生时，伯索平台会向开发者服务器地址推送消息（见接入指南）

商户系统处理成功时需返回成功标识{"code":0}（"application/json;charset=utf-8"）。

未接收到成功标识或者超时（超时时间5s）时，推送会进行重试。重试时间一次间隔增加，一共3次。

建议开发者根据业务场景进行一定的去重操作。

📌

info[配置]
请联系伯索商务对接同事，完成具体回调地址的配置流程。
配置参数【zyjtool系统】： liveEventCallBackUrl

事件列表说明

事件类型	事件代码（eventType）	同步时机	说明
课堂结束事件	report	课后	课堂及学员基本统计数据
课堂用户上下线事件	attendance	课中	每个学员进出课堂消息
课堂缺勤通知事件	absence	课中	课堂开始后缺勤人员数据
课堂一键召回事件	recall	课中	课堂中老师/助教主动发起召回事件

📌

事件通知类型配置

用户根据业务需要，对接事件类型。

联系伯索商务对接同事【zyjtool系统】配置参数liveEventCallBackTypes

启用report，值设置为1

启用attendance，值设置为2

启用absence，值设置为4

启用recall，值设置为8

支持多个事件类型(相加配置即可。如 3:表示启用 report 和attendance)

回调数据格式说明

💡

安全签名信息：
appId : 在申请接入时，伯索平台给予的appId
validBegin: 发送方发送请求时的Unix Epoch 时间戳，单位秒
validTime: 取固定值1200，单位秒
eventInfo: 消息主体内容。字符串类型
signature: 按照签名加密提供的方法返回的签名字符串

参考样例

{
    "appId": "w",
    "eventInfo": "{\"eventType\":\"absence\",\"meetingId\":26226256,\"events\":{\"teacherId\":\"0_30389575\",\"users\":[{\"assistantIds\":[],\"students\":[{\"userId\":\"1_32663337\",\"attendStatus\":2},{\"userId\":\"1_32663341\",\"attendStatus\":2}]}]}}",
    "signature": "56D0480FECD9E2AAE4DC5CBF18CFB26547D83200",
    "validBegin": 1778832721,
    "validTime": 60
}

eventInfo 本质上是一个Json字符串，参与请求体参数统一的签名计算signature

事件推送流程