有奖捉虫:云通信与企业服务文档专题,速来> HOT
登录 即时通信 IM 控制台 ,单击目标应用卡片,在左侧导航栏选择回调配置,您可以根据实际业务需求配置回调 URL 以及启用哪些回调。

基础回调配置

配置回调 URL

1. 回调配置页面,单击回调 URL 配置区域的编辑


2. 在弹出的回调 URL 配置对话框中,输入回调 URL。
说明
新的回调地址在修改成功2分钟后生效。
回调 URL 必须以http://https://开头。
若您暂未申请域名,可直接配置 IP,例如http://123.123.123.123/imcallback
只能使用英文字母(a-z,不区分大小写)、数字(0-9)、以及 “-”(英文中的连接符,即中横线)。
不能使用空格及特殊字符,例如!、$、&、?等。
“-” 不能连续出现、不能单独注册,也不能放在开头和结尾。
域名长度不超过63个字符。
回调 URL中 IM 默认带80/443端口,更换回调 URL 时涉及端口变化,需避免更换前后的端口互为前缀,例如避免把 https://xxx:443 更改为 https://xxx:4433 或者 https://xxx 更改为 https://xxx:4433。
3. 单击确定保存配置。

配置事件回调

1. 回调配置页面,单击第三方回调配置区域的编辑
2. 在弹出的第三方回调配置对话框中,勾选所需的回调。



3. 单击确定保存配置。

配置回调鉴权

1. 回调URL配置页面,开启鉴权,配置鉴权 token,单击确定保存配置。
2. 开启鉴权后,App 后台接收的回调 URL 带有签名,开发者需要对签名做校验。并对 RequestTime 校验时效性,RequestTime 和当前时间相差超过1分钟即可认为是无效请求,以防止重放攻击。
签名示例:

Token=xxxxyyyy

RequestTime=1669872112

Sign=sha256(xxxxyyyy1669872112)=17773bc39a671d7b9aa835458704d2a6db81360a5940292b587d6d760d484061

回调URL=URL&Sign=17773bc39a671d7b9aa835458704d2a6db81360a5940292b587d6d760d484061&RequestTime=1669872112

下载 HTTPS 双向认证证书

配置回调 URL 后,您可以在控制台下载 HTTPS 双向认证证书供后续使用。
说明
您可以根据实际需求配置双向认证,具体配置方法参见 双向认证配置
1. 进入 控制台回调配置 页面,单击右上角回调 URL 配置区域的 HTTPS 双向认证证书下载


2. 在弹出的证书下载对话框中,单击下载


3. 保存证书文件。

后续操作

配置回调 URL 并启用相应的事件回调后,您可以参考 第三方回调 使用相应的回调功能,实时了解用户信息和操作。