更改 Coexistence 连接上的电话号码
一个 Coexistence 连接对应一个电话号码。当企业在 WhatsApp Business 应用中更改号码时,Meta 会断开该连接,原因为 CHANGE_NUMBER。新号码是平台上另一个独立的企业电话号码,必须通过 Coexistence 流程作为新连接重新接入。
企业更改电话号码时,Meta 报告的断开原因。
新 business portfolio 注册企业电话号码的初始上限,之后会提高到 20 个。
在此期限内用于发送付费消息的号码,无法从平台删除。
号码更改后,连接会怎样?
连接会终止。Meta 将更改电话号码列为 Coexistence 连接被断开的原因之一,并在 account_update Webhook 的 disconnection_info 中以 CHANGE_NUMBER 作为原因报告。
这是平台逻辑一致,而不是要求苛刻。API 端所知道的一切都以企业电话号码为键:它的 phone number ID、显示名称、质量评级和 Webhook 订阅。不同的号码就是不同的资产,因此旧号码上的任何内容都不会自动转移,旧连接在更改号码的那一刻就会失效。
如何连接新号码?
按首次连接处理。新号码必须满足与任何加入 Coexistence 的号码相同的条件,然后从头开始接入。旧连接中的任何内容都不会被沿用,因此最好把这次切换当作一个有日期的小项目来安排。
- 该号码已在 WhatsApp Business 应用中启用,且应用版本为 2.24.17 或更新。
- 该号码位于您管理的 Business Portfolio 中。
- 该号码未绑定到其他提供商。
- 注册时需提供其显示名称,与任何企业电话号码相同。
API 端需要更新哪些内容?
所有存放了旧号码或其 ID 的地方。通过 Cloud API 发送消息的集成使用的是 phone number ID,因此仍指向旧 ID 的 CRM、自动化工作流或 AI 代理会失败,而不会自动切换。
新连接还会重新开始自己的接入设置问题,包括是否共享聊天记录,以及用于同步记录的 24 小时窗口。旧连接上设置的 Webhook 目标需要重新应用到新连接。Business Portfolio 的容量也值得检查:在通过验证或达到 2,000 条消息上限之前,Meta 将新 business portfolio 限制为两个已注册的企业电话号码。
旧号码在平台上会怎样?
它会一直留在 WhatsApp Business 账户中,直到有人将其移除。Meta 只允许 business portfolio 管理员删除企业电话号码,并且会拒绝删除过去 30 天内用于发送付费消息的号码。
删除只是可选的整理工作,不是连接新号码的前提条件,但账户中留着过期号码,系统很容易继续向错误的号码发送。30 天期限过后将其移除,可以让账户保持清晰易读。
常见错误
- 在规划重新连接之前就在应用中更改号码。旧连接在那一刻就会终止。
- 在集成中保留旧的 phone number ID。发送会失败,而不会转到新号码。
- 在切换后立即尝试删除旧号码。如果该号码在 30 天内发送过付费消息,Meta 会阻止删除。
EasyCoexistence 会按 Meta 的报告,在连接时间线上显示 CHANGE_NUMBER 断开事件,新号码通过同样的自助 Embedded Signup 连接,大约只需 2 分钟。
常见问题
连接会跟随我的新号码吗?
不会。Meta 会以 CHANGE_NUMBER 为原因断开连接,新号码需要作为新连接接入。
我需要新的 phone number ID 吗?
需要。新号码是平台上另一个独立的企业电话号码,拥有自己的 ID。
我可以立即删除旧号码吗?
只有在过去 30 天内未发送过付费消息时才可以,而且只有 portfolio 管理员能删除。
我需要重新选择显示名称吗?
需要。注册企业电话号码时,Meta 要求提供显示名称信息。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间