办公利器：用Python向钉钉发送消息

Posted 2022-10-16 Dream丶Killer

钉钉作为目前最热门的办公软件，在工作中大多数时间都在与他打交道。今天和大家分享一下如何用Python向钉钉发送消息，最终达到每日自动向指定群中发送销售日报。

新建群机器人

首先打开群设置，点击智能群助手。

选择添加自定义机器人

然后根据提示添加一下信息，建议选择安全设置的前两项，这里加签的密钥需要保存一下，后面会用到。

点击完成后就会生成一个Webhook地址，这个地址和密钥不要随便公布出来，放在外部网站上会存在安全隐患。

获取签名值

我们此时已经获取了密钥和Webhook，先将密钥解析得到时间戳(timestamp)以及签名值(sign)，代码如下。

import time
import hmac
import hashlib
import base64
import urllib.parse

timestamp = 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&timestamp=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 json

timestamp = 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&timestamp=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