钉钉群机器人的“关键词”是安全验证机制而非内容过滤工具，消息必须包含设定的关键词才能发送成功，避免拦截的关键是确保 payload 中包含该词或改用签名验证。
先说结论：关键词设置是白名单验证，消息里没写这个词就会被拦截，想解决要么加词要么换签名验证。
- 先确认：登录钉钉开放平台查看机器人安全设置类型
- 再调整：代码里拼接关键词或切换为加签模式
- 后验证：发送测试消息确认返回码为 0
快速处理思路
这个问题通常不是“过滤配置”错了，而是安全验证没通过。如果是关键词模式，消息体 text 字段必须完整包含设定的关键词；如果是内容被风控拦截，则没有配置项可改，只能修改文案。
\u007b\n \"msgtype\": \"text\",\n \"text\": \n \"content\": \"【报警】服务器 CPU 过高\"\n \n\u007d上面示例中，如果后台关键词设的是“报警”，消息就能发出去；如果设的是“通知”，这条消息就会被拦截。
为什么会这样
钉钉群机器人 webhook 接口设计了三种安全设置：IP 白名单、关键词、加签。选择“关键词”后，服务端会校验接收到的消息内容是否包含该词，不包含则直接拒绝，返回拦截提示。这不是用来过滤垃圾消息的功能，而是防止机器人被滥用的身份验证手段。另外，钉钉平台本身有内容风控机制，涉及敏感词的消息无论配置如何都会被拦截，这部分用户无法配置。
分步处理
1. 确认安全设置类型
登录钉钉开放平台后台，找到对应的群机器人配置页面。查看“安全设置”一栏，确认当前选中的是“关键词”还是“加签”。如果是“关键词”，记下具体设置的词。
2. 修改发送代码
如果必须保留关键词模式，检查代码中发送消息的 content 字段，确保字符串里完整包含后台设置的关键词。注意大小写和空格必须完全一致。
3. 切换验证方式（推荐）
关键词模式容易因文案变动导致发送失败。建议在后台改为“加签”模式，代码里根据时间戳和密钥计算 signature 参数。这种方式不依赖消息内容，更稳定。
4. 排查内容风控
如果安全设置都通过了但还是发不出去，检查文案是否包含敏感词。公开资料中没有看到可靠的量化数据说明哪些词会被拦，通常涉及政治、黄赌毒或营销广告词会被系统自动拦截，这种情况只能换文案。
怎么验证是否生效
发送请求后，检查 HTTP 响应状态码和返回 body。成功时状态码为 200，body 中 errcode 为 0。如果 errcode 非 0，查看 errmsg 提示。常见错误码会明确提示“关键词不匹配”或“消息内容违规”。
\u007b\n \"errcode\": 0,\n \"errmsg\": \"ok\",\n \"messageId\": \"...\"\n\u007d如果返回提示拦截，根据错误信息调整关键词或文案后重试。
常见坑
1. 关键词更新不同步
后台修改关键词后，代码里没跟着改，导致旧消息发不出去。建议加签模式，避免维护关键词。
2. 部分匹配无效
关键词必须连续完整出现在消息内容中。设的是“服务器”，消息里写“服 务 器”会被拦。
3. 误以为能过滤敏感词
机器人配置里的关键词不能用来过滤平台风控。如果消息本身违规，配什么关键词都会被钉钉服务端拦截。
4. 频率限制
每个机器人每分钟最多发送 20 条消息。超过限制会被临时拦截，这不是关键词问题，需要代码里做限流处理。
参考来源
- 钉钉开放平台，群机器人接入文档，https://open.dingtalk.com/document/robots/custom-robot-access