<think>根据用户需求，用户想要使用Python3通过钉钉小程序发送钉钉消息。但根据提供的引用内容，实际上并没有直接提到“钉钉小程序”发送消息，而是提到了钉钉机器人的方式。在引用[1]和引用[3]中，都是通过钉钉机器人来实现消息发送的。 用户可能混淆了“钉钉小程序”和“钉钉机器人”的概念。钉钉小程序通常是指在钉钉内部运行的轻应用，而发送消息的功能一般通过钉钉机器人来实现。因此，我将按照钉钉机器人的方式回答。 根据引用[3]提供的代码，我们可以使用钉钉自定义机器人发送消息。步骤如下： 1. 创建钉钉机器人：在钉钉群中添加一个自定义机器人，获取其Webhook地址和加签密钥（如果有）。 2. 使用Python代码计算签名（如果使用加签安全设置）。 3. 构造请求，发送消息。 注意：引用[3]中的代码示例是用于发送文字消息的，并且使用了加签的方式（因为钉钉机器人现在要求必须设置安全设置，加签或IP白名单）。 下面我将提供完整的代码示例，并解释每一步。 ### 步骤1：创建钉钉机器人 在钉钉群中，点击右上角的群设置，然后选择“智能群助手”->“添加机器人”->“自定义机器人”。设置机器人名字，并选择安全设置（推荐使用“加签”）。记录下生成的Webhook URL和加签的secret。 ### 步骤2：编写Python代码 以下代码基于引用[3]中的代码，并进行了完善和注释，用于发送文本消息。 ```python import time import hmac import hashlib import base64 import urllib.parse import requests import json def send_dingding_message(content, webhook, secret): """ 使用钉钉机器人发送文本消息 :param content: 要发送的文本内容 :param webhook: 机器人的webhook地址 :param secret: 机器人的加签密钥 """ # 获取当前时间戳（毫秒） timestamp = str(round(time.time() * 1000)) # 对时间戳和密钥进行加签 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)) # 构建完整的webhook URL（包括时间戳和签名） webhook_url = "{}×tamp={}&sign={}".format(webhook, timestamp, sign) # 构造请求头 headers = { 'Content-Type': 'application/json' } # 构造消息体 data = { "msgtype": "text", "text": { "content": content } } # 发送请求 response = requests.post(webhook_url, headers=headers, data=json.dumps(data)) return response.json() # 替换为你的机器人的webhook和secret webhook = "https://oapi.dingtalk.com/robot/send?access_token=your_token" secret = "your_secret" # 发送消息 result = send_dingding_message("这是一条测试消息", webhook, secret) print(result) ``` ### 代码说明： 1. **时间戳**：获取当前时间戳（毫秒）。 2. **加签计算**：使用密钥对时间戳进行HMAC-SHA256加密，然后进行Base64编码和URL编码，得到签名。 3. **构建URL**：将时间戳和签名作为参数附加到原始的Webhook URL后面。 4. **发送请求**：构造一个POST请求，消息体为JSON格式，指定消息类型为文本，并包含内容。 ### 注意事项： - 如果机器人没有设置加签，而是设置了IP白名单，则不需要计算签名，直接使用原始的Webhook URL即可（但钉钉现在要求必须设置一种安全方式，加签更常用）。 - 此代码仅发送文本消息，钉钉机器人还支持markdown、链接、ActionCard等消息类型，可根据需要扩展。 ### 常见问题 1. **返回错误码9002**：通常是因为时间戳与当前时间差距过大，请检查服务器时间。 2. **返回错误码310000**：通常是因为签名不正确，请检查密钥是否正确，以及签名的计算步骤是否正确。 §§相关问题§§ 1. 如何发送更复杂的消息格式（如Markdown、图片等）？ 2. 钉钉机器人发送消息的频率限制是多少？ 3. 如何通过钉钉机器人发送文件？ 4. 钉钉机器人和钉钉小程序在发送消息上有什么区别？ </think> ### 使用Python3通过钉钉机器人发送消息的方法 根据您提供的引用内容，钉钉小程序发送消息实际是通过**钉钉自定义机器人**实现的（引用[1][3]）。以下是完整实现步骤和代码： --- #### 核心原理 1. 创建钉钉群自定义机器人，获取`Webhook地址`和`加签密钥` 2. 使用Python生成带签名的请求URL 3. 通过HTTP POST发送JSON格式消息（引用[3]） --- #### 完整代码实现 (Python 3.8+) ```python import time import hmac import hashlib import base64 import urllib.parse import requests import json def send_dingtalk_msg(content, webhook, secret): # 1. 生成时间戳和签名 timestamp = str(round(time.time() * 1000)) string_to_sign = f"{timestamp}\n{secret}" sign = base64.b64encode( hmac.new(secret.encode('utf-8'), string_to_sign.encode('utf-8'), hashlib.sha256).digest() ).decode('utf-8') # 2. 构建带签名的URL signed_url = f"{webhook}&timestamp={timestamp}&sign={urllib.parse.quote(sign)}" # 3. 构造消息体 payload = { "msgtype": "text", "text": {"content": content} } # 4. 发送请求 headers = {'Content-Type': 'application/json'} response = requests.post(signed_url, data=json.dumps(payload), headers=headers) return response.json() # 使用示例 (替换为你的实际参数) WEBHOOK = "https://oapi.dingtalk.com/robot/send?access_token=你的token" SECRET = "你的加签密钥" # 在机器人安全设置中获取 result = send_dingtalk_msg("Python自动发送的测试消息", WEBHOOK, SECRET) print("发送结果:", result) ``` --- #### 操作步骤详解 1. **创建钉钉机器人** - 打开钉钉群 → 群设置 → 智能群助手 → 添加机器人 → 自定义机器人 - 安全设置选择`加签`，复制生成的`SECRET`和`Webhook地址` 2. **参数说明** - `webhook`: 形如 `https://oapi.dingtalk.com/robot/send?access_token=xxx` - `secret`: 加签密钥（43位字符串） - `content`: 要发送的文本内容 3. **支持的消息类型**（修改payload即可） ```python # Markdown消息示例 payload = { "msgtype": "markdown", "markdown": { "title": "报警通知", "text": "### 服务器状态\n> **CPU使用率**: 95%\n> [查看详情](https://example.com)" } } ``` --- #### 注意事项 1. **频率限制**：单个机器人每分钟最多发送20条消息（引用[2]） 2. **安全设置**：必须使用加签或IP白名单（钉钉强制要求） 3. **调试技巧**： - 打印`signed_url`检查签名拼接是否正确 - 使用`print(response.text)`查看详细错误 > 相比微信，钉钉机器人API更稳定且不易被封禁（引用[2]）