WhatsApp Coexistence 术语表
WhatsApp Coexistence 相关术语容易混淆。实际使用中,很多混淆源于两个人用同一个词指不同事物。以下是本网站采用的定义,每项都链接到详细说明页面。
EasyCoexistence 通过 Meta 的原有流程连接号码,并监控连接状态。
- Coexistence
Meta 的官方模式,让 WhatsApp Business 应用和 Cloud API 同时在同一个号码上运行。它不是另一种 API:仍是同一个 Cloud API,只是以应用可继续使用的方式接入。
WhatsApp Coexistence- Cloud API
由 Meta 托管的 WhatsApp Business Platform API。本网站上的每一次发送、每个消息模板和每个 Webhook 都经由它运行。
Cloud API 还是 Coexistence- WhatsApp Business 应用WhatsApp Business app
企业在手机上使用的应用。它不同于面向个人用户的 WhatsApp 应用,号码必须先在其中使用,Coexistence 才能连接它。
- WhatsApp Business 账户WABA
保存电话号码和消息模板的 Meta 对象,位于 Business Portfolio 之内。Webhook 覆盖设置在这一层级生效,而不是按号码设置。
- Business Portfolio
Meta Business Manager 中的公司级容器,包含一个或多个 WhatsApp Business 账户。客户的号码始终保留在客户自己的 portfolio 中,而不是服务商的。
Meta Tech Provider- 电话号码 IDPhone number id
Meta 为一个已连接号码分配的标识符。发送消息时指定的是这个 ID,而不是号码本身,并且每个入站 Webhook 负载中都会出现它。
- Embedded Signup
Meta 自己的接入弹窗。用于选择 portfolio、账户和号码;在 Coexistence 中,还包括一个需要在 WhatsApp Business 应用中扫描的代码。
号码如何连接- Tech Provider
Meta 授予的一种状态,允许公司通过自己已获批准的应用连接其他企业的号码。获取免费,但须通过企业验证和 App Review。这并不代表 Meta 的认可。
它意味着什么- BSPBusiness Solution Provider
销售消息平台的公司,通常提供共享收件箱。与 Tech Provider 有重叠,但描述的是产品,而不是 Meta 授予的状态。
Coexistence 还是 BSP- Webhook 目标webhook destination, webhook override
Meta 投递 WhatsApp Business 账户事件的位置。它作为覆盖设置配置在某个应用的订阅上,因此移除连接也会将其一并卸载。
WhatsApp Webhook- hub.challenge
Meta 在验证 GET 请求中发送的一个值。端点必须将其作为原始响应正文返回。返回 JSON 是 Webhook 始终收不到任何内容的最常见原因。
Webhook 验证- messages
承载客户所发送内容的 Webhook 字段。它属于消息路径,而 Webhook 覆盖设置正是将这条路径从服务商处转走。
- smb_message_echoes
承载团队从 WhatsApp Business 应用所发送内容的 Webhook 字段。仅存在于 Coexistence 号码上,软件正是通过它看到人工回复。
- 客户服务窗口customer service window, 24 小时窗口
从客户最后一条消息起的 24 小时,在此期间自由文本可以送达。窗口之外,只有已获批准的消息模板才能送达。
错误 131047- 消息模板template
预先提交给 Meta 审核的消息。它是在客户服务窗口之外唯一能够送达的内容;在 Coexistence 号码上,只能通过 API 发送。
错误 132001- 质量评级quality rating
绿色、黄色或红色,由 Meta 根据收件人的反应给出。它会在产生任何费用之前就下降,而且下降时不会有任何通知。
错误 131048- 消息级别messaging tier
一个号码每天可以主动发起对话的不重复客户数量。可升可降。它不同于吞吐量,后者是一种速率。
- 吞吐量throughput
一个号码每秒可以发送的消息数量。在 Coexistence 号码上由 Meta 固定,不会随质量和级别提升。
错误 130429- 已关联设备linked device
登录在其他位置的个人版 WhatsApp 客户端,例如 WhatsApp Web。非官方工具自动操作的正是它,WhatsApp 条款禁止的也是它,导致号码被封禁的也是它。
非官方 API 的风险- MCPModel Context Protocol
AI 助手访问不属于自己的工具的方式。只有请求和响应:MCP 服务器无法被传入的消息唤醒。
WhatsApp MCP 服务器
为什么这些术语会造成这么多困扰?
因为其中几个术语分别指向不同层级的事物,但看起来像处于同一层级。
Business Portfolio 包含 WhatsApp Business Account,后者包含电话号码,每个号码都有一个电话号码 ID。在对话中,这四者都被称为账户,因此“检查账户是否正常”可能指 4 种不同的检查。本平台的两个 24 小时窗口也有同样问题:它们衡量的是互不相关的事情,却经常被混为一谈。
另一部分原因是,Meta 和各家服务商对同一事物使用不同词汇,而服务商之间也没有统一说法。本页在有对应词汇时采用 Meta 的原有用语,并明确说明哪些术语是我们自己的说法。
实际使用中,哪些区别真正重要?
有 3 个,而且每个都曾让人多花 1 天时间。
客户服务窗口和同步窗口都是 24 小时,但两者完全无关。前者决定自由文本是否能够送达,从客户上次发送消息时起算。后者决定聊天记录是否仍可跨平台拉取,从入门流程完成时起算。
已关联设备不是 API。它是登录在其他位置的消费者 WhatsApp 客户端。非官方工具会自动操作这种客户端,也正是因此可能导致号码被封禁。
Webhook 目标也不是号码上的设置。它是应用订阅账户时的覆盖设置,所以连接移除后会消失,重新连接时必须再次设置。
常见问题
Coexistence 是不同于 Cloud API 的另一种 API 吗?
不是。Coexistence 是将号码接入 Cloud API 的一种方式,同时保留 WhatsApp Business 应用在该号码上的运行状态。端点、消息格式和规则都完全相同。
Business Portfolio 和 WABA 有什么区别?
Business Portfolio 是 Meta Business Manager 中的公司级容器。WhatsApp Business Account 位于其中,并保存电话号码。一个 Business Portfolio 可以包含多个 WABA。
BSP 和 Tech Provider 是同一回事吗?
两者有重叠,但指的是不同事物。Tech Provider 是 Meta 授予的状态,允许公司通过自己的应用连接其他企业的号码。BSP 通常指销售消息平台的公司,但该公司不一定拥有这种状态。
MCP 与 WhatsApp 有什么关系?
两者本质上没有关系。MCP 是一种让 AI 助手访问工具的协议,而 WhatsApp MCP 服务器会将一个号码作为这类工具提供。它不能接收消息,只能在收到请求时执行操作。
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用3 天内不收取任何费用。随时取消。