钉钉作为目前最热门的办公软件,在工作中大多数时间都在与他打交道。今天和大家分享一下如何用Python向钉钉发送消息,最终达到每日自动向指定群中发送销售日报。
新建群机器人
首先打开群设置,点击智能群助手。
选择添加自定义机器人
然后根据提示添加一下信息,建议选择安全设置的前两项,这里加签的密钥需要保存一下,后面会用到。
点击完成后就会生成一个Webhook
地址,这个地址和密钥不要随便公布出来,放在外部网站上会存在安全隐患。
获取签名值
我们此时已经获取了密钥和Webhook
,先将密钥解析得到时间戳(timestamp)以及签名值(sign),代码如下。
import time
import hmac
import hashlib
import base64
import urllib.parsetimestamp = str(round(time.time() * 1000))
secret = '填入你的密钥'
secret_enc = secret.encode('utf-8')
string_to_sign = '{}\n{}'.format(timestamp, secret)
string_to_sign_enc = string_to_sign.encode('utf-8')
hmac_code = hmac.new(secret_enc, string_to_sign_enc, digestmod=hashlib.sha256).digest()
sign = urllib.parse.quote_plus(base64.b64encode(hmac_code))
print(timestamp)
print(sign)
timestamp,sign作为两个关键参数,把它们与Webhook
拼接。
https://oapi.dingtalk.com/robot/send?access_token=XXXXXX×tamp=XXX&sign=XXX
access_token参数的值在创建机器人时已经包含在Webhook
中,这里只需传入timestamp与sign的值即可得到完整的Webhook
。
钉钉消息类型
钉钉消息类型多种,可根据需要选择发送的消息类型。
官方文档:https://open.dingtalk.com/document/robots/custom-robot-access
我使用的是Markdown格式,目前只支持基础的Markdown语法,一开始以为是谦虚,亲测后发现确实不支持,HTML语法也仅仅支持很小一部分。
标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题引用
> A man who stands for nothing will fall for anything.文字加粗、斜体
**bold**
*italic*链接
[this is a link](http://name.com)图片
![](http://name.com/pic.jpg)无序列表
- item1
- item2有序列表
1. item1
2. item2
Python发送请求
整体代码并不复杂,代码如下。
import time
import hmac
import hashlib
import base64
import urllib.parse
import datetime
import jsontimestamp = str(round(time.time() * 1000))
secret = '填入你的密钥'
secret_enc = secret.encode('utf-8')
string_to_sign = '{}\n{}'.format(timestamp, secret)
string_to_sign_enc = string_to_sign.encode('utf-8')
hmac_code = hmac.new(secret_enc, string_to_sign_enc, digestmod=hashlib.sha256).digest()
sign = urllib.parse.quote_plus(base64.b64encode(hmac_code))
print(timestamp)
print(sign)url = f'https://oapi.dingtalk.com/robot/send?access_token=xxxx×tamp={timestamp}&sign={sign}'def send_request(url, datas):header = {"Content-Type": "application/json","Charset": "UTF-8"}sendData = json.dumps(datas)sendDatas = sendData.encode("utf-8")request = urllib.request.Request(url=url, data=sendDatas, headers=header)opener = urllib.request.urlopen(request)# 输出响应结果print(opener.read())def get_string():'''自己想要发送的内容,注意消息格式,如果选择markdown,字符串中应为包含Markdown格式的内容例:"<font color=#00ffff>昨日销售额:XXX</font> \n <font color=#00ffff>昨日销量:XXX</font>"'''return "- 测试1 - 测试2"def main():# isAtAll:是否@所有人,建议非必要别选,不然测试的时候很尴尬dict = {"msgtype": "markdown","markdown": {"title": "销售日报","text": ""},"at": {"isAtAll": False}}#把文案内容写入请求格式中dict["markdown"]["text"] = get_string()send_request(url, dict)main()
如果还有不清楚的地方,可以直接私信或参考官方文档。
https://open.dingtalk.com/document/robots/robot-overview