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