WhatsApp Coexistence 术语表
WhatsApp Coexistence 相关术语容易混淆。实际使用中,很多混淆源于两个人用同一个词指不同事物。以下是本网站采用的定义,每项都链接到详细说明页面。
- Coexistence
Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time. Not a separate API: the same Cloud API, onboarded so the app keeps working.
WhatsApp Coexistence- Cloud API
Meta's hosted WhatsApp Business Platform API. Every send, template and webhook on this site runs through it.
Cloud API or Coexistence- WhatsApp Business app
The app a business uses on a phone. Distinct from the consumer WhatsApp app, and a number must be on it before Coexistence can connect it.
- WhatsApp Business AccountWABA
The Meta object that holds phone numbers and templates. Sits inside a Business Portfolio. Webhook overrides are applied at this level rather than per number.
- Business Portfolio
The company level container in Meta Business Manager. Holds one or more WhatsApp Business Accounts. A client's number stays in their portfolio, not a provider's.
Meta Tech Provider- Phone number id
Meta's identifier for one connected number. Sending targets this rather than the number itself, and it appears in every inbound webhook payload.
- Embedded Signup
Meta's own onboarding popup. Picks the portfolio, the account and the number, and for Coexistence includes a code scanned in the WhatsApp Business app.
How a number connects- Tech Provider
A Meta status permitting a company to connect other businesses' numbers through its own approved app. Free to obtain, gated on business verification and App Review. Not an endorsement.
What it means- BSPBusiness Solution Provider
A company selling a messaging platform, usually a shared inbox. Overlaps with Tech Provider but describes the product rather than the Meta status.
Coexistence or a BSP- Webhook destinationwebhook override
Where Meta delivers a WhatsApp Business Account's events. Set as an override on an app's subscription, which is why removing a connection uninstalls it.
WhatsApp webhooks- hub.challenge
A value Meta sends in its verification GET. The endpoint must return it as the raw body. Returning JSON instead is the most common reason a webhook never receives anything.
Webhook verification- messages
The webhook field carrying what customers send. Part of the message path, which is what a webhook override routes away from a provider.
- smb_message_echoes
The webhook field carrying what a team sends from the WhatsApp Business app. Only exists on Coexistence numbers, and is how software sees a human's replies.
- Customer service windowthe 24 hour window
Twenty four hours from the customer's last message, during which free text delivers. Outside it, only an approved template does.
Error 131047- Template
A message submitted to Meta for review in advance. The only thing that delivers outside the customer service window, and on a Coexistence number it can only be sent through the API.
Error 132001- Quality rating
Green, yellow or red, assigned by Meta from how recipients react. Falls before it costs anything, and nothing announces the fall.
Error 131048- Messaging tier
How many unique customers a number may start conversations with per day. Moves in both directions. Distinct from throughput, which is a rate.
- Throughput
Messages per second a number may send. Fixed by Meta on a Coexistence number rather than scaling with quality and tier.
Error 130429- Linked device
The consumer WhatsApp client signed in elsewhere, as WhatsApp Web does. What unofficial tools automate, what WhatsApp's terms prohibit, and what gets numbers banned.
Unofficial API risks- MCPModel Context Protocol
How an AI assistant reaches a tool it does not own. Request and response only: an MCP server cannot be woken by an incoming message.
WhatsApp MCP server
为什么这些术语会造成这么多困扰?
因为其中几个术语分别指向不同层级的事物,但看起来像处于同一层级。
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,而不是几个月。应用会继续在手机上运行。
开始免费试用7 天内不收取任何费用。随时取消。