企业微信二次开发：如何实现外部群消息的主动推送？

在私域运营中，我们经常需要根据特定业务触发（如订单状态变更、活动提醒等）向外部客户群发送消息。与内部群不同，外部群的消息推送涉及更严格的安全合规机制。本文将重点解析通过 群机器人（Webhook） 和 应用消息（send_to_groupchat） 两种主流方式的实现逻辑。

1. 核心链路选择：Webhook vs. 应用 API

在开始开发前，需要根据场景选择合适的推送路径：

群机器人 (Webhook)： 适用于固定的、长期的群聊。优点是开发极快，通过一个 HTTP POST 请求即可发送文本、图文或文件。缺点是需要手动将机器人拉入群聊。
应用消息 (App Push)： 适用于大规模、动态生成的客户群。通过企业自建应用调用接口，可以更灵活地管理推送任务，但对 API 的调用频率限制更严。

2. 技术实现：基于 Webhook 的快速推送

对于大多数自动化通知场景，Webhook 是首选。

实现步骤：

在外部群设置中，点击"添加群机器人"，获取专属的 webhook_url。
构造 JSON 数据体。
向 URL 发起 POST 请求。

代码逻辑示例 (Python)：

python 复制代码

import requests
import json

def send_wechat_group_msg(webhook_url, content):
    headers = {"Content-Type": "application/json"}
    data = {
        "msgtype": "text",
        "text": {
            "content": content,
            "mentioned_list": ["@all"] # 可选：提醒所有人
        }
    }
    response = requests.post(webhook_url, data=json.dumps(data), headers=headers)
    return response.json()

3. 技术实现：基于 API 的自建应用推送

如果需要通过后台系统自动管理成百上千个外部群，则需要使用企业微信的 app_chat 接口。

关键流程：

获取 AccessToken： 使用应用的 corpid 和 secret 获取全局令牌。
获取群聊 ID (chatid)： 通过客户群列表接口获取需要推送的目标群 ID。
调用发送接口： 接口地址为 https://qyapi.weixin.qq.com/cgi-bin/appchat/send?access_token=ACCESS_TOKEN。

注意事项：

外部群推送必须确保自建应用在群的可信范围之内。此外，为了防止骚扰，企业微信对单个群的消息接收频率有严格限制，开发者务必在代码中加入频率控制逻辑（如令牌桶算法）。

4. 避坑指南与最佳实践

消息格式多样化： 除了纯文本，利用 template_card（模版卡片消息）可以大幅提升交互率，支持添加按钮、投票等交互组件。
图片与文件上传： 如果要推送图片，必须先调用"上传临时素材"接口获取 media_id，再进行推送。
异步队列处理： 推送任务建议放入 Redis 队列异步执行。外部群推送有时会因为网络延迟或接口限制导致阻塞，异步化能保证主业务系统的稳定性。

总结

实现企业微信外部群主动推送，技术难度并不在于接口调用本身，而在于对接口权限的梳理 和消息频率的把控。开发者应优先遵循官方开发文档，在合规的框架内利用 API 提升社群连接的价值。

QiWe开放平台提供了后台直登功能，登录成功后获取相关参数，快速Apifox在线测试，所有登录功能都是基于QiWe平台API自定义开发。