迁移到 WhatsApp Cloud API 的好处
WhatsApp 云 API 是一个新平台，提供企业直接连接 WhatsApp 基础设施的服务，与通过 WhatsApp 合作伙伴 (BSPs) 相比，这是一种自助服务选项。 使用 WhatsApp Cloud API 的一些好处包括：
更具成本效益的选择。
与平台的连接更加可靠和稳定。
能够构建适合您特定业务需求的定制集成。
适用于各种规模企业的灵活且可扩展的解决方案。
在此处了解有关 WhatsApp 云 API 的更多信息。
哪些内容将被迁移？
请注意，以下元素可以从 WhatsApp BSP 迁移到 WhatsApp Cloud API。
可以迁移
与帐户关联的电话号码。
任何先前批准的高质量消息模板。
电话号码的显示名称。
电话号码的质量评级。
消息限制。
WABA 官方地位。
无法迁移
低质量、被拒绝或待处理的消息模板。
迁移前要求：迁移设置需要准备什么
请注意本文档中经常使用的短语：
-Source WABA：我们正在从中迁移的 WhatsApp BSP。
-目的地 WABA：我们正在迁移到的 WhatsApp Cloud API。
迁移前要求清单：
现有的 Meta 开发者应用程序： 如果您尚未创建开发者应用程序， 请单击此处在 Meta Business Manager (MBM) 中创建您的应用程序并开始使用 WhatsApp Cloud API。 此应用程序必须在与源 WABA 相同的商业帐户（商业 ID）下创建。
业务 ID： 源和目标 WABA 必须与相同的 MBM 关联或具有相同的业务 ID。
业务验证： 必须验证业务 ID。 如果您的企业尚未验证， 请按照以下步骤进行验证。
WABA 审核状态：源和目标 WABA 的审核状态必须获得批准。
付款 方法： 必须为源和目标 WABA 配置付款方式。 确保在来源地和目的地都设置了付款方式。
两步验证：必须在要迁移的电话号码上禁用两步验证。
当以上所有检查完成后，迁移过程就可以继续。
配置电话号码和 WABA ID
Meta 将 WABA ID 设计为不可迁移。 由于某些限制，已实施一种解决方法。 要进行电话号码迁移，源和目标 WABA ID 必须位于同一个 Meta 业务经理帐户下。 这意味着迁移电话号码只会导致该号码在 WABA 之间转移，而不会允许任何其他更改。 要成功迁移电话号码，必须执行以下步骤：
向目标 WABA 添加一个新号码：这将为您希望迁移到的号码生成一个新的 WABA ID。 如果您现有的 WABA 号码不再使用，则可以跳过此步骤。
从目标 WABA 中删除新号码：这将腾出一个位置，用于将号码添加到目标 WABA。 或者，如果您有一个未使用的号码，您可以删除该号码。
删除号码后，继续将客户的当前号码迁移到新的 WhatsApp 业务.
迁移过程的 API 文档
值得注意的是，目前，API 文档中概述的这些迁移步骤只能由开发人员或具有类似技术背景的人员执行。 然而，我们知道这对某些人来说可能是一个限制，我们正在努力在未来开发出更加用户友好和易于访问的解决方案。 需要幫助嗎？ 联系我们这里！
步骤 1：开始电话号码迁移
回调网址：
发布 <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>
姓名 | 在 | 必需的 | 类型 | 描述 |
|---|---|---|---|---|
版本 | 小路 | 真的 | 细绳 | API 版本。 |
瓦巴伊德 | 小路 | 真的 | 细绳 | WhatsApp 云 API WABA ID。 |
前往 业务管理器 > 业务设置 > 帐户 > WhatsApp 业务帐户 查找 WhatsApp 业务帐户的 ID。 选择您要使用的帐户。 将出现一个包含帐户信息（包括 ID）的面板。
参数
标题
授权：持有者 {Access Token}
系统用户在 Business Manager 的 WhatsApp Business Accounts 选项卡中生成您的访问令牌。 阅读 本指南 了解如何访问系统用户并创建或复制系统用户。
身体
姓名 | 类型 | 描述 |
|---|---|---|
抄送 | 数量 | 正在注册的电话号码的数字国家代码。注意：国家代码不需要加号 (+)。 |
电话号码 | 数量 | 正在迁移的电话号码，不带国家代码或加号 (+)。 |
迁移电话号码 | 布尔值 | 设置为 true 以迁移电话号码。 |
地位
姓名 | 描述 |
|---|---|
200 正常 | 成功。 |
回复
{
"id": "电话号码 Id"
}
步骤 2：请求代码 (PIN) 来验证手机所有权
回调URL
发布 <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>
姓名 | 在 | 必需的 | 类型 | 描述 |
|---|---|---|---|---|
版本 | 小路 | 真的 | 细绳 | API 版本。 |
电话号码 | 小路 | 真的 | 细绳 | 这是在步骤 1 中返回的响应。 在此步骤中，将号码复制并粘贴到回调 URL 中。 |
参数
标题
授权：持有者 {Access Token}
身体
姓名 | 类型 | 描述 |
|---|---|---|
代码方法 | 枚举 | 接收注册码的方法。 支持的值：SMS 和 Voice。 |
语言 | 枚举 | 您希望接收注册码的语言。 参见语言代码。 |
地位
姓名 | 描述 |
|---|---|
200 正常 | 成功。 |
回复
{
"成功": true
}
代码已通过所选方法（短信或语音）发送到正在迁移的电话号码。
步骤3：验证代码
回调URL
发帖： <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>
第 2 步中通过电话号码收到的代码（6 位密码）将用于验证所有权。
参数
标题
授权：持有者 {Access Token}
身体
姓名 | 类型 | 描述 |
|---|---|---|
代码 | 数量 | 完成第2步后收到6位数注册码。 |
状态
姓名 | 描述 |
|---|---|
200 正常 | 成功。 |
回复
{
"成功": true
}
确认手机所有权已得到验证。
步骤4：注册电话号码
回调URL
发布 <https://graph.facebook.com/{version}/{phoneNumberId}/register>
参数
标题
授权：Bearer {Access Token}（保持不变）
正文内容
姓名 | 类型 | 描述 |
|---|---|---|
消息传递产品 | 枚举 | 使用的消息服务。 在这种情况下，使用 "whatsapp"。 |
别针 | 数量 | 第 2 步后收到的 6 位数注册码。 |
状态
姓名 | 描述 |
|---|---|
200 正常 | 成功。 |
回复
{
"成功": true
}
该电话号码已成功注册到 WhatsApp Cloud API WABA。 您现在可以向目的地 WABA 发送消息。
WABA ID 未迁移。 新迁移的号码将与之前删除的号码的 WABA ID 相关联。
步骤 5：在 Meta Developer App 中检查已迁移的电话号码
可以通过 Meta Developer App 验证迁移是否成功。 为此，请按照下列步骤操作：
导航至 WhatsApp > 入门
在电话号码下拉列表中，确认号码存在且准确反映。
