QiWe开放平台 · 个人名片
API驱动企微外部群自动化,让开发更高效
官方站点:https://www.qiweapi.com
对接通道:进入官方站点联系客服
团队定位:企微生态深度服务,专注 API+RPA 融合技术方案
1. 权限归属与“信任链”差异
群机器人 (Webhook):
它的权限是群级的。你可以把它理解为这个群里的一个“临时工”。
信任基础:只要拥有 Webhook URL 的人都能发消息。
生命周期:机器人被移除出群,该 URL 立即失效。
局限性:无法感知群以外的事情。它不知道谁是群主,也不知道企业有多少个群,它只管往“这一个”特定的管道里塞数据。
应用消息 (AppChat):
它的权限是企业级的。它是企业的“正职员工”或“部门主管”。
信任基础:基于企业全局生成的 Secret 和 Token,必须经过企业管理员授权。
生命周期:只要自建应用不删除,它可以给企业内任何它有权限触达的群发消息。
优越性:它可以调用企微的底层数据,比如先查询某个客户属于哪个群,再精准推送消息。
2. 消息流转逻辑对比
Webhook 模式(触发式):
业务系统 $\rightarrow$ 企微网关 $\rightarrow$ 指定群聊。
这是一个投递即完结的过程。业务系统发送后,不知道群成员有没有看,也无法根据群员的反馈做自动响应。
AppChat 模式(交互式):
业务系统 $\leftrightarrow$ 企微网关 $\leftrightarrow$ 外部群。
这是一个闭环。应用发送消息后,如果用户点击了消息里的卡片,企微会把点击事件回传给你的服务器。你可以根据这个点击,再自动触发下一条指令。
3. 业务选型指南:到底该用哪种?
根据开发目的,可以参考下表进行架构选型:
| 需求特征 | 推荐方案 | 核心理由 |
| 简单的服务器告警/通知 | 群机器人 | 开发成本极低,不需要维护复杂的 Token 机制。 |
| 外部客户服务/SOP 自动推送 | 应用消息 | 只有 AppChat 支持通过接口动态获取成千上万个外部群的 ID。 |
| 需要统计消息点击率 | 应用消息 | 支持文本卡片,可带链接和回调参数,方便做数据埋点。 |
| 需要长期维护群关系 | 应用消息 | 群名变更、成员进出都能通过回调通知应用,保持数据同步。 |
4. 外部群推送的“隐形”门槛
在不涉及代码的情况下,你需要关注两个非技术限制:
外部群性质:只有企业成员创建的外部群才支持应用主动推送。如果是微信用户创建的群,应用是无法通过 API 触达的。
发布频率控制:企微官方对主动推送有严格的防骚扰机制。如果短时间内向大量外部群推送相同内容,可能会导致接口临时封禁。在设计方案时,必须考虑灰度发布或排队发送的逻辑。