帮你快速理解、总结文档立即下载

回调配置

最近更新时间:2026-09-15 14:29:49
我的收藏
登录 即时通信 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. 在弹出的第三方回调配置对话框中,勾选所需的回调。
说明:
部分回调功能需前往控制台开启对应功能后才能触发,具体请参见 回调事件开启操作说明。
2026年10月1日起专业版开启发单聊消息之前回调和群内发言之前回调开关将产生费用,不需要的客户请于10月1日前关闭开关。详情见 公告。

3. 单击确定保存配置。

配置回调鉴权

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

Token=xxxxyyyy

RequestTime=1669872112

Sign=sha256(xxxxyyyy1669872112)=17773bc39a671d7b9aa835458704d2a6db81360a5940292b587d6d760d484061

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

回调事件开启操作说明

直播群成员在线状态回调

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



用户资料变更后回调

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




在线状态回调

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




后续操作

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