IM 即时通讯
Android
开发指南

圈组第三方回调

更新时间: 2023/06/29 11:32:50

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

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

功能介绍

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

使用限制

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

前提条件

  • 开通圈组功能

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

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

实现方法

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

其他相关信息

  • 如果设置了合法的自定义错误码responseCode,则发送方会收到自定义错误码,否则会收到默认的 403 错误码。
  • 如果第三方回调不放行某消息,客户端 SDK 会返回{message: "sendMsg error: 非法操作或没有权限", code: responseCode}
  • 如果第三方回调的最终结果是放行该消息,且已开通抄送,那么会触发消息抄送。如果是不放行,则不会触发消息抄送。
此文档是否对你有帮助?
有帮助
去反馈
  • 功能介绍
  • 使用限制
  • 前提条件
  • 实现方法
  • 其他相关信息