回调配置

最近更新时间:2025-07-09 10:47:42

我的收藏
登录 即时通信 IM 控制台 ,单击目标应用卡片,在左侧导航栏选择回调配置,您可以根据实际业务需求配置回调 URL 以及启用哪些回调。

基础回调配置

配置回调 URL

1. 在控制台左侧导航栏选择回调配置,单击编辑

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. 输入回调 URL 后,单击校验即可进行回调地址 URL 校验。

若地址错误,输入框下方会显示 URL地址错误,您可单击详情,查看校验错误详情


若地址正确,回调URL 输入框后方会显示检验通过的绿色图标,表明可正常接收回调。

4. 单击确定保存配置。

配置事件回调

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

回调事件开启操作说明

1、直播群成员在线状态回调
若需要开启直播群成员在线状态回调,需首先在功能配置里打开群成员在线状态开关。


2、用户资料变更后回调
若需要开启用户资料变更后回调,需首先在功能配置里打开用户资料变更订阅开关。



3、在线状态回调
若需要开启在线状态回调,需首先在功能配置里打开用户状态查询及状态变更通知配置开关。





后续操作

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