登录开始免费试用
Meta Tech Provider

将号码从 Coexistence 迁移到纯 Cloud API

要让 Coexistence 号码变为纯 API 号码，需要先在 WhatsApp Business 应用中断开连接，再删除应用账户，最后使用两步验证 PIN 在 Cloud API 上注册该号码。Meta 警告现有消息历史记录会丢失，而且除非先从 Cloud API 注销注册，否则该号码无法再回到应用。

Lost

Business 应用号码被删除并在 Cloud API 上注册后，现有消息历史记录的去向。

3 minutes

已删除的号码需要多长时间才能重新用于注册。

80 mps

每个号码的 Cloud API 默认吞吐量，对比 Coexistence 号码固定的 20 mps。

10 per 72 h

每个商业号码在滚动时间窗口内允许的注册请求次数。

企业为什么要离开应用？

通常是因为已经没有人再用手机回复消息。当所有对话都由软件或基于 API 构建的收件箱处理时，应用只会增加负担，却没有带来任何好处：主设备仍需定期打开，号码的吞吐量也仍被 Coexistence 固定在较低水平。

Meta 文档指出，同时在应用和 Cloud API 上使用的号码，吞吐量固定为每秒 20 条消息。纯 API 号码默认起步最高为每秒 80 条消息，满足 Meta 的条件后可自动升级到 1,000。对于大量发送消息的号码，这个差距就是迁移的理由。

步骤的顺序是什么？

一共四步，顺序很重要，因为 Deregister 端点会拒绝仍与应用共享的号码。除最后一步外，其余每一步都由企业在手机上完成；最后一步是 API 调用，由今后负责运营该号码的一方发起。

  • 按照 Meta 的建议，先在 WhatsApp Business 应用中备份聊天记录。
  • 在应用中断开连接：设置 > 账户 > Business Platform > Disconnect Account。
  • 删除应用账户：设置 > 账户 > Delete my account，然后最多等待 3 分钟。
  • 使用 6 位两步验证 PIN 在 Cloud API 上注册该号码。

企业会失去什么？

手机上的对话，以及用手机回复消息的方式。

Meta 明确指出，删除 WhatsApp Business 应用账户并在 Cloud API 上注册号码，会丢失现有的消息历史记录。这与 Coexistence 接入正好相反：Meta 说明在 Coexistence 下历史记录会保留，应用和 API 也可同时运行。

此外，除非先从 Cloud API 注销注册，否则该号码无法再次用于 WhatsApp Business 应用。因此这是一次经过慎重考虑、不可逆的运营方式变更，开始之前最好确认团队中没有人还在使用应用。

API 一侧有哪些保持不变？

软件与号码交互的方式不变。使用的仍是 Cloud API：消息类型、消息模板、Webhook 和定价都相同，因为 Coexistence 只是进入同一平台的另一种接入方式。

变化在于注册。Coexistence 号码由接入流程完成注册；纯 API 号码则通过携带两步验证 PIN 的 register 调用完成注册，Meta 将此类调用限制为每个号码在 72 小时滚动窗口内 10 次。失败的尝试会消耗次数，所以重试之前请先检查 PIN。

常见错误

  • 在备份聊天记录之前就删除应用账户。Meta 明确指出，这条路径会丢失历史记录。
  • 号码仍与应用共享时就调用 Deregister。Meta 会拒绝该请求。
  • 在循环中反复重试注册。Meta 允许每个号码在 72 小时内发出 10 次 register 请求。
使用 EasyCoexistence 完成这些操作

EasyCoexistence 通过 Coexistence 接入来连接号码，因此应用会继续保留。当企业决定离开应用时，在手机上断开连接这一操作，会和其他事件一样记录在连接时间线中。

常见问题

迁移到纯 API 后，我能保留聊天记录吗？

无法在 API 中保留。Meta 警告历史记录会丢失，并建议先从应用中备份。

号码以后还能回到应用吗？

根据 Meta 的迁移指南，只有先从 Cloud API 注销注册后才可以。

吞吐量会提高吗？

会。Coexistence 号码固定为 20 mps，纯 API 号码起步最高为 80 mps。

我可以先用 Deregister API 开始吗？

号码与应用共享时不行。请先在 WhatsApp Business 应用中断开连接。

继续阅读

How to disconnect Coexistence and go back to the app onlyTurning Coexistence off from the WhatsApp Business app, what the API side receives, why the Deregister endpoint refuses, and how to connect again later.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.WhatsApp Cloud API or Coexistence: which one a number needsBoth are Meta's. One takes the number onto the API alone, the other runs the API beside the WhatsApp Business app. Which to pick, and what each costs you.Two step verification on a WhatsApp numberThe six digit PIN set on a WhatsApp Business number, which operations require it, and what to do when nobody remembers it.Rate limits and messaging throughputThe four separate WhatsApp Cloud API limits: messaging tier, throughput, per-recipient pairing and management calls.

准备开始了吗？

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

开始免费试用

验证时间

从 Coexistence 迁移到纯 Cloud API