钉钉机器人如何实现定时发送日报提醒

文章导读
先确认日报数据从哪里来、发到哪里去,再决定用哪种方式定时触发。如果日报需要从数据库查询或内网系统获取,那定时任务必须运行在能访问这些资源的环境中,比如公司内部服务器;如果只是把一段已有文本按点推送到钉钉群,则可以用任意支持定时触发的服务。另一个判断点是你期望的发送频率:每天一次就够,还是需要每个工作日?cron表达式能精确到分钟,而有些云平台的最低粒度是小时,选错会导致任务无法按预期执行。这两类环
📋 目录
  1. A 钉钉自定义机器人的配置要点
  2. B 定时任务脚本的落地写法
  3. C 执行结果如何验证
  4. D 容易忽略的边界问题
A A

先确认日报数据从哪里来、发到哪里去,再决定用哪种方式定时触发。如果日报需要从数据库查询或内网系统获取,那定时任务必须运行在能访问这些资源的环境中,比如公司内部服务器;如果只是把一段已有文本按点推送到钉钉群,则可以用任意支持定时触发的服务。另一个判断点是你期望的发送频率:每天一次就够,还是需要每个工作日?cron表达式能精确到分钟,而有些云平台的最低粒度是小时,选错会导致任务无法按预期执行。这两类环境下的排障路径不同:自建服务器出问题可以直接看系统日志和进程状态,云平台则需要先确认调度是否被触发,再看脚本本身能否独立跑通。

钉钉自定义机器人的配置要点

创建钉钉自定义机器人时,安全设置建议选择加签,而不是仅依赖自定义关键词。关键词的局限性在于你无法保证日报内容每次都会包含那个词,一旦漏掉消息就会被跳过。加签的流程是:复制机器人webhook地址,在脚本中构造timestamp和sign参数。sign值用秘密密钥加上时间戳做HMAC-SHA256运算,再对二进制结果做URL编码。请求时将这两个参数拼接到webhook后面。这样即使webhook地址泄露,没有密钥的人也无法发送消息。

这里要看你的钉钉版本是否支持加签。多数新创建的机器人默认开放加签选项,但仍建议在机器人管理页面确认一次。如果团队内已经有旧的只校验关键词的机器人,可以先新建一个测试机器人验证加签逻辑,不必马上改生产配置。加签日常不会增加延迟,反而让消息内容不再受关键词约束,日报里的标题、摘要、数值变化都可以自由组织。

定时任务脚本的落地写法

一个简单的实现是写Python脚本,在crontab中注册每日定时任务。脚本里先读取或生成日报文本,然后构造一个包含msgtype和text字段的字典,用requests库的post方法发送到webhook。requests.post时设置timeout参数,避免网络卡死导致脚本一直挂着。crontab中要用绝对路径调用python解释器和脚本文件,并重定向标准输出和错误到一个日志目录。这样脚本执行的任何异常都能被记录,方便排查。

实际的crontab配置可以写成:

30 9 * * * /usr/bin/python3 /opt/daily-report/send_report.py >> /var/log/daily-report.log 2>&1
这条表示每个工作日上午9点30分执行。如果只需要工作日发送,第五个字段用1-5排除周末:30 9 * * 1-5。cron本身不感知节假日,遇到法定调休就需要在脚本里额外判断。

钉钉机器人如何实现定时发送日报提醒

脚本里生成消息体时要注意字符编码。钉钉要求UTF-8编码,从数据库或Excel读取日报内容后,建议先强制解码为UTF-8再拼JSON。requests库在发送时会自动处理编码,但本地文件读写时容易因编码不一致出现乱码。

执行结果如何验证

定时任务跑完后,是否真的发出去了,最直观的是看钉钉返回的HTTP响应体。正常返回的JSON里有一个errcode字段,值为0表示成功。如果返回非0,就去钉钉开放平台的错误码表里查对应含义。常见的一种是签名不匹配,另一种是请求频率超限。另外,建议在脚本里把每次发送的时间、返回内容写入本地日志。这样即使任务在深夜执行,第二天也能快速确认是否成功,不用依赖钉钉群里的消息记录。

日志可以这样写:

def send_msg(webhook, data):
    resp = requests.post(webhook, json=data, timeout=10)
    log.write(f"{datetime.now()} status={resp.status_code} body={resp.text}\n")
    return resp.json()
日志里保留返回的JSON原始文本,排错时比只记一个成功或失败更有效。如果返回errcode: 310000,表示签名错误,要检查tomestamp与服务器时间是否偏差过大;如果返回errcode: 45009,表示触发频控,需要拉长发送间隔。

钉钉机器人如何实现定时发送日报提醒

容易忽略的边界问题

一个容易踩的坑是消息文本拼接出错。日报内容往往含换行和引号,直接用字符串拼接搭建JSON很容易解析失败。稳妥的做法是用编程语言自带的字典或对象构造数据,再序列化成JSON字符串。另外,钉钉机器人对单条消息的长度有限制,把整个日报全文塞进一条text消息很可能被截断或拒绝。此时建议用markdown格式做摘要,或把日报拆成多条。如果你的服务器通过代理访问外网,别忘了在请求库中配置代理,否则会一直超时。

消息长度限制需要结合钉钉版本确认。通常text类型消息不超过5000字符,markdown消息也类似。如果日报表格较长,可以考虑用markdown表格摘录核心指标,完整内容放到内部Wiki或文件存储,在消息里附链接。这样既保证可读性,也降低被截断的概率。

Webhook地址本质是一个公开的接口入口,任何人拿到它都能往群里发消息。所以不要把webhook硬编码在脚本里再提交到公开仓库,也别在日志中完整打印。启用加签后即使地址泄露,没有密钥仍然无法使用;如果只用了关键词校验,就要求每条消息必须包含设定的关键词,这会给内容格式增加约束。此外,钉钉会对同一机器人做频率限制,发送过于频繁会触发临时封禁。因此设计定时任务时要控制发送频率,比如每天仅一次,不要循环重试同一消息。

最后检查一遍:脚本在服务器上能否手动执行通过;cron的时间与服务器时区是否一致;机器人是否还在群里;webhook密钥有没有被误放到git仓库。这些点都确认后,定时发送日报这件事才算真正闭环。如果哪天群里没收到消息,先看本地日志里有没有请求记录,再确认钉钉是否返回了错误码,不要直接重发任务,避免触发频控。