钉钉群机器人如何配置关键词过滤才能正常发送消息

如果在钉钉群机器人中开启了关键词过滤安全设置，发送的消息内容里必须包含至少一个设定的关键词，否则接口会拦截请求并返回失败。

先说结论：关键词过滤是钉钉机器人的一种安全验证机制，开启后消息正文必须命中关键词才能送达。

适合：需要防止机器人被滥用或误发消息到无关群组的场景
先准备：确认机器人安全设置类型，记录已配置的关键词内容
验收：发送包含关键词的测试消息，确认接口返回成功且群内可见

快速处理思路

这个问题通常不是代码逻辑错误，而是安全策略匹配问题。先登录钉钉客户端检查机器人设置，再看代码里的消息内容。

1. 打开钉钉客户端，进入群设置查看机器人安全配置。

2. 确认是否勾选了“关键词过滤”，并记录具体关键词。

3. 修改发送代码，确保消息文本里含有该词，重新发送测试。

为什么会这样

钉钉开放平台为了降低机器人被恶意调用或消息泄露的风险，提供了多种安全设置，关键词过滤是其中一种。

当开启该选项后，钉钉服务器在收到 webhook 请求时，会先扫描消息内容。如果内容里没有匹配到预设的关键词，服务器会直接拒绝处理，不会将消息推送到群里。这是一种简单的白名单机制，目的是确保只有特定业务场景的消息才能通过该机器人发送。

分步处理

第一步：配置关键词安全设置（UI 操作）

如果尚未配置关键词或需要修改，请按以下步骤操作：

PC 端打开钉钉群聊窗口，点击右上角“设置”图标（齿轮或...）。
选择“智能助手”或“群机器人”。
找到目标自定义机器人，点击“编辑”。
在“安全设置”区域，勾选“关键词”选项。
在输入框中输入关键词（支持多个，每行一个或回车分隔），点击“完成”或“保存”。

第二步：构造并发送请求

检查你的代码中构造 JSON payload 的部分。确保 text 内容或 markdown 内容中包含了刚才记录的关键词。

以下是完整的请求示例，包含 curl 命令和 Python 代码：

1. Curl 命令示例

curl 'https://oapi.dingtalk.com/robot/send?access_token=YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
    "msgtype": "text",
    "text": {
        "content": "【报警】服务器 CPU 过高，请及时处理"
    }
}'

2. Python 代码示例

import requests
import json

url = "https://oapi.dingtalk.com/robot/send?access_token=YOUR_ACCESS_TOKEN"
headers = {'Content-Type': 'application/json'}
data = {
    "msgtype": "text",
    "text": {
        "content": "【报警】服务器 CPU 过高，请及时处理"
    }
}

response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.text)

假设关键词是“报警”，那么上面的内容可以发送。如果关键词是“通知”，则会被拦截。

第三步：调整关键词策略（可选）

如果业务消息内容不固定，难以包含特定关键词，可以考虑在钉钉后台关闭关键词过滤，改用