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 个附件。附件可以是以下几种之一：
| 附件类型 | 参数字段 | 关键要求 |
| 图片 | image | 需要通过临时素材接口上传获取media_id。 |
| 视频 | video | 需要media_id，建议大小在 10MB 以内。 |
| 链接卡片 | link | 需要标题、封面图 URL 和跳转链接。 |
| 小程序 | miniprogram | 需要 AppID、页面路径和标题。 |
3. 发送流程的最佳实践
为了确保推送系统稳定，建议按照以下步骤设计你的执行实例：
第一步：素材持久化与上传
由于 API 要求的media_id只有 3 天有效期，你应当将原始素材存在云存储中。
从云存储读取图片/视频。
调用
/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 即刻发出，无需员工确认。
缺点：只能在开启了机器人功能的群中使用（通常是内部群或特定规则下的外部群），且不支持发送小程序卡片。
总结
外部群主动发送消息的核心在于**“管理任务”。利用云存储管理高画质素材，结合联系人模块筛选目标群组，并配合应用提醒**提高员工的执行率，是构建推送系统的标准公式。
)
