通过嵌入式注册在 WhatsApp Business 商业帐号之间迁移电话号码

本文档介绍如何使用嵌入式注册将公司电话号码从一个 WhatsApp Business 商业帐号 (WABA) 迁移至另一个同类型帐号。

客户可以在 WhatsApp Business 商业帐号 (WABA) 之间迁移其公司电话号码,并保留其显示名、质量评分、模板消息限制、官方商业帐号的状态和已批准的高质量模板。通常只在客户想要将其公司电话号码从一个解决方案合作伙伴转移到另一个合作伙伴时,才执行迁移。

为客户执行迁移有两种选择:通过嵌入式注册迁移,或通过编程迁移。

通过嵌入式注册迁移更为简单,是首选的解决方案,因为该方案可以由您的客户发起,可自动生成并授予所有必要资产的所有权,可向您的应用授予这些资产的访问权,并且需要的 API 调用更少。

通过编程迁移则必须由您来发起,需要的 API 调用更多,因为您必须确认所依赖的资产都配置正确,必须自己生成所有新的必要资产,且必须将这些资产与其他资产相关联。为此,仅在您将使用代表模式(即由您创建并拥有目标 WABA 及其资产,然后将其与客户共享)与客户合作时,才建议使用通过编程迁移。

如需通过编程迁移客户电话号码,请参阅我们的以编程方式在 WhatsApp Business 商业帐号之间迁移号码文档。

运作方式

客户可以使用由您实现的嵌入式注册(版本 2)开始迁移流程。嵌入式注册会提示客户提供他们的公司电话号码和一个新的目标 WhatsApp Business 商业帐号 (WABA)。

客户完成这一流程后,嵌入式注册会生成新的 WABA,将其与客户的 Meta 业务帐户相关联,向您的应用授予新 WABA 的访问权,然后返回新创建的 WABA 编号和公司电话号码编号。

您必须获取这些编号,将其与 API 一起用于共享您的额度、订阅 Webhooks 以及将此号码注册为使用云端 API。完成最后一步(注册)后,公司电话号码会与目标 WABA 重新关联,然后该号码便可再次用来收发消息。

由于客户的公司电话号码未更改,客户的显示名、质量评分、消息限制和官方商业帐号的状态都会保留下来。

此外,所有符合资格的模板还会在目标 WABA 中自动复制,并获得与来源 WABA 中对应模板相同的状态,并且可以继续使用在客户的公司电话号码上上传的所有媒体。

WhatsApp Business 商业帐号

嵌入式注册会为客户自动生成新 WABA,将其与客户的 Meta 业务帐户相关联,并向您的应用授予新 WABA 的访问权。

模板

模板会在目标 WABA 中自动复制,并获得与来源 WABA 中对应模板相同的质量评分和状态。

statusAPPROVEDquality_scoreGREEN 的模板才符合复制资格。如果目标 WABA 无法容纳所有新模板,我们将尽可能多地复制模板,直到达到目标 WABA 的模板数量上限。如果目标 WABA 需要使用未复制的模板,我们则必须重新创建这些模板并提交以供审批。

请注意,模板的质量评分会迁移。所有已迁移模板开始时的评分都为 UNKNOWN前 24小时,将一直保持该评分;这段时间之后,如果有足够的数据可用,将生成新的评分。

账单

迁移完成前发送的消��将计入之前解决方案合作伙伴的账单。迁移完成前发送的未送达消息,如在迁移完成后送达,将计入之前解决方案合作伙伴的账单。

迁移完成后发送的消息将计入新解决方案合作伙伴的账单。

停机时间

直到您执行了最后一步(注册),停机时间才开始。在此之前,公司电话号码可以不间断地用来收发消息。

您执行最后的注册步骤之后,停机时间便开始并持续到我们完成模板复制

模板复制完成后,公司电话号码将与客户的新 WABA 相关联,从而可再次用于收发消息。

流量限制

作为迁移流程的一部分而自动触发的模板复制不计入您的流量限制。但是,您执行的 API 调用一定会计入该限制。

限制

  • WhatsApp 发布的测试公司电话号码无法迁移。
  • 迁移后的公司电话号码只能注册为使用云端 API。
  • 如果���源 WABA 在本地 API 上,对话记录和已上传的媒体将不会迁移。
  • 公司手机号必须有一个已获批准的显示名(name_statusAPPROVED)。
  • 公司手机号不能有任何关联的待处理显示名更改请求。
  • 模板的质量评分会迁移。所有已迁移模板开始时的评分都为 UNKNOWN前 24小时,将一直保持该评分;这段时间之后,如果有足够的数据可用,将生成新的评分。

要求

客户

询问拥有公司电话号码的客户,确认他们符合以下要求。如果他们拥有 WABA,他们便可使用 Meta 商务管理平台(前往 WhatsApp 帐号 >(客户的 WABA 名称)> 设置)执行确认操作。如果没有 WABA,他们必须要求其 BSP 进行确认。

  • 他们的 Meta 业务帐户状态必须为已认证
  • 他们现有 WABA 的状态必须为已批准
  • 他们现有的 WABA 必须附有有效的支付方式(位于支付设置中)。
  • 他们的公司电话号码必须已禁用两步验证。拥有 WABA 的客户可以使用 WhatsApp 管理工具来禁用两步验证,否则必须要求其解决方案提供方代为操作。

解决方案提供方

必须至少有一个应用在目标 WABA 上订阅了 Webhooks(请参阅 Webhooks),而且您必须使用嵌入注册版本 2 并启用会话记录

迁移步骤

第 1 步:指示客户禁用两步验证

如果您尚未执行此步骤,应指示您的客户使用 WhatsApp 管理工具在其公司电话号码上禁用两步验证(或指示客户让其当前解决方案提供方代为操作)。

必须禁用两步验证,您才能完成剩余步骤。

第 2 步:显示嵌入式注册

引导客户访问由您实现的嵌入式注册(版本 2),并在此流程中收到提示时让客户提供其公司电话号码和显示名。

第 3 步:获取资产编号

客户完成上述流程时,获取负载中返回的公司电话号码编号和新 WABA。

第 4 步:共享您的额度

与 WABA 共享您的额度,正如您通过嵌入式注册帮助客户注册后通常执行的操作一样。

第 5 步:订阅 Webhooks

在客户的新 WABA 上,为您的应用订阅 Webhooks

第 6 步:将电话号码注册为使用云端 API

注册公司电话号码为使用云端 API(如果您无法将迁移后的公司电话号码注册为使用本地 API)。