跳到主要内容

版本:5.X

敏感信息拦截回调

注意

Web 端 SDK 从 5.0.2 版本开始支持敏感信息拦截回调。

如果您使用了融云的内容审核服务(包括消息敏感词、IM 审核服务、消息回调服务),可能希望在消息因触发审核规则而无法下发时通知消息发送方。从 SDK 5.0.2 版本开始,客户端 SDK 可以在消息被拦截时触发回调,通知消息发送方。

消息因包含敏感信息被拦截可分为以下情况

  • 文本消息内容命中了融云内置的消息敏感词,导致消息不下发给接收方。
  • 文本消息内容命中了您自定义的消息敏感词,导致消息不下发给接收方。
  • 消息命中了 IM 审核服务,或消息回调服务设置的审核规则,导致消息不下发给接收方。

开通服务

您可以在融云控制台,通过应用配置>IM 服务>免费基础功能>安全,开启含敏感词消息屏蔽状态回调发送端

设置敏感信息拦截监听器

您可以通过下面的方法设置敏感词拦截监听器,监听到被拦截的消息以及拦截原因。

const listener = (blockedMessageInfo) => {
console.log('消息含有敏感信息被拦截:', blockedMessageInfo)
}

RongIMLib.addEventListener(RongIMLib.Events.MESSAGE_BLOCKED, listener)

移除监听方法及全部事件列表,详见 IMLib 文档 事件监听

返回值说明

参数类型说明
blockedMessageInfoIBlockedMessageInfo含敏感信息的消息被拦截的回调参数
  • IBlockedMessageInfo 说明

    属性名称说明
    blockType获取消息被拦截的原因,详见下方 MessageBlockType 说明
    blockedMessageUId被拦截消息的唯一 ID。
    channelId被拦截消息所在会话的频道 ID(仅适用于会话类型为超级群的消息)。
    conversationType被拦截消息所在会话的会话类型。
    extra被拦截消息的附加信息。Web SDK 从 5.3.3 版本开始支持该参数。
    targetId被拦截消息的所在会话的会话 ID。
    sourceType被拦截消息源触发类型,详见下方 MessageBlockSourceType 说明。(仅超级群)
    sourceContent被拦截消息源内容对象。sourceType 字段为 1 时表示扩展内容,sourceType 为 2 时表示消息内容。(仅超级群)
  • MessageBlockType 说明

    枚举值数值说明
    GLOBAL1全局敏感词:命中了融云内置的全局敏感词
    CUSTOM2自定义敏感词拦截:命中了客户在融云自定义的敏感词
    THIRD_PARTY3第三方审核拦截:命中了第三方(数美)或消息回调服务(原模板路由服务)决定不下发的状态
  • MessageBlockSourceType 说明

    枚举值数值说明
    MSG_ORIGINAL0原始消息
    MSG_EXPANSION1消息扩展
    MSG_MODIFY2消息修改