企业微信外部群主动推送消息全攻略

QiWe开放平台 · 个人名片

API驱动企微自动化，让开发更高效

核心能力：为开发者提供标准化接口、快速集成工具，助力产品高效拓展功能场景

官方站点：https://www.qiweapi.com

团队定位：专注企微API生态的技术服务团队

对接通道：搜「QiWe 开放平台」联系客服

核心理念：合规赋能，让企微开发更简单、更高效

1. 核心逻辑：任务制群发

主动发送消息的本质是：企业后台定义内容 -> API 下发任务 -> 员工手机端确认 -> 正式发出。

• 接口地址：POST https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_msg_template?access_token=ACCESS_TOKEN

• 生效范围：可以同时指定多个chat_id（外部群 ID）。

• 确认机制：调用接口后，群主（员工）会在企业微信的“服务助手”收到提醒，必须点击**“发送”**，消息才会出现在群里。

2. 消息组合能力

接口支持在一次任务中发送1 段文本 + 1 个附件。附件可以是以下几种之一：

3. 发送流程的最佳实践

为了确保推送系统稳定，建议按照以下步骤设计你的执行实例：

第一步：素材持久化与上传

由于 API 要求的media_id只有 3 天有效期，你应当将原始素材存在云存储中。

1. 从云存储读取图片/视频。

2. 调用/cgi-bin/media/upload获取media_id。

第二步：创建群发任务

构造请求体，将chat_id_list填入。注意，单次任务建议关联的群数不要过多（通常建议 50-100 个以内）。

第三步：督促员工发送

这是最容易被忽视的一步。如果员工不点击，任务 24 小时后会失效。

• 策略：调用message/send给该员工发一个应用提醒：“您有一个双11活动群发任务待处理，请及时操作。”

4. 关键限制（技术红线）

• 频率限制：

  • 每个外部群：每天只能接收1 条来自企业的群发消息。

  • 整家企业：每月对同一个外部群的群发总数不能超过4 条。

• 撤回限制：通过 API 发出的任务，一旦员工确认发送，后台无法撤回。

• MediaID 限制：上传后的media_id必须由同一个应用（AgentID）调用发送接口，否则无效。

5. 进阶方案：绕过手动确认？

如果你需要真正的“全自动即时发送”，目前官方提供的唯一途径是群机器人（Webhook）：

• 优点：调用 API 即刻发出，无需员工确认。

• 缺点：只能在开启了机器人功能的群中使用（通常是内部群或特定规则下的外部群），且不支持发送小程序卡片。

总结

外部群主动发送消息的核心在于**“管理任务”。利用云存储管理高画质素材，结合联系人模块筛选目标群组，并配合应用提醒**提高员工的执行率，是构建推送系统的标准公式。