企业微信外部群机器人主动推送消息实现指南

在企业微信的生态开发中，针对外部群（包含微信用户的群聊）进行自动化消息推送，最稳健且合规的方式是利用群机器人（Webhook）。本文将从技术逻辑、核心步骤及注意事项三个维度，分享如何实现这一功能。

一、实现逻辑简述

企业微信外部群机器人主要通过一个唯一的 Webhook 地址 接收标准的 HTTP POST 请求。开发者只需将构造好的 JSON 格式数据发送至该地址，即可实现消息的主动触达。

• 适用场景：业务进度通知、系统告警、日报自动汇总等。
• 权限要求：群主或管理员需开启'群机器人'功能。

二、核心开发流程

1. 获取 Webhook 地址

在外部群聊设置中，点击'添加群机器人'，设置名称后即可获得类似如下的 URL：

https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

2. 构造消息体

企业微信支持多种消息格式（Text、Markdown、Image、File）。以最常用的 Markdown 为例，其格式如下：

{
  "msgtype": "markdown",
  "markdown": {
    "content": "实时业务通知\n>项目名称：<font color=\"info\">自动化接口测试</font>\n>当前状态：<font color=\"warning\">待处理</font>\n>请相关负责人及时跟进。"
  }
}

3. 发送 POST 请求

使用 Python 的 requests 库或 Node.js 的 axios 即可轻松实现推送：

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, data=json.dumps(data), headers=headers)
    return response.json()