第三方回调是云信一项基于客户需求开放的事件回调能力。简单来讲，就是由客户应用服务器干预事件处理的结果。例如在企业办公场景、接入第三方内容审核服务场景下，需要在发送方发送消息后，不直接投递给接收方，而是先由云信服务器向应用服务器发出 POST 请求到应用服务器，根据应用服务器返回的回调结果，决定是否放行。

本文介绍如何实现圈组消息/系统通知的第三方回调。

功能介绍

圈组支持包括登录圈组、消息发送、创建服务器、邀请服务器成员等多种事件类型的回调，具体类型请参见圈组第三方回调事件类型。

使用限制

以下两种情况，回调不会触发。

• 通过服务端 API 发送消息。
• 已启用安全通进行内容审核，且消息被检测出存在敏感内容。

前提条件

• 已开通和配置圈组功能。

• 已在云信控制台配置第三方回调地址，且已在子功能配置中配置需要回调的圈组事件类型，具体请参见配置第三方回调。

  您还可配置回调超时后的默认策略（放行或不放行），超时时间为 2 秒（开发者服务器需要在 2 秒内返回结果，否则按默认策略执行）。

实现方法

圈组的第三方回调需要通过服务端实现：

• 第三方回调的请求格式和响应说明，请参见第三方回调请求格式。
• 圈组各事件类型的第三方回调的请求示例，请参见圈组相关回调。

其他相关信息

• 如果设置了合法的自定义错误码responseCode，则发送方会收到自定义错误码，否则会收到默认的 403 错误码。
• 如果第三方回调不放行某消息，客户端 SDK 会返回{message: "sendMsg error: 非法操作或没有权限", code: responseCode}。
• 如果第三方回调的最终结果是放行该消息，且已开通抄送，那么会触发消息抄送。如果是不放行，则不会触发消息抄送。