登录开始免费试用
Meta Tech Provider

WhatsApp Coexistence 术语表

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

EasyCoexistence 通过 Meta 的原有流程连接号码,并监控连接状态。

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

继续阅读

指南WhatsApp Coexistence:同一号码使用应用和 APICoexistence 是 Meta 的官方模式,让 WhatsApp Business 应用和 Cloud API 同时使用同一号码。团队仍可通过手机回复,保留相同的对话和历史记录,同时由软件在同一号码上发送和接收消息。无需迁移,也无需更换号码。参考连接后 WhatsApp Business 应用有哪些变化手机端几乎没有变化。聊天、历史记录、联系人和设备都不变,团队照常回复。变化在于 API 连接到同一个号码,双方都能看到对方发送的内容,而群组不会纳入 API。参考24 小时客户服务窗口客户向您的号码发送消息后,客户服务窗口便会开启,并持续 24 小时。在窗口内,您可以发送自由文本,而且回复免费。窗口关闭后,只有 Meta 已批准的消息模板才能送达。指南成为 Meta Tech Provider 意味着什么,以及为什么重要Meta Tech Provider 在经过验证的 Business Manager 上运行自己的 Meta 应用,并通过该应用连接其他企业的 WhatsApp 号码。EasyCoexistence 就是其中之一,因此号码会直接连接到您自己的 Business Portfolio,而不是归在经销商账户下。指南WhatsApp Business 应用和 API 可以使用同一号码吗?可以。Meta 将其称为 Coexistence,这是官方功能,不是临时替代方案。员工继续在手机上的 WhatsApp Business 应用中回复,Cloud API 同时运行在同一号码上,双方都能看到相同的对话。指南如何在不丢失聊天记录的情况下将 WhatsApp 连接到 API聊天记录保存在手机上,连接 API 不会移动它们。Coexistence 会在 WhatsApp Business 应用旁边加入 Cloud API,而不是取代应用,因此对话仍留在原处,应用也能继续运行。