企业微信外部群 Webhook 配置与消息推送指南

在企业微信的自动化体系中，群机器人（Webhook） 是实现系统消息自动同步到外部群最快捷、门槛最低的工具。

尽管当前官方对外部群机器人的管理日益严格，但只要掌握正确的配置流程和调用逻辑，它依然是效率提升的神器。以下是完整的实操步骤：

第一步：获取 Webhook 地址

1. 添加机器人： 打开企业微信电脑端，进入你需要配置的外部群，点击右上角'...'，选择'群机器人' -> '添加机器人'。
2. 命名与生成： 为机器人设置一个符合业务场景的名字（如'订单助手'），点击确定。
3. 保存 Key： 系统会生成一个唯一的 Webhook 地址（形如：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxx）。请务必妥善保管此 Key，泄露将导致他人可以随意向你的群发消息。

第二步：理解消息格式

企业微信 Webhook 支持多种消息类型，最常用的是 text（文本）和 markdown。

• 推荐使用 Markdown： 因为它支持标题加粗、链接跳转、字体颜色（部分支持），能让你的自动推送看起来更专业。
• 代码示例（JSON）：

{ "msgtype": "markdown", "markdown": { "content": "### 业务提醒：新订单已产生\n> 订单编号：<font color=\"comment\">ORD20260122</font>\n> 状态：<font color=\"info\">待处理</font>\n\n[点击查看详情](https://your-system.com/detail)" } }

第三步：编写推送脚本

你可以使用任何后端语言进行调用。以下是一个极简的 Python 调用逻辑示例：

import requests
import json

def send_wechat_msg(webhook_url, content):
    headers = {"Content-Type": "application/json"}
    data = {
        "msgtype": "markdown",
        "markdown": {"content": content}
    }
    response = requests.post(webhook_url, headers=headers, data=json.dumps(data))
    return response.json()
# 使用时只需传入你的 Webhook 地址和内容

第四步：避坑与优化

1. @ 成员的限制： 在外部群中，机器人无法通过 at_list 直接强提醒微信个人用户。如果你需要提醒特定人，建议在消息中用文字显式标出，或引导其关注小程序。
2. 频率熔断： 官方规定每个机器人每分钟最多发送 20 条消息。如果你的业务量大，建议建立消息缓存池，分批次匀速发送。
3. 群属性校验： 并非所有外部群都支持机器人。如果群内微信用户过多或包含敏感行业用户，机器人可能无法添加。此时需改用'自建应用'路径。

总结

Webhook 推送的核心不在于'发'，而在于'准'。通过对接业务系统的数据库，实现关键节点（如：支付成功、库存预警、会议提醒）的自动化触达，才能真正释放人力，发挥外部群的最大价值。