第三方回调功能
功能概述
第三方回调是云信一项基于客户需求开放的事件回调能力。简单来讲,就是由客户应用服务器干预事件处理的结果。例如在企业办公场景、接入第三方反垃圾服务场景下,客户需要在发送方发送消息时,不直接投递给接收方。而通过云信服务器向应用服务器发出请求,根据返回的回调结果,放行后方可投递。
第三方回调功能目前支持以下类型的事件回调:
- 单聊(点对点)消息回调
- 群聊消息回调
- 聊天室消息回调(仅专属云开放)
- 用户资料变更回调
- 好友关系变更回调
- 群组管理操作变更回调(仅专属云开放)
- 音视频通话回调
单聊/群聊/聊天室消息发送回调
用户发送消息时,不直接投递给接收方,而是先请求第三方服务器(通常为app的应用服务器),通过回调结果决定是否投递。app后台可以根据此功能监控用户的消息发送。包括:
- 记录所有用户的单聊消息,例如记录日志场景;
- 拦截部分用户的发言请求,例如在发言需要鉴权的场景;
- 消息发送反垃圾,例如在用户已接入第三方反垃圾服务的情况下。
单聊/群聊/聊天室消息发送回调的整体流程类似,以单聊消息为例:
注意事项:
- 要启用回调,首先需要在管理后台进行第三方回调配置。下文中有配置方法的介绍。
- 启用回调后,由于引入了回调消息发送的链路比不启用回调时更长,会影响消息发送的实时性。
- 回调的方向是由云信服务器向app应用服务器发起HTTP POST请求。
- 用户可以在管理后台配置回调超时时的默认策略,有默认放行和默认不放行两种方式。
- 聊天室消息第三方回调功能仅对专属云客户开放。
用户资料变更回调
用户调整自己的昵称、头像、签名、Email、生日、手机号、性别等信息时,云信将操作请求传递给第三方服务器,通过服务器的回调结果决定是否生效。应用服务器可以根据此功能监控并干预用户的修改资料行为。应用场景包括:
- 限制用户修改资料行为的场景
- 识别筛选异常用户的场景
回调流程可参考消息发送的回调流程。相关注意事项包括:
- 要启用回调,首先需要在管理后台进行第三方回调配置。下文中有配置方法的介绍。
- 启用回调后,由于引入了回调消息发送的链路比不启用回调时更长,会影响操作的实时性。
- 回调的方向是由云信服务器向app应用服务器发起HTTP POST请求。
- 用户可以在管理后台配置回调超时时的默认策略,有默认放行和默认不放行两种方式。
添加/删除好友回调
用户添加/删除好友时,云信将操作请求传递给第三方服务器,通过服务器的回调结果决定是否生效。应用服务器可以根据此功能监控并干预用户的增删好友行为。应用场景包括:
- 用户添加、删除好友需要扣费鉴权的场景
- 识别并避免异常用户恶意添加、删除好友的场景
- 统计用户增删好友的数量,识别并筛选活跃用户
回调流程可参考消息发送的回调流程。相关注意事项包括:
- 要启用回调,首先需要在管理后台进行第三方回调配置。下文中有配置方法的介绍。
- 启用回调后,由于引入了回调消息发送的链路比不启用回调时更长,会影响操作的实时性。
- 回调的方向是由云信服务器向app应用服务器发起HTTP POST请求。
- 用户可以在管理后台配置回调超时时的默认策略,有默认放行和默认不放行两种方式。
群组管理操作变更回调
用户执行群组管理操作时,云信将操作请求传递给第三方服务器,通过服务器的回调结果决定是否生效。应用服务器可以根据此功能监控并干预用户的群组管理行为。群组管理回调功能适用于高级群和超大群。仅对专属云客户开放。群组管理操作包含:
- 创建群
- 解散群
- 群邀请
- 退出群
- 增加群管理员
- 取消群管理员
- 转让群
- 踢人出群
- 更新群信息
- 更新群成员信息
- 更新其他群成员信息
- 禁言群成员
- 申请入群
回调流程可参考消息发送的回调流程。相关注意事项包括:
- 要启用回调,首先需要在管理后台进行第三方回调配置。下文中有配置方法的介绍。
- 启用回调后,由于引入了回调消息发送的链路比不启用回调时更长,会影响操作的实时性。
- 回调的方向是由云信服务器向app应用服务器发起HTTP POST请求。
- 用户可以在管理后台配置回调超时时的默认策略,有默认放行和默认不放行两种方式。
音视频通话回调
用户执行音视频通话时,云信将操作请求传递给第三方服务器,通过服务器的回调结果决定是否生效。应用服务器可以根据此功能监控并干预用户的音视频通话行为。具体操作包含:
- 发起音视频通话
- 创建多人音视频房间
回调流程可参考消息发送的回调流程。相关注意事项包括:
- 要启用回调,首先需要在管理后台进行第三方回调配置。下文中有配置方法的介绍。
- 启用回调后,由于引入了回调消息发送的链路比不启用回调时更长,会影响操作的实时性。
- 回调的方向是由云信服务器向app应用服务器发起HTTP POST请求。
- 用户可以在管理后台配置回调超时时的默认策略,有默认放行和默认不放行两种方式。
第三方回调配置
启用第三方回调,首先要在云信管理后台配置回调相关的信息。具体步骤如下:
- 登录网易云信控制台:http://app.netease.im/login
- 找到需要开通第三方回调的应用,在IM专业版或免费版的右侧点击功能配置按钮。
- 在页面中找到第三方回调的配置模块,如下图所示:
- 点击编辑按钮,填写第三方回调地址。
- 选择在回调超时的情况下的默认策略:放行或不放行。
- 点击确定按钮。
- 选择第三方回调的校验范围。
- 点击确定按钮。


此文档对你是否有帮助

