先别急着写代码。很多需求看起来是“机器人自动回复关键词”,但真到做的时候,第一步往往不是实现逻辑,而是确认该用哪种机器人。我处理这类需求时,会先问自己一个问题:机器人需要听到群里说了什么,还是只需要按固定时间发一段文字?这两种场景在钉钉上的入口完全不同。
在动手搭建之前,先确认你需要的到底是哪一种机器人。钉钉自定义机器人只提供 Webhook 发消息能力,不能接收群里的聊天内容;一旦涉及“群里有人发关键词,机器人自动回复”,就必须使用企业内部应用里的机器人,并开启消息接收功能。判断方法很简单:如果你的需求只是定时推送通知,自定义机器人就够了;如果要求机器人对群消息做出响应,就需要走企业应用的创建流程。
所以,如果需要的是自动回复,后面就按企业内部应用这一条路来走。下面说的内容,都是围绕这个前提展开的。
创建企业内部应用,用 Stream 模式接收消息
确定走企业应用后,创建流程不复杂,但消息接收方式建议直接用 Stream 模式。
创建企业内部应用后,在“机器人”页面添加机器人,并选择 Stream 模式作为消息接收方式,这样可以省去公网回调地址的配置。拿到 AppKey 和 AppSecret 后,在服务端接入钉钉开放平台的 Stream Client,订阅机器人消息事件。当收到群消息事件时,解析出 text 内容和群会话 ID,判断是否包含预设关键词,若包含则调用机器人发送消息接口把回复发回同一个群。
Stream 模式等于让钉钉主动把消息流推给你的程序,不用自己准备一台带公网地址的服务器来接收回调。对一个人维护的小应用来说,省掉配置 HTTPS 和域名验证的环节。不过运行环境需要能访问钉钉的流式服务,这个到后面调试时再确认。
关键词匹配用“包含”,别被大小写和空格坑到
关键词匹配建议用“包含”而不是“完全相等”,因为群成员可能在关键词前后加语气词或标点。比如预设关键词是“加班”,那么“谁在加班”“今天加班吗”都应当触发回复。但在代码里要直接判断 `text.includes("加班")`,不要用正则写成精确匹配,否则漏掉场景。同时要处理好大小写和空格:英文关键词先 trim 再比较,中文一般不受影响。
实际开发时,我会先把消息文本 trim 一下,再判断是否包含关键词。比如在 Node.js 服务里,大致是这样:
const text = (event.text.content || '').trim();
const keyword = '加班';
if (text.includes(keyword)) {
// 调用机器人发送消息接口,回复到同一个群
}
这里需要注意,`includes` 是区分大小写的。如果关键词是英文,比如“report”,那么“Report”不会触发。可以在比较前把两边都转成小写:`text.toLowerCase().includes(keyword.toLowerCase())`。另外,群成员可能输入全角空格,建议对英文关键词先做 trim,中文关键词一般不受影响。
自动回复必须设置触发边界,否则会成死循环
自动回复必须设置触发边界,否则容易出现两个问题:一是机器人收到自己发的消息后再次触发,形成死循环;二是机器人对无关消息过度响应,打扰群里日常聊天。因此收到消息事件后,先判断消息发送者是否为机器人自身(通过发送者 ID 比对),相同则直接丢弃。另外建议只在 `msgtype` 为 text 的消息上做判断,图片、链接类型的消息一律不处理。
判断发送者是不是机器人自己,可以从消息事件里读出 senderId,跟机器人自己的 ID 比对。机器人自己的 ID 在机器人创建页面能看到,也可以在连接成功后的信息里拿到。我还会额外做一个双保险:让预设回复的内容里不要包含触发词。比如关键词是“加班”,回复句子里就不写“加班”这两个字,这样即使 senderId 判断漏了,也能减少再次触发的可能。
权限和网络是调试时最常遇到的两个卡点
代码逻辑看着没问题,但机器人就是不触发,这种情况我通常先查两处。第一处是权限:企业内部应用创建后,默认没有任何消息权限。就算代码写完了,钉钉也不会把群消息推给应用。需要到开发者后台的权限管理里,申请“机器人发送消息”和“群消息接收”这两项权限,并等管理员审批。第二处是网络:Stream 模式需要服务端向外连接钉钉的流式服务,如果服务器出站端口被防火墙限制,连接会一直失败。调试时先看日志里的连接状态,再检查服务器能否访问外网。
如果怀疑是出网受限,可以在服务器上跑一个简单的 HTTPS 请求测试,比如 curl -I https://api.dingtalk.com,能返回状态码就说明基本出网没问题。但要注意,这只能确认网络可达,不能替代 Stream 日志的判断。
用日志确认整条链路是否生效
不要一上来就去群里刷消息。我习惯先把服务跑起来,开着日志,分三步确认。
- 确认 Stream 客户端已连上:日志里出现连接成功的标记,没有反复重连的报错。
- 用另一个测试账号往群里发一条包含关键词的文本消息,看日志里是否收到消息事件。如果没收到,优先检查权限和订阅。
- 确认机器人回复后,同一个群能正常显示,同时日志里没有发送接口报错。
这套检查做完,基本就能定位问题在最前面哪一段。记住一点:自动回复这类功能,上线前一定要先在一个小范围群里跑通,再考虑投到更多群。不然一个死循环或者误回复,造成的打扰比不回复还麻烦。