有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
通过事件订阅,应用可以及时响应腾讯会议中的变更事件。当事件发生时,腾讯会议开放平台会以 HTTP POST 请求的方式将事件内容以 JSON 格式推送给请求地址。腾讯会议开放平台支持的事件请参见 事件参考

配置流程

步骤一:配置基础信息




填写消息通知名称:用于区别不同的事件订阅用途。
配置 EncodingAESKey:建议配置,开放平台将向请求地址推送加密后的事件,提升用户数据的安全性。
加密推送的事件示例如下:
{
"data":"FIAfJPGRmFZWkaxPQ1XrJZVbv2JwdjfLk4jx0k/U1deAqYK3AXOZ5zcHt/cC4ZNTqYwWUW/EoL+b2hW/C4zoAQQ5CeMtbxX2zHjm+E4nX/Aww+FHUL6iuIMaeL2KLxqdtbHRC50vgC2YI7xohnb3KuCNBMUzLiPeNIpVdnYaeteCmSaESb+AZpJB9PExzTpRDzCRv+T6o5vlzaE8UgIneC1sYu85BnPBEMTSuj1ZZzfdQi7ZW992Z4dmJxn9e8FL2VArNm99f5Io3c2O4AcNsQENNKtfAAxVjCqc3mg5jF0nKabA+u/5vrUD76flX1UOF5fzJ0sApG2OEn9wfyPDRBsApn9o+fceF9hNrYBGsdtZrZYyGG387CGOtKsuj8e2E8SNp+Pn4E9oYejOTR+ZNLNi+twxaXVlJhr6l+RXYwEiMGQE9zGFBD6h2dOhKh3W84p1GEYnSRIz1+9/Hp66arjC7RCrhuW5OjCj4QFEQJiwgL45XryxHtiZ7JdAlPmjVsL03CxxFZarzxzffryrWUG3VkRdHRHbTsC34+ScoL5MTDU1QAWdqUC1T7xT0lCvQELaIhBTXAYrznJl6PlA83oqlMxpHh0gZBB1jFbfoUr7OQbBs1xqzpYK6Yjux6diwpQB1zlZErYJUfCqK7G/zI9yK/60b4HW0k3M+AvzMcw="
}
应用的服务端接收到加密事件后,需要进行解密处理,有关解密方法的详细介绍,请参见 事件加解密
配置 Token:
Token 用于计算签名,由英文或数字组成且长度为25位的字符串;由于企业开发者提供的 URL 公开可访问,掌握该 URL 的信息即可向该链接推送消息,因此 URL 服务需要解决以下两个问题:
如何分辨出回调消息是否为腾讯会议来源。
如何分辨出回调消息的内容是否被篡改。
解决方法:
通过数字签名可以解决上述问题,具体方式为:约定 Token 作为签名密钥,仅限企业开发者和腾讯会议可查看,且在传输中不可见,以此用于签名的计算。腾讯会议在推送消息时,将消息内容与 Token 计算出签名。企业开发者在接收到回调消息时,也按相同的算法计算出签名,如果签名一致,则可信任来源为腾讯会议,并且内容不被篡改。
如果非腾讯会议的回调,由于攻击者未提供正确的 Token,则无法计算出正确的签名。
如果消息内容被篡改,由于开发者将接收到的回调消息内容与 Token 重算一次签名,该值与回调参数的签名不一致,则拒绝该请求。
配置请求地址:此 URL 是开发者搭建的回调服务地址。
注意
1. 配置的 URL 不能为带3xx接口的地址(例如带重定向的请求地址)。
2. 配置的 URL 不能带参数。
3. 回调服务需满足接口要求,详情请参见 回调服务要求

步骤二:添加事件

配置完成基础信息后,才可以添加具体的事件类型(EVENT_TYPE),当事件发生时,开发平台会向应用推送事件信息,应用需要接收并处理事件,事件类型具体的接入文档参见:事件参考




步骤三:接收并处理事件

应用接收到开放平台推送的事件后,可以进行安全校验。如果是加密事件,需要先解密事件,再解析事件详情。有关解密方法的详细介绍,请参见 事件加解密