钉钉 Webhook 机器人发送群消息指南

4. 链接消息

data = {
    "msgtype": "link",
    "link": {
        "text": "这是一条链接消息",
        "title": "系统通知",
        "picUrl": "https://img.example.com/1.jpg",
        "messageUrl": "https://www.example.com"
    }
}

5. ActionCard（按钮卡片）

data = {
    "msgtype": "actionCard",
    "actionCard": {
        "title": "审批通知",
        "text": "### 请假申请\n申请人：李四\n时间：2024-01-01",
        "btns": [
            {"title": "同意", "actionURL": "http://example.com/approve"},
            {"title": "拒绝", "actionURL": "http://example.com/reject"}
        ]
    }
}

安全设置处理

加签验证

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 = f'{timestamp}\n{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(base64.b64encode(hmac_code))
# 将 timestamp 和 sign 添加到 URL
webhook_url = f"{原 URL}&timestamp={timestamp}&sign={sign}"

使用 cURL 示例

curl '你的 Webhook 地址' \
  -H 'Content-Type: application/json' \
  -d '{ "msgtype": "text", "text": { "content": "测试消息" } }'

注意事项

1. 频率限制：每分钟最多 20 条消息
2. 消息长度：文本消息不超过 5000 字符
3. 关键词匹配：如果设置了关键词，消息中必须包含
4. 错误处理：建议添加重试机制和错误日志
5. 敏感信息：不要在消息中暴露敏感数据

调试建议

• 使用钉钉官方提供的调试工具
• 先发送测试消息验证配置
• 检查返回的状态码和错误信息