导读:为什么消息发送这么复杂?
企业微信为了保护客户隐私和维护良好的用户体验,对应用主动发送消息给外部群(即客户群)的行为做了严格的限制。因此,你需要根据你的具体业务场景和权限,选择正确的消息发送方式。
方式一:客户群群发 (推荐用于主动营销/通知)
这是企业微信官方推荐且功能最完善的发送方式,主要通过客户联系功能的应用权限来实现。它允许企业成员创建群发任务,将消息发送给他们所拥有的客户群。
核心特点
| 特点 | 说明 |
|---|---|
| 发送主体 | 消息以某个企业成员的名义发送。 |
| 消息类型 | 支持文本、图片、链接、小程序等丰富类型。 |
| 权限要求 | 应用需要拥有客户联系权限,且需要成员在企业微信中配置了客户联系功能。 |
| 发送限制 | 需要成员创建群发任务。每个成员每天对同一个客户群发消息数量有限制,以防过度骚扰。 |
关键 API 接口(通过应用调用)
-
构造群发任务: 调用
/cgi-bin/externalcontact/add_msg_template接口,创建包含消息内容的群发任务模板。 -
获取群 ID 列表: 调用
/cgi-bin/externalcontact/groupchat/list接口,获取该成员的客户群列表。 - 发送任务: 成员在企业微信客户端确认并发送任务(或通过接口辅助完成)。
适用场景: 营销推广、服务升级通知、活动邀请等需要以销售或客服名义发送的场景。
方式二:群机器人 Webhook (仅适用于群助手/内部临时通知)
群机器人(Webhook)是一种被动触发、轻量级的消息通知方式。它本质上是给特定的聊天群组提供了一个 HTTP 接口,允许外部系统通过 POST 请求发送消息。
核心特点
| 特点 | 说明 |
|---|---|
| 发送主体 | 消息以机器人的名义发送(显示为“群助手”)。 |
| 消息类型 | 支持文本、Markdown、图片、图文类型。 |
| 权限要求 | 无须企业微信应用权限,只需在群设置中添加群机器人即可获得唯一的 Webhook URL。 |
| 发送限制 | 无法发送给外部客户群。只能发送给企业内部创建的群聊,或者群主/管理员手动添加了机器人的客户群。且有调用频率限制。 |
关键调用方式
- 直接 POST 请求: 向群机器人提供的 Webhook URL 发送包含消息内容的 JSON 格式数据。
示例 Webhook URL 格式:qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxx
适用场景: 服务器告警、内部系统通知、日报周报提醒等非面向客户的场景。
总结对比:如何选择?
| 特性 | 方式一:客户群群发 (客户联系 API) | 方式二:群机器人 Webhook |
|---|---|---|
| 面向用户 | 外部客户群 (主流应用场景) | 内部群聊/群主手动添加的客户群 |
| 消息主体 | 成员昵称 | 群助手/机器人名称 |
| API 复杂性 | 较高,需要 Access Token、构造任务模板 | 低,只需一个 Webhook URL |
| 权限要求 | 需配置应用和客户联系权限 | 无需应用权限 |
| 主要用途 | 营销、服务、正式通知 | 内部通知、系统告警 |
结论: 如果您的目标是向您的所有客户群主动发送营销或服务通知,请选择方式一:客户群群发 (客户联系 API)。接下来的帖子将重点围绕这种方式展开。