多平台群机器人消息推送
快速开始
首次配置
用户需要先配置各平台的 webhook key。支持的平台：
| 平台 | 说明 |
|---|
| 企业微信 | 群机器人 webhook |
| 钉钉 | 自定义机器人 |
| 飞书 | 自定义机器人 |
将配置保存到 webhook-config.json（放在脚本同目录下）：
{
"wechat": {
"群名称": {
"key": "YOUR_WECHAT_KEY_HERE"
}
},
"dingtalk": {},
"feishu": {}
}
支持的平台
1. 企业微信
API 地址: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={key}
支持的消息类型:
text - 文本消息（支持 @mention）image - 图片（base64 + md5）markdown - Markdown（部分支持）
发送示例:
import json
import urllib.request
def send_wechat(key, content):
url = f"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={key}"
data = {"msgtype": "text", "text": {"content": content}}
req = urllib.request.Request(url, data=json.dumps(data, ensure_ascii=False).encode('utf-8'))
req.add_header("Content-Type", "application/json; charset=utf-8")
with urllib.request.urlopen(req) as resp:
return json.loads(resp.read().decode('utf-8'))
2. 钉钉
API 地址: https://oapi.dingtalk.com/robot/send?access_token={key}
支持的消息类型:
text - 文本消息（支持 @手机号）markdown - Markdownlink - 链接卡片actionCard - ActionCard 卡片feedCard - FeedCard 卡片
发送示例:
import json
import urllib.request
def send_dingtalk(key, content, at_mobiles=None):
url = f"https://oapi.dingtalk.com/robot/send?access_token={key}"
data = {
"msgtype": "text",
"text": {"content": content},
"at": {"atMobiles": at_mobiles or []}
}
req = urllib.request.Request(url, data=json.dumps(data, ensure_ascii=False).encode('utf-8'))
req.add_header("Content-Type", "application/json; charset=utf-8")
with urllib.request.urlopen(req) as resp:
return json.loads(resp.read().decode('utf-8'))
3. 飞书
API 地址: https://open.feishu.cn/open-apis/bot/v2/hook/{key}
支持的消息类型:
text - 纯文本post - 富文本image - 图片（需先上传获取 media_id）share_chat - 分享群会话interactive - 卡片消息
发送示例:
import json
import urllib.request
def send_feishu(key, content):
url = f"https://open.feishu.cn/open-apis/bot/v2/hook/{key}"
data = {"msg_type": "text", "content": {"text": content}}
req = urllib.request.Request(url, data=json.dumps(data, ensure_ascii=False).encode('utf-8'))
req.add_header("Content-Type", "application/json; charset=utf-8")
with urllib.request.urlopen(req) as resp:
return json.loads(resp.read().decode('utf-8'))
使用示例
用户说：「把天气发到钉钉项目群」
执行流程：
- 从配置中查找「钉钉-项目群」对应的 key
- 获取天气数据
- 调用 send_dingtalk 发送
@mentioned 功能（企业微信）
@所有人 ✅ 推荐方式
from webhook_push import send_wechat_text
key = "YOUR_WEBHOOK_KEY"
content = "明天晚上公司聚餐，大家都来！" # 内容里不要写 @all
send_wechat_text(key, content, mentioned_list=["@all"])
注意：内容里不要写 @all，只需要传 mentioned_list=["@all"]。如果内容里写了 @all，消息会显示两个 @all。
@个人（临时方案）
企业微信 webhook 的 @ 个人功能需要获取成员的 userid 或手机号。如果无法获取，可用以下方式：
# 在内容前面直接写 @姓名（这是临时方案，不会触发系统通知）
content = "@张三 明天上午10点开会"
send_wechat_text(key, content)
效果：消息中会显示 "@张三"，但这是纯文本显示，不会触发系统的 @ 通知。
@个人（正确方式，需要 userid/手机号）
如果能获取到成员的 userid 或手机号，可以使用官方支持的 @ 方式：
# 通过 userid @（userid 需要管理员在企业微信后台获取）
send_wechat_text(key, content, mentioned_list=["userid"])
# 通过手机号 @（需要在群里绑定过手机号）
send_wechat_text(key, content, mentioned_mobile_list=["13800001111"])
注意：
mentioned_list 里 userid 前不要加 @ 符号，如 ["wangqing"] 而不是 ["@wangqing"]mentioned_list=["@all"] 里 @all 需要带 @ 符号
权限要求
群聊设置中需要开启「允许机器人 @ 所有人」权限（需群主/管理员操作）。
常见错误
| 平台 | errcode | 解决方案 |
|---|
| 企业微信 | 301019 | 图片 MD5 不匹配 |
| 企业微信 | 93000 | webhook key 无效 |
| 钉钉 | 40014 | access_token 无效 |
| 钉钉 | 40035 | at_mobiles 格式错误 |
| 飞书 | 99991663 | webhook URL 无效 |
| 飞书 | 230001 | 消息内容过长 |
注意事项
-
频率限制：
- 企业微信：每分钟 20 条
- 钉钉：每分钟 20 条
- 飞书：每分钟 100 条
-
内容限制：
- 钉钉 Markdown 支持有限标题、列表、链接等
- 飞书卡片支持更丰富的交互
-
敏感词：各平台都会对内容进行过滤
