OpenIM Chat Docs

Appearance

2026-07-13-01 adminx 违禁词治理 MVP（阶段1） ​

影响面 ​

  • 新增 adminx 违禁词治理接口（词条、策略、白名单、命中日志）。
  • 新增 OpenIM before 回调命令处理：
    • callbackBeforeSendSingleMsgCommand
    • callbackBeforeSendGroupMsgCommand
  • 发送前命中违禁词可拒绝发消息（按策略）。

动作等级 ​

  • 管理后台：建议改
  • OpenIM webhook 对接方：必须改（需确认回调命令与返回语义）
  • 普通客户端：可不改

接口清单 ​

新增（Active） ​

  • POST /adminx/sensitive_word/add
  • POST /adminx/sensitive_word/del
  • POST /adminx/sensitive_word/search
  • POST /adminx/sensitive_word/policy/set
  • POST /adminx/sensitive_word/policy/get
  • POST /adminx/sensitive_word/whitelist/add
  • POST /adminx/sensitive_word/whitelist/del
  • POST /adminx/sensitive_word/whitelist/search
  • POST /adminx/sensitive_word/hit/search

变更（Compatible） ​

  • POST /callback/open_im（command 扩展）
    • 新增 callbackBeforeSendSingleMsgCommand
    • 新增 callbackBeforeSendGroupMsgCommand

兼容性说明 ​

  • 旧命令行为保持不变。
  • 新命令仅在 OpenIM Server 配置开启对应 before hook 后生效。
  • before 回调命中拒绝时返回 nextCode=1 + errCode=20012。

前后端动作建议 ​

  • 管理后台接入 adminx 违禁词管理页（词条、策略、白名单、日志）。
  • 运维配置 webhooks：启用 beforeSendSingleMsg / beforeSendGroupMsg，并按业务设置 contentType 过滤。
  • 联调时重点验证：命中拦截、白名单放行、日志可追踪（operationID）。