企业微信机器人Webhook地址需完整、未过期且后台配置正确；验证方式为浏览器访问返回{"errcode":0,"errmsg":"ok"}；发送消息须用requests.post(url, json=payload)，避免截断、空格、硬编码key。
企业微信机器人Webhook地址怎么填才有效
必须确保 Webhook URL 是完整、未过期、且已正确配置在企业微信管理后台的群机器人中。常见失效原因：URL 被手动截断（漏掉末尾的 key=xxx）、复制时带空格或换行、机器人被禁用或删除、所在群已被解散。
验证方式很简单：直接把 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx 粘贴进浏览器地址栏，如果返回 {"errcode":0,"errmsg":"ok"}，说明地址本身可通；若返回 {"errcode":40014,"errmsg":"invalid webhook url"}，就是 URL 无效。
- 不要从企业微信 PC 客户端右键复制——容易多出不可见字符
- 从管理后台「群机器人」页面点击「复制」按钮获取原始 URL
- URL 中的
key参数不能硬编码进脚本，建议通过环境变量读取：os.getenv("WECHAT_WEBHOOK_KEY")
用Requests发文本消息的最小可行代码
企业微信 Webhook 接口只接受 POST 请求，Content-Type 必须为 application/json，且 payload 必须是 JSON 字符串（不是 Python dict）。最容易错的是忘记 json.dumps() 或误用 data= 而非 json= 参数。
import requests
import json
<p>url = "<a href="https://www.php.cn/link/f5e9e329e1bc1ae7c49d22cef556e797">https://www.php.cn/link/f5e9e329e1bc1ae7c49d22cef556e797</a>"
payload = {
"msgtype": "text",
"text": {
"content": "【定时提醒】当前时间：2024-06-15 10:30"
}
}</p><h1>✅ 正确写法：用 json= 参数（requests 自动序列化+设 header）</h1><p>requests.post(url, json=payload)</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill11526" title="Python Hardener"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="Python Hardener" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill11526" title="Python Hardener">Python Hardener</a>
<p>通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。</p>
</div>
<a href="/xiazai/skill11526" title="Python Hardener" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><h1>❌ 错误写法：用 data=json.dumps(...) 但没设 headers</h1><h1>requests.post(url, data=json.dumps(payload))</h1><p>-
json=参数会自动设置Content-Type: application/json，省心且不易出错 - 若用
data=，必须显式传headers={"Content-Type": "application/json"} - 消息内容中的换行需用
\n，企业微信不识别 HTML 或 Markdown 换行
定时任务选APScheduler还是系统cron
本地开发调试用 APScheduler 更方便；生产部署（尤其 Linux 服务器）优先用系统 cron ——它不依赖 Python 进程存活，重启后依然准时运行。
- APScheduler 的
BlockingScheduler会阻塞主线程，适合单脚本长期运行场景；但一旦 Python 进程崩溃，定时就停了 - Linux cron 示例（每天 9:00 发提醒）：
0 9 * * * /usr/bin/python3 /path/to/reminder.py >> /var/log/wechat-remind.log 2>&1 - 避免在 APScheduler 中用
time.sleep()控制间隔——它不精确，还可能阻塞调度器 - 如果必须用 APScheduler，加个简单健康检查：每次发送前用
requests.head(url, timeout=3)验证 Webhook 可达性
消息体里加@所有人或指定成员怎么写
企业微信 Webhook 不支持纯文本里的 @all 自动识别，必须显式使用 mentioned_list 或 mentioned_mobile_list 字段。想 @ 所有人，填 ["@all"]；想 @ 某人，填其在企业微信中绑定的手机号（不是微信号）。
payload = {
"msgtype": "text",
"text": {
"content": "【重要】请查收今日日报\n",
"mentioned_mobile_list": ["13800138000", "13900139000"]
}
}
-
mentioned_list填企业微信账号（即成员 ID），一般用于内部系统集成；日常运维更常用手机号方式 - 手机号必须与成员在企业微信「我 > 设置 > 隐私 > 手机号可见范围」中设置的可见范围一致，否则 @ 不生效
- 注意：@ 功能仅在「文本消息」和「markdown 消息」中可用，image、file 类型不支持
- 测试时先用自己手机号试，确认能收到通知再上线，避免误 @ 全员造成干扰
企业微信 Webhook 对请求频率有限制（每个机器人每分钟最多 20 条），实际部署时得留缓冲余量；另外，错误响应如 {"errcode":45009,"errmsg":"reach max api freq limit"} 很容易被忽略，建议在发送逻辑里捕获 requests.exceptions.RequestException 并记录日志。
