OpenIM Chat Docs

Appearance

2026-07-14-01 OpenIM before 违禁词拦截使用独立错误码 ​

影响面 ​

  • POST /callback/open_im 在 beforeSendSingleMsg / beforeSendGroupMsg 命中违禁词时，返回错误码由 20012 调整为 20016。
  • 20012 继续保留为通用 Forbidden 语义，不再承载违禁词专用语义。

动作等级 ​

  • OpenIM webhook 对接方：必须改（若依赖错误码分支）
  • 管理后台：可不改
  • 普通客户端：可不改

接口清单 ​

变更（Compatible） ​

  • POST /callback/open_im
    • command=callbackBeforeSendSingleMsgCommand 命中违禁词时 errCode=20016
    • command=callbackBeforeSendGroupMsgCommand 命中违禁词时 errCode=20016

兼容性说明 ​

  • nextCode=1 的拒绝语义保持不变。
  • errMsg/errDlt 仍为 sensitive word detected。
  • 仅将违禁词场景错误码收口为专用业务码，便于后续统计与扩展。

前后端动作建议 ​

  • OpenIM webhook 对接逻辑若按 errCode 分支，需将违禁词分支切换到 20016。
  • 监控与告警建议新增 20016 维度，替代历史 20012 的违禁词统计口径。