easyCoexistence
登录开始免费试用
Meta Tech Provider

WhatsApp Coexistence 术语表

WhatsApp Coexistence 相关术语容易混淆。实际使用中,很多混淆源于两个人用同一个词指不同事物。以下是本网站采用的定义,每项都链接到详细说明页面。

不储存消息Business 应用 + Cloud API为 Claude 和 ChatGPT 提供 MCP2 分钟即可开始使用
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 天内不收取任何费用。随时取消。

继续阅读

WhatsApp Coexistence 术语表