圈组第三方回调
更新时间: 2024/03/14 17:08:38
第三方回调是云信一项基于客户需求开放的事件回调能力。简单来讲,就是由客户应用服务器干预事件处理的结果。例如在企业办公场景、接入第三方内容审核服务场景下,需要在发送方发送消息后,不直接投递给接收方,而是先由云信服务器向应用服务器发出 POST 请求到应用服务器,根据应用服务器返回的回调结果,决定是否放行。
本文介绍如何实现圈组消息/系统通知的第三方回调。
功能介绍
圈组支持包括登录圈组、消息发送、创建服务器、邀请服务器成员等多种事件类型的回调,具体类型请参见圈组第三方回调事件类型。
使用限制
以下两种情况,回调不会触发。
- 通过服务端 API 发送消息。
- 已启用安全通进行内容审核,且消息被检测出存在敏感内容。
前提条件
-
已开通圈组功能。
-
已在云信控制台配置第三方回调地址,且已在子功能配置中配置需要回调的圈组事件类型,具体请参见配置第三方回调。
您还可配置回调超时后的默认策略(放行或不放行),超时时间为 2 秒(开发者服务器需要在 2 秒内返回结果,否则按默认策略执行)。
实现方法
圈组的第三方回调需要通过服务端实现:
其他相关信息
- 如果设置了合法的自定义错误码
responseCode
,则发送方会收到自定义错误码,否则会收到默认的 403 错误码。 - 如果第三方回调不放行某消息,客户端 SDK 会返回
{message: "sendMsg error: 非法操作或没有权限", code: responseCode}
。 - 如果第三方回调的最终结果是放行该消息,且已开通抄送,那么会触发消息抄送。如果是不放行,则不会触发消息抄送。
此文档是否对你有帮助?