Python + 钉钉 实现消息通知

学习 Python 有段时间了，但总觉得欠缺点什么，想来想去还是缺少实战的演练，编程从来都不是纸上谈兵就能搞定的事情，必须从实践中提高自己的熟练度和水平。

刚好最近有个想法，需要定时从某个网站上爬取一些有用的信息，然后通过钉钉推送。

关于钉钉开放API 我们这里不做过多的讲述，想了解更多信息，可以 点击这里 跳转官网进行详细了解。

这里我们将整个过程分为三步：

1. 建立自己的钉钉消息接受群；
2. 申请机器人；
3. 通过Python 进行消息推送。

下面我们就这三部分别演示。

1. 建立消息群

在申请群之前首先要登录钉钉账号，然后建立自己的群聊，如下图所示。
建立群聊

建立群聊

选择群类型

选择群类型

然后一步步按照提示走下去即可。

2. 申请机器人

群申请成功之后，我们可以点击群右上角的设置按钮，进行机器人的申请和配置，如下图所示：

点击里面的 群智能助手 进行机器人的申请。

这里有很多机器人类型，我们选择自定义机器人。这里已经添加好了，就不再做演示，直接看机器人配置部分。

机器人配置主要看两部分，一个是访问地址及 Token 的获取，另一个是 安全设置，前者保证你能将消息准确发送到刚才新建的群里面，后者保证只有在满足你设定的拦截条件后消息才能发送到群里面。

前者的样式如下：

# xxx 代表具体的 token，每个群不一样
https://oapi.dingtalk.com/robot/send?access_token=xxx

钉钉通过三种方式保证消息的安全发送，即下图所示的关键字、加签及 IP 白名单

我们这里选择用第二种方式——加签，需要将上图中的 Webhook 地址 和 加签 的内容进行复制，等下第三步要用到。

3. 通过Python 进行消息推送

在官网上我们能够找到 Python 的部分示例代码。

#python 3.8
import time
import hmac
import hashlib
import base64
import urllib.parse

timestamp = str(round(time.time() * 1000))
secret = 'this is 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)

以上代码是加签过程，其中用到的 secret 就是我们在第二部复制的加签内容，而最终生成的 timestamp 及 sign 就是我们要拼接到 webhook 地址后面的内容。

要想成功发送消息到钉钉，加签只是其中一步，接下来就需要通过 Python 发送消息。我们提供完整的示例代码。

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


def send(msg):
    headers = {'Content-Type': 'application/json', "Charset": "UTF-8"}
# 这里替换为复制的完整 webhook 地址
    prefix = 'https://oapi.dingtalk.com/robot/send?access_token=xxx '
    timestamp = str(round(time.time() * 1000))
# 这里替换为自己复制过来的加签秘钥
    secret = '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))

    url = f'{prefix}×tamp={timestamp}&sign={sign}'

# 钉钉消息格式，其中 msg 就是我们要发送的具体内容
    data = {
        "at": {
            "isAtAll": False
        },
        "text": {
            "content": msg
        },
        "msgtype": "text"
    }

    return requests.post(url=url, data=json.dumps(data), headers=headers).text


send("我就是我，颜色不一样的火")

上述代码中，除了汉字备注的部分，其余可视为固定写法。

接下来，我们在 Python 环境中执行代代码，钉钉群里便可收到消息。

python3 dingding.py