无 UI 集成方案

服务端 API

有奖征文|投稿上云技术实践,赢取价值5000元大奖> HOT

若您希望对即时通信 IM 系统中的用户资料、群组资料、单聊消息、群聊消息等内容进行内容安全审核,针对不安全、不适宜的消息内容进行自动识别、处理。推荐您使用即时通信 IM 的内容回调,并自行接入第三方内容安全产品(目前仅支持 腾讯云内容安全产品),为您的产品体验和业务安全保驾护航。

注意:

“内容回调”与“发消息前回调”不同:

  1. “内容回调”比“发消息前回调”覆盖的审核场景更多。“内容回调”不仅支持单聊、群聊场景,还支持资料、关系链、群资料、群成员资料等场景;
  2. “内容回调”比“发消息前回调”的延迟更低。“内容回调”通过直接对接第三方内容安全平台(目前仅支持 腾讯云内容安全产品)的方式,可针对图文同步审核,大大缩短了接入流程,无需额外开发,而且延迟更低。

实现流程

“内容回调”实现流程:
由客户端发起的消息,通过 IM SDK 发送至 IM 后台,同时通过内容回调,将消息内容抄送至第三方内容安全服务,进行判断,将判断结果告知 IM 后台是否下发。如下图所示:

相比于“发消息前回调”(如下图所示),“内容回调”的实现流程更短,接入更便捷,延迟更低。

注意:

  1. 文本同步审核,拦截后会向 SDK 返回80001的错误码,450ms超时。
  2. 图片默认异步审核,拦截后会封禁文件,后续下载不到违规文件,但图片可以配置 URL 时支持同步审核,拦截后会向 SDK 返回80004的错误码,2s超时。
  3. 音视频异步审核,拦截后会封禁文件,后续下载不到违规文件。

实践效果(举例)

快速接入

步骤1:获取内容回调 URL 和 Token

从第三方内容安全产品(目前仅支持 腾讯云内容安全产品)获取内容回调 URL和 Token。

步骤2:进行内容回调配置

根据您业务诉求,将从第三方内容安全产品(目前仅支持 腾讯云内容安全产品)获取的内容回调 URL 和 Token 填写至 即时通信 IM 控制台。详细步骤如下:

  1. 进入 即时通信 IM 控制台 > 回调配置 > 内容回调配置,单击页面内模块右上角的“编辑”。
  2. 在“编辑”弹窗中,填入从第三方内容安全产品处获取的内容回调 URL 和 Token,并勾选需要生效的回调内容类型,单击确定
    注意:

    同一内容回调 URL 和 Token,可填写至多个 IM 应用的多个内容回调配置模块内。

  3. 查看回调配置和已生效回调内容类型/回调字段。

步骤3:配置内容回调结果

如果您想对“返回内容回调结果”、“下发拦截错误码”做进一步配置,请参见 内容回调配置文档

常见问题

什么场景下选择“内容回调”,而不是“发消息前回调”?

如果您有内容审核需求,请选择“内容回调”。
相比于“发消息前回调”,“内容回调”不仅覆盖了需要审核内容的全场景,还通过直接对接第三方内容安全产品的方式,避免了额外开发量,降低了消息发送时延。

怎么配置图片的同步审核?

在 URL 的配置中添加 URL 参数SyncImage,即 URL 添加一个 &SyncImage 的后缀就可以支持图片同步送审了。

目录