登录开始免费试用
Meta Tech Provider

如何断开 Coexistence，仅使用应用

Coexistence 需要在 WhatsApp Business 应用中关闭：依次进入设置、账户、Business Platform，然后点击 Disconnect Account。应用继续使用该号码，提供商的访问权限终止，并发送带有 PARTNER_REMOVED 的 account_update Webhook。同时在两处使用的号码，无法通过 Cloud API 的 Deregister 端点注销。

Settings > Account > Business Platform

WhatsApp Business 应用中 Disconnect Account 按钮的位置。

PARTNER_REMOVED

企业从 Cloud API 断开时，Meta 发送的 account_update 事件。

Not allowed

通过 API 注销同时用于 Cloud API 和 WhatsApp Business 应用的号码。

如何关闭 Coexistence？

在持有该号码的手机上操作。当号码与 WhatsApp Business 应用共用时，Meta 只提供一种让企业退出 Cloud API 的方式，而且必须通过应用完成，不能通过任何控制台或端点。主手机的持有者决定是否断开，因此代理商或开发者需要请企业自行操作。

  • 在主设备上打开 WhatsApp Business 应用。
  • 进入设置，然后是账户，再进入 Business Platform。
  • 点击 Disconnect Account 并确认。
  • API 端会收到带有 PARTNER_REMOVED 事件的 account_update Webhook。

为什么 Deregister API 会拒绝该号码？

因为 Meta 有意将 Coexistence 号码排除在外。注册文档明确说明，Deregister 端点无法注销同时用于 Cloud API 和 WhatsApp Business 应用的企业电话号码。

注销会使号码无法再用于 Cloud API。对于仅使用 API 的号码，这是将线路从平台移除的方式。对于共用号码，应用才是该线路的主要所有者，所以 Meta 把决定权交还给持有它的人。软件如果先尝试调用该端点，得到的是错误而不是断开，号码会一直保持连接，直到有人在应用中点击按钮。

应用、聊天记录和号码会怎样？

断开不等于删除账户，这一区别就是答案的全部。

Meta 关于丢失消息记录的警告，针对的是删除 WhatsApp Business 应用账户并在 Cloud API 上注册号码。断开这两件事都不做。应用仍然安装并保持注册，号码仍在其中，团队继续用同一部手机回复客户。

终止的是 API 端。提供商的应用会从号码上移除，因此通过 Cloud API 发送消息以及相应的 Webhook 投递都会停止。Coexistence 关闭的功能，例如广播列表，见有关已禁用功能的页面。

之后可以重新连接该号码吗？

可以，从头重新运行接入流程即可。Meta 自己的文档也把解除接入再重新完成流程视为重置连接的常规做法，例如错过了同步联系人和记录的 24 小时窗口时。

重新连接是一次全新的接入，首次询问的问题会再问一遍，包括是否共享聊天记录。旧连接上配置的内容，例如 Webhook 覆盖设置，需要重新应用。需要换到其他提供商的号码也走同样的路径：在这里断开，然后通过新的提供商接入。

常见错误

  • 对 Coexistence 号码调用 Deregister 端点。Meta 会拒绝，断开必须在应用中完成。
  • 为了退出而删除 WhatsApp Business 应用账户。这正是会丢失聊天记录的做法。
  • 把 PARTNER_REMOVED 当作需要重试的故障。它是企业主动做出的断开。
使用 EasyCoexistence 完成这些操作

EasyCoexistence 在 Meta 发送 PARTNER_REMOVED 事件的那一刻，就把它记录在连接时间线上，因此从手机上发起的断开会显示在控制台中，而不是等到下一次发送失败才被发现。

常见问题

断开后我会丢失聊天记录吗？

不会。断开只是把 API 从号码上移除，不会删除 WhatsApp Business 应用账户，而 Meta 警告会丢失记录的正是删除账户。

可以通过 API 断开吗？

不可以。对于同时用于 Cloud API 和应用的号码，Meta 不允许使用 Deregister 端点。

我的系统如何得知已断开？

企业断开时，Meta 会发送带有 PARTNER_REMOVED 事件的 account_update Webhook。

可以重新连接同一个号码吗？

可以。像首次连接一样，从头重新运行接入流程即可。

继续阅读

Moving a number from Coexistence to Cloud API onlyTaking a number off the WhatsApp Business app and running it on Cloud API alone: the order of steps, the history Meta says is lost, and what changes.Migrating a number from another WhatsApp providerMoving a WhatsApp number that already sits with another provider: the Coexistence case, the API-only case, what Meta carries over and what resets.Changing the phone number on a Coexistence connectionWhy changing the number in the WhatsApp Business app ends a Coexistence connection, what the new number needs, and what to do with the old one.The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.Which WhatsApp features stop working after CoexistenceDisappearing messages, view once, live location and broadcast lists are switched off on a connected number. What each one means in practice.Coexistence referenceWhat Coexistence is, how messages flow, what it costs, what it cannot do, eligibility, and how to roll it back. The short reference version.

准备开始了吗？

几分钟即可设置 WhatsApp Coexistence，而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间

断开 Coexistence