背景需求

我想应该有一些人和我有一样的需求,比如需要自动推送消息到钉钉 2023-06-04T11:43:25.png

我喜欢shell,是因为在Linux环境下,几乎可以完成所有的事儿,而且依赖问题几乎可以忽略不计(一些特殊环境除外)。 所从这个角度出发,我大部分的代码都会优选Shell,当shell无法完成时我才会借助第三方语言来辅助,比如:PHPPython


关于钉钉机器人

  • 这里所讲的记得钉钉机器人是指钉钉群聊的自定义机器人
  • 本次介绍的不支持应答机制,当然如果自己创建钉钉应用是可以实现的;
  • 更多关于自定义机器人请参考钉钉官方文档

步骤开始

  • 在钉钉群里添加自定义机器人

    • 找到需要添加机器人的群;
    • 点击群会话框的右上角的齿轮→机器人→自定义机器人;
    • 根据自己需求,填写机器人信息;
    • 安全设置官方提供两种方式,人选其一,博主推荐加签方式;
    • webhook URL就是你推送消息的地址,如果您和博主一样选择加签(即 sign)方式,那么那一串key您也需要拷贝下来,更详细的加签方式请参考官方文档 2023-06-04T11:58:26.png
  • 脚本调试给钉钉机器人的Webhook推送消息 基本工作做的差不多了,就可以调试了脚本了,官方提供多种语言的加签方式,但是没有提供shell方式,所以如果您不是用shell的话可以参考官方文档,反之则可以直接使用博主的脚本。

    • 脚本分两步走,一是完成加签(即 sign),二是推送消息
    • 官方加签说明以及shell代码 2023-06-04T12:06:42.png
    ## 时间戳
    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":"我就是我, 是不一样的烟火"}}'
    

    2023-06-04T12:42:38.png


推送消息规则

  • 支持textMarkdownlink 等,更多请参考官方文档
  • 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}"

「 希望熬过一切,星光璀璨 」

流年小站,感谢有您的支持

「 道路坎坷,感谢有您 ---来自 anYun 的感谢 」

使用微信扫描二维码完成支付

2023-06-06
已阅:18852 人/次

 
 
 
分享是一种美德 x
打开微信,右上角的"+"选择"扫一扫"
使用“扫一扫”将博文分享至朋友圈吧

本文由 anYun 创作,采用 知识共享署名 3.0,可自由转载、引用,但需署名作者且注明文章出处。
我的博客即将同步至腾讯云开发者社区,邀请大家一同入驻:https://cloud.tencent.com/developer/support-plan?invite_code=3oibnoh9lo6cs

还不快抢沙发

添加新评论

Myssl安全认证