Jenkins工具系列 —— 通过钉钉API 发送消息

文章目录

• • 钉钉环境搭建
  • [使用钉钉API接口 发送消息](#使用钉钉API接口 发送消息)
  • • 机器人安全设置使用自定义关键词
    • 机器人安全设置使用加签方式
  • 资料下载

---

钉钉环境搭建

在jenkins安装钉钉插件以及小机器人，这部分内容可参考：插件 钉钉发送消息

---

使用钉钉API接口 发送消息

机器人安全设置使用自定义关键词

在配置机器人的安全设置使用自定义关键词，这里设置关键词为Mib。

请求方式：POST

请求地址：https://oapi.dingtalk.com/robot/send

如果自定义机器人的安全设置使用的是自定义关键词，调用本接口发送消息时，发送消息需要包含关键词（这里需要包含Mib），示例为：

#shell运行命令
curl 'https://oapi.dingtalk.com/robot/send?access_token=XXXXXX' -H 'Content-Type: application/json; charset=utf-8' -d '{"msgtype": "text", "text": {"content": "Mib提交的代码已部署\n"}, "at": {"atMobiles": [xxxx],"isAtAll": false}}'

说明：

1、"access_token=XXXXXX" 字段表示自定义机器人调用接口的凭证。在机器人设置里字段Webhook。

2、命令中也可以使用环境变量，比如 "at": {"atMobiles": [$JOB_NAME],"isAtAll": false}}

机器人安全设置使用加签方式

请求方式：POST

请求地址：https://oapi.dingtalk.com/robot/send

如果自定义机器人的安全设置使用的是加签方式，调用本接口发送消息时，需要拼接timestamp和sign参数，示例为：

https://oapi.dingtalk.com/robot/send?access_token=XXXXXX\&timestamp=XXX\&sign=XXX

timestamp：开发者计算 sign 签名值时使用到的时间戳。

（开发者服务内当前系统时间戳，单位是毫秒，与请求调用时间误差不能超过1小时。）

sign：签名值。（密钥通过计算获得sign，密钥指的是机器人安全设置页面，加签一栏下面显示的SEC开头的字符串。）

将时间戳 timestamp 和密钥 secret 当做签名字符串，使用HmacSHA256算法计算签名，然后进行Base64 encode，最后再把签名参数再进行urlEncode，得到最终的签名（需要使用UTF-8字符集）。

#!/bin/sh
#shell运行命令
#从dingding.py获取timestamp和sign值
a=10
b=10

output=$(python3 /home/git/dingding.py)

read var1 var2 <<< "$output"

echo "第一个返回值是: $var1"
echo "第二个返回值是: $var2"

if [ "$a" == "$b" ];then
    url=$(printf "https://oapi.dingtalk.com/robot/send?access_token=xxxx&timestamp=%s&sign=%s" $var1 $var2)
    curl $url -H 'Content-Type: application/json; charset=utf-8' -d '{"msgtype":"text", "text": {"content": "代码已部署\n"}, "at": {"atMobiles": ["master"],"isAtAll": false}}'
else
    echo "no eq"
fi

---

资料下载

【Jenkins工具系列 python文件】 通过钉钉API 发送消息资源