使用嵌入式注册流程管理 WhatsApp 迁移过程

必备
  • 作为新客户或现有客户，如果您尚未使用新WhatsApp 自助服务入门流程，使用嵌入式注册流程。
    • 作为此 WABA 的一部分，注册至少一个新电话号码，并在您的 Genesys Cloud 组织中创建 WhatsApp 集成。 新的电话号码可以是测试号码或集成号码，一旦您将其他号码迁移到此 WABA，您就可以稍后删除它。 如果不通过嵌入式注册注册至少一个新号码，您就无法将 Genesys 信用额度或付款方式附加到 WABA。 如果没有有效的付款方式，WhatsApp 就无法将电话号码迁移到 WABA。 因此，您必须注册至少一个新号码。
  • 在 Meta Business Manager 中创建一个 Meta App，并将 WhatsApp 产品添加到其中。 您需要此应用程序设置来执行具有 WhatsApp 权限的 Graph API 请求，以启动电话号码迁移过程。 除了生成访问或用户令牌、行使权限和开始迁移之外，您不会将该应用程序用于任何其他目的。 迁移所有号码后，您可以稍后从 Business Manager 中删除该应用程序。 
  • 使用 Graph API 开始迁移。Genesys 无法代表您执行迁移，因为通过嵌入式注册创建的 WABA 归企业所有，而不是 Genesys 所有。

要使用 WhatsApp 产品创建 Meta 应用程序，请执行以下步骤：

  1. 在里面元业务设置页面上，执行以下操作：
    1. 帐户点击部分应用。
    2. 点击添加并选择创建新的应用 ID 。
    3. 在里面创建应用程序页面，选择其他。
    4. 在里面选择应用类型页面，选择商业。
    5. 单击 下一步。
    6. 在里面添加应用名称字段中，输入应用程序名称。
    7. （可选）在商业帐户字段中，选择 Genesys Cloud Services, Inc.
    8. 点击创建应用程序。 显示 Meta App 仪表板。
    9. 在里面将产品添加到您的应用页面中WhatsApp平铺，点击设置。
    10. 在里面快速开始页面左侧窗格中的应用审核， 点击权限和功能。
    11. 在里面权限和功能页面中搜索字段，类型为 business_management。
    12. 在权限和功能部分，查看 WhatsApp_business_management 和 business_management 选项，访问级别为标准访问。
  2. 导航至“元”选项卡并点击刷新。
  3. 在业务设置页面中查看您创建的 Genesys Cloud App。

创建应用程序后，请在应用程序中为您的 WhatsApp 产品配置测试 webhook 回调 URL。 要为您的 Meta 应用配置 WhatsApp Webhook 回调 URL，请执行以下步骤：

  1. 在独特的URL 查找器，创建唯一的 URL。 
  2. 在另一个浏览器选项卡中复制粘贴唯一的 URL，然后切换回您的 Webhook 站点 URL。
  3. 在 Webhook 站点 URL 中，执行以下操作：
    1. 在页面顶部，点击编辑。
    2. 在里面編輯 URL对话框中响应正文字段中，输入 $request.query.hub_challenge$ 作为变量。
    3. 单击 “ 保存”。
  4. 在 Meta 应用程序中，执行以下操作：
    1. 在左侧面板中，导航至WhatsApp > 配置， 点击编辑。
    2. 在里面编辑 Webhook 的回调 URL对话框中回调网址字段中粘贴唯一的 URL。 
    3. 在里面验证令牌字段中，输入令牌的详细信息（可以包括任何文本字符串）。
    4. 点击核实并保存保存您的配置。
  5. 在 Webhook 字段旁边，执行以下操作：
    1. 在下面编辑字段，点击管理。
    2. 在里面Webhook 字段对话框中订阅列中，选中订阅柱子。
    3. 单击 “ 完成”。

注意： 仅当您从 WhatsApp Cloud 平台上的另一个 BSP 迁移您的号码时，才需要设置 webhook。 如果您要将号码从 WhatsApp 内部平台或现有的 Genesys 拥有的 WABA 迁移到新的嵌入式 WABA，请直接启动电话迁移。

保持登录状态Meta 商业帐户并导航至Meta 的图形 API 浏览器。 在 API Explorer 页面的右侧，确保在使用 API 发出任何 POST 请求之前正确设置身份验证参数。
要启动手机迁移，请执行以下步骤：
  1. 在里面访问令牌对话框中元应用字段中，选择您之前创建的 Meta App 名称。
  2. 在里面用户或页面字段中，选择用户令牌。
  3. 在里面添加权限字段，包括whatsapp_业务_管理和business_management 权限在权限列表中。 如果没有，请点击下拉列表并选择它们。 您可以找到  whatsapp_业务_管理选项中的其他权限类别和商业管理在里面活动群组页面权限类别。
  4. 点击生成访问令牌按钮。 如果系统提示，请选择所有 WABA。 通常对于迁移，您只需选择要迁移该号码的 WABA。 访问令牌在闲置一段时间后将会过期。 若过期，请刷新页面或者重新生成token。
  5. 单击 “ 提交”。

要确认您是否已启动迁移，请导航至 WhatsApp 管理器，然后在帐户工具 > 电话号码，查看您添加到 WABA 的号码是否处于待处理或离线状态。

注意： 当您启动迁移时，它只会将号码添加到新的 WABA。 但是，在完成迁移之前，流量将流经与旧 WABA 关联的现有 WhatsApp 集成。

使用 Genesys Cloud 中的 WhatsApp 嵌入式注册流程并完成您的 WhatsApp 电话验证和注册。 如果该号码未禁用双重身份验证，则会验证该电话，但您无法创建嵌入式 WhatsApp 集成。 禁用 2FA 是一项硬性要求。 请联系GenesysCloudWhatsAppRequests@genesys.com在 Genesys 管理的旧 WABA 中禁用您的号码的两步验证。 如果您正在从另一个 BSP 迁移号码并且他们正在管理您的 WABA，那么您将需要让他们为您禁用它。

如果您的 API 请求成功并且您能够启动号码迁移，您就可以激活您的电话号码。 如果 API 请求返回错误，表明您的至少一个 Meta 应用必须订阅目标 WABA 的 webhook ，通过向以下地址发出 POST 调用，为目标 WABA 创建新的 webhook 订阅/WHATSAPP_BUSINESS_ACCOUNT_ID/已订阅应用程序端點。 

您可以通过向 /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps 端点发出 GET 调用来验证订阅是否成功。

笔记:为避免您的 WhatsApp 频道出现停机风险，对于生产号码，请在您的联络中心因业务关闭的计划维护时段内激活电话号码。 您的 WhatsApp 流量不会受到影响，并且不会切换，直到删除旧集成并在 GC 中创建并激活新集成。

要使用嵌入式注册流程激活电话号码，请执行以下步骤：

  1. 删除 Genesys Cloud 中与旧 WABA 的电话号码关联的当前 WhatsApp 集成。 在删除集成本身之前，您可能需要先删除与集成相关的消息路由。
  2. 为您作为新 WABA 的一部分发起的号码配置新的 WhatsApp 集成。 有关配置新 WhatsApp 集成的更多信息，请参阅使用嵌入式注册流程。 
  3. 完成该过程后，请执行以下操作： 
    1. 选择您的 Meta 商业帐户。
    2. 选择启动迁移后添加了号码的 WhatsApp 商业帐户。
    3. 选择迁移的电话号码/商业资料。
    4. 验证/注册号码并保存集成。

所有您批准的 WhatsApp 消息模板可能需要几分钟才能从旧的 WABA 自动迁移到新的 WABA。 完成后，一个新的消息模板命名空间由 WhatsApp 分配。要重新配置预设回复，请执行以下步骤：

  1. 登录您的元业务经理。
  2. 选择您的业务。
  3. 导航WhatsApp 管理器>帐户工具>消息模板
  4. 由于 WhatsApp 分配了新的命名空间，请重新配置 Genesys Cloud Org 中的消息模板/预设回复。有关如何添加 WhatsApp 模板消息和使用 WhatsApp 模板消息的更多信息，请参阅添加 WhatsApp 模板消息和使用 WhatsApp 模板消息。 

    如果您为目标 WABA 创建了新的 webhook 订阅并删除请求，请执行以下步骤：

    1. 在里面图形 API 浏览器，访问令牌部分，通过制作删除致电/WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps 端点。
    2. 输入 WhatsApp 商业帐户 ID。
    3. 单击 “ 提交”。