背景需求
我想应该有一些人和我有一样的需求,比如需要自动推送消息到钉钉
我喜欢shell,是因为在Linux环境下,几乎可以完成所有的事儿,而且依赖问题几乎可以忽略不计(一些特殊环境除外
)。
所从这个角度出发,我大部分的代码都会优选Shell
,当shell无法完成时我才会借助第三方语言来辅助,比如:PHP
、Python
等
关于钉钉机器人
- 这里所讲的记得
钉钉机器人
是指钉钉群聊的自定义机器人
; - 本次介绍的不支持应答机制,当然如果自己创建钉钉应用是可以实现的;
- 更多关于
自定义机器人
请参考钉钉官方文档;
步骤开始
-
在钉钉群里添加
自定义机器人
- 找到需要添加机器人的群;
- 点击群会话框的右上角的齿轮→机器人→自定义机器人;
- 根据自己需求,填写机器人信息;
- 安全设置官方提供两种方式,人选其一,博主推荐加签方式;
-
webhook URL
就是你推送消息的地址,如果您和博主一样选择加签(即 sign)
方式,那么那一串key您也需要拷贝下来,更详细的加签方式请参考官方文档
-
脚本调试给钉钉机器人的
Webhook
推送消息 基本工作做的差不多了,就可以调试了脚本了,官方提供多种语言的加签方式,但是没有提供shell方式,所以如果您不是用shell的话可以参考官方文档,反之则可以直接使用博主的脚本。- 脚本分两步走,一是完成
加签(即 sign)
,二是推送消息 - 官方
加签
说明以及shell代码
## 时间戳 timestamp=$(date "+%s%3N") ## 机器人安全密钥 secret='SEC69418c80975b31e767844bcad1e1a2fc3b996ee58dc79ea3ad1331b23fae9f48' ## 生成 sign sign=$(echo -ne "${timestamp}\n${secret}" | openssl dgst -sha256 -hmac "${secret}" -binary | base64)
- 由于官方要求,最后得出的
sign串
需要进行url encode
,且shell本身没有这个函数,所以博主参考网上,整理一个function (不支持中文
)
## encode url function url_encode() { t="${1}" if [[ -n "${1}" && -n "${2}" ]];then if ! echo 'xX' | grep -q "${t}";then t='x' fi echo -n "${2}" | od -t d1 | awk -v a="${t}" '{for (i = 2; i <= NF; i++) {printf(($i>=48 && $i<=57) || ($i>=65 &&$i<=90) || ($i>=97 && $i<=122) ||$i==45 || $i==46 || $i==95 || $i==126 ?"%c" : "%%%02"a, $i)}}' else echo -e '$1 and $2 can not empty\n$1 ==> 'x' or 'X', x ==> lower, X ==> toupper.\n$2 ==> Strings need to url encode' fi } ## 调用 x ---> 小写 X ---> 大写 url_encode 'x|X' "${sign}"
- 推送消息
curl 'https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx' \ -H 'Content-Type: application/json' \ -d '{"msgtype": "text","text": {"content":"我就是我, 是不一样的烟火"}}'
- 脚本分两步走,一是完成
推送消息规则
- 支持
text
、Markdown
、link
等,更多请参考官方文档; - text 换行可以用
\n
; - 每分钟推送数量 <= 20 ,频繁推送会被
限流 10 分钟
;
完整脚本
- 仅供参考
#!/bin/bash
## 用于给钉钉机器人推送消息
## 钉钉机器人消息安全支持 关键词、sign 两种方式,人选其一
## 从灵活角度来设计,anYun 推荐使用 sign 方式
## 官方文档没有给 shell 案例,但 anYun 比较青睐于 shell,故而花点时间写了这个 demo
## By anYun Kunming 2023.06.06
## 钉钉机器人配置
dingrobot_secret='SECfe57f716c30ba2f248f0c9af33d961e9b68b5f7f0b1989950150a26e00414e35'
dingrobot_url='https://oapi.dingtalk.com/robot/send?access_token=76e62e363e68e9fe31517aae7f74c4222fb19c65f3745b39bab7c6e27ee4c3b8'
## secret_type keywords || sign
ding_secret_type='sign'
## 需要艾特的人的手机号码,以空格隔开
atMobiles=(13346732245 13346732475)
## encode url
function url_encode() {
t="${1}"
if [[ -n "${1}" && -n "${2}" ]];then
if ! echo 'xX' | grep -q "${t}";then
t='x'
fi
echo -n "${2}" | od -t d1 | awk -v a="${t}" '{for (i = 2; i <= NF; i++) {printf(($i>=48 && $i<=57) || ($i>=65 &&$i<=90) || ($i>=97 && $i<=122) ||$i==45 || $i==46 || $i==95 || $i==126 ?"%c" : "%%%02"a, $i)}}'
else
echo -e '$1 and $2 can not empty\n$1 ==> 'x' or 'X', x ==> lower, X ==> toupper.\n$2 ==> Strings need to url encode'
fi
}
## Dingrobot
function dingrobot(){
send_strs="${1}"
new_url="${dingrobot_url}"
at_who=''
for i in ${atMobiles[*]}
do
if [ -n "${at_who}" ];then
at_who="${at_who},\"${i}\""
else
at_who="\"${i}\""
fi
done
if [ "${ding_secret_type}" == 'keywords' ];then
curl -s -X POST -H 'Content-Type: application/json' "${new_url}" \
-d "{\"at\":{\"atMobiles\":[${at_who}]},\"msgtype\":\"text\",\"text\":{\"content\":\"${send_strs}\"}}"
elif [ "${ding_secret_type}" == 'sign' ];then
timestamp=$(date "+%s%3N")
dingrobot_sign=$(echo -ne "${timestamp}\n${dingrobot_secret}" | openssl dgst -sha256 -hmac "${dingrobot_secret}" -binary | base64)
dingrobot_sign=$(url_encode 'X' "${dingrobot_sign}")
post_url="${dingrobot_url}×tamp=${timestamp}&sign=${dingrobot_sign}"
curl -s -X POST -H 'Content-Type: application/json' "${post_url}" \
-d "{\"at\":{\"atMobiles\":[${at_who}]},\"msgtype\":\"text\",\"text\":{\"content\":\"${send_strs}\"}}"
else
echo "secret_type 未知,请检查配置"
fi
}
dingrobot "${1}"
还不快抢沙发