QiWe开放平台 · 开发者名片
API驱动企微自动化，让开发更高效
核心能力：企微二次开发服务 | 多语言接入 | 免Root授权
官方站点：https://www.qiweapi.com（功能全景）
开发文档：https://doc.qiweapi.com（开发指南）
团队定位：专注企微API生态的技术服务团队
对接通道：搜「QiWe 开放平台」联系客服
核心理念：合规赋能，让企微开发更简单、更高效
在企业微信的开发场景中，向外部群（包含客户的群聊）主动推送消息是连接业务系统与服务端的关键环节。与内部群机器人不同，外部群的消息推送涉及更严格的合规性与接口权限。
一、 核心逻辑与接口选择
实现主动推送主要有两种路径，具体取决于您的业务场景：
应用消息推送 (API推送)
适用场景：系统自动触发的任务通知、业务进度提醒。
核心接口：使用
发送应用消息接口。关键点：需要通过应用（Agent）进行发送，且接收者必须在应用的可见范围内。
群机器人 (Webhook)
适用场景：纯技术类告警、内部协同同步到外部群（需群主开启机器人权限）。
核心接口：通过 Webhook 地址发送 POST 请求。
限制：外部群机器人目前有较高的安全审核机制，需确保群聊已开启相关权限。
二、 核心开发流程 (以应用消息为例)
实现自动化推送通常分为以下四个步骤：
1. 获取 AccessToken
所有 API 调用前，必须通过corpid和corpsecret获取有效的调用凭证。
注意：建议在服务端缓存 AccessToken，避免频繁调用导致接口限流。
2. 确认群聊 ChatID
外部群的标识符为chatid。您可以通过“获取客户群列表”接口或在回调事件（如用户入群）中捕获该 ID。
3. 构造消息体
企业微信支持多种消息格式，包括文本 (text)、图片 (image)、图文卡片 (news) 或模板卡片 (template_card)。
4. 执行推送
调用https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/send(示例接口) 或应用消息接口进行下发。
三、 开发中的避坑指南
频率限制：企业微信对主动推送频率有严格限制。建议在代码逻辑中加入队列管理，避免短时间内高频并发导致接口被封禁。
语义脱敏：推送内容应严格遵守《企业微信运营规范》。避免在代码逻辑中包含过于敏感的触发词，建议使用变量替换动态内容。
群主权限：外部群的消息推送往往需要群主（企业成员）在后台或手机端进行确认，或者该群是由“企业成员”创建的托管群。
四、 总结
外部群的主动推送不仅仅是技术的实现，更是对业务边界的把握。通过应用接口 + 消息队列的组合，可以实现高效且稳定的自动化通知体系。
