Coexistence 号码上的 WhatsApp 群组与 API
Meta 的 Groups API 允许 Cloud API 号码创建仅限邀请的小型群组并向其发送消息,但 Meta 明确表示它不适用于 WhatsApp Business 应用的电话号码,而 Coexistence 号码正是这类号码。应用中已有的群组也不会同步。在共用号码上,群组仍然只是应用端的功能。
面向 WhatsApp Business 应用电话号码的 Groups API,Meta 将其与 Coexistence 接入流程关联在一起。
通过 Groups API 创建的群组所允许的最大参与者人数。
Groups API 向拥有 Official Business Account 的企业开放。
从 WhatsApp Business 应用接入的号码上的群聊。
WhatsApp 有 Groups API 吗?
有。Meta 的 Groups API 允许企业在 Cloud API 号码上创建、列出和更新群组,向群组发送文本、媒体和模板消息,管理邀请链接,批准或拒绝加入请求,以及移除参与者。
它刻意设计得很小。群组仅限邀请,成员通过企业发送的链接加入,Meta 的限制更接近一个项目群,而不是社群。
- 每个群组最多 8 名参与者。
- 每个企业号码最多 10,000 个群组。
- 每个群组只能有一个 Cloud API 企业。
- 支持文本、媒体、基于文本的模板和基于媒体的模板。
Coexistence 号码可以使用它吗?
不可以。Groups API 页面明确说明它不适用于 WhatsApp Business 应用的电话号码,而这句话链接到 Meta 自己关于接入 WhatsApp Business 应用用户的指南,也就是 Coexistence。资格条件同样是 Official Business Account,而 Meta 的 OBA 页面表示不会向 WhatsApp Business 应用的电话号码授予该状态。
因此,这一排除是 Meta 为所有服务商统一设定的。应用与 API 共用的号码无法通过 API 创建群组,无法向群组发送消息,也收不到任何群组事件。
应用中已有的群组会怎样?
它们仍留在应用中,并继续在那里正常使用。Meta 的 Coexistence 文档将群聊列为号码接入时不会同步的内容,因此群组的历史记录和新的群组消息都不会进入 API。
手机上的团队仍然可以像以前一样创建群组、在群里发言和阅读消息。只是软件看不到这些流量。如果某个工作流程依赖群组,例如员工协调送货,它会继续在应用中进行,而围绕它的任何自动化都只能改用一对一对话来构建。
不通过 API 使用群组时,应该用什么替代?
使用一对一对话,这也是整个平台的设计基础。原本要发给一群客户的消息,改为分别发给每一位客户:在 24 小时客户服务窗口内以自由文本发送,窗口之外则使用已批准的模板。
如果企业确实需要由 API 管理的群组,Groups API 要求号码仅注册在 Cloud API 上,并持有 Official Business Account,这意味着该号码必须退出 Coexistence。这是关于该号码线路的结构性决定,而不是一项设置,并且会让应用不再能使用这条线路。
常见错误
- 看到存在 Groups API,就以为它适用于 Coexistence 号码。Meta 排除了 Business 应用号码。
- 以为接入后群组历史记录会出现在 API 中。群聊不会同步。
- 围绕 8 名参与者的上限规划基于群组的工作流程,却没有先确认是否够用。
EasyCoexistence 通过 Meta 的 Coexistence 接入流程连接号码,因此群组行为完全遵循 Meta 的定义:群组留在应用中,一对一对话则通过 API 处理。
常见问题
我可以通过 API 向 WhatsApp 群组发送消息吗?
只有使用 Groups API、拥有 Official Business Account 的纯 API 号码才可以。Coexistence 号码不行。
我现有的群组还能用吗?
可以,在 WhatsApp Business 应用中照常使用。它们不会同步到 API。
API 群组最多可以有多少人加入?
Meta 将通过 Groups API 创建的群组上限设为 8 名参与者。
这是我的服务商造成的限制吗?
不是。Meta 对所有服务商一律排除 WhatsApp Business 应用号码。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间