我们正在推出一项更改,即:在嵌入式注册流程中保存口令后立即授予共享 API 访问权限。有关嵌入式注册流程中的意外问题或影响,请联系支持团队。

嵌入式注册

嵌入式注册是一个桌面端和移动端都兼容的身份验证和授权接口,可让您的业务客户轻松生成帮助其成功注册 WhatsApp Business 开放平台所需的资产。

发生错误
播放视频时出错

嵌入式注册流程从您的业务客户处收集与业务相关的信息,自动生成该开放平台所需的所有 WhatsApp 资产,并向您的应用授予这些资产的访问权限,以便您为业务客户迅速提供 WhatsApp 消息服务。

通过嵌入式注册注册的客户是其所有 WhatsApp 资产的拥有者,并可以通过其他 Meta 解决方案(如 WhatsApp 直达广告)来充分利用这些资产。

运作方式

嵌入式注册充分利用企业版 Facebook 登录产品和我们的 JavaScript SDK。配置完成后,您可以在自己的网站中添加一个链接或按钮,用于启动该流程。

系统将向点击该链接或按钮的业务客户显示一个新窗口。在该窗口中,客户可以:

  • 使用其 Facebook 或 Meta 公司凭证验证其身份
  • 向您的应用授予其 WhatsApp 资产的访问权限
  • 选择一个现有业务资产组合,或新建一个业务资产组合
  • 选择一个现有 WhatsApp Business 商业帐号 (WABA) 或新建一个帐号
  • 输入并验证其公司电话号码(该号码可以是客户自有或由您提供)
  • 输入一个可代替该号码出现在 WhatsApp 客户端中的显示名

成功完成后,嵌入式注册会将客户的 WABA 编号、公司电话号码编号和一个可交换的口令代码返回到生成该流程的窗口。您必须将这些数据发送到自己的服务器,并在一个服务器到服务器调用中将其用于:

  • 将此代码转换为客户范围业务口令
  • 将该客户的公司电话号码注册为用于云端 API
  • 为您的应用订阅有关客户 WABA 的 Webhooks
  • 与客户(仅限解决方案合作伙伴)共享您的额度

完成这些步骤后,如果您是解决方案合作伙伴或与解决方案合作伙伴合作,客户便可立即开始使用您或您合作伙伴的应用来发送消息。如果您不是解决方案合作伙伴,或者未与解决方案合作伙伴合作,则客户必须先将支付方式附加到他们的 WABA,然后才能开始发送消息。

限制

注册数量限制

默认情况下,在连续 7 天内,您最多可注册 10 个新业务客户。仅新注册的客户才会计入此限制。前往 WhatsApp 管理工具 > 合作伙伴概览面板,可查看您当前的已注册客户数量。如果达到此上限,您会收到邮件通知。

如果您完成公司验证、应用审核和访问权验证,我们会在连续 7 天内将您的新业务客户数量上限自动提高到 200。如需每周注册 200 个以上的客户,请申请成为 Meta 业务合作伙伴

业务客户发消息限制

通过嵌入式注册注册的业务客户在开始时遵循标准发消息限制,后续可通过使用 API 来提高发消息数量上限。

业务客户电话号码数量限制

  • 公司电话号码只能注册为用于云端 API。
  • 不支持已注册为用于 On-Premises API 的公司电话号码和当前与 WhatsApp 或 WhatsApp Business 应用一起使用的公司电话号码。
  • 通过嵌入式注册注册的业务客户在开始时默认遵循公司电话号码数量限制

默认流程

要了解嵌入式注册默认过程中,您的业务客户将看到的每个屏幕的说明,请参阅默认流程

请注意,如果您了解客户的业务信息,您可以添加这些数据,这可以大大减少客户必须与之互动的屏幕数量。

访问口令

嵌入式注册可生成业务集成工具系统用户访问口令(简称“业务口令”)。业务客户完成嵌入式注册流程时,一个可交换的口令代码将作为消息事件返回并由 JavaScript SDK 捕获。然后,您必须使用服务器到服务器调用将此代码转换为业务口令。

技术代理仅可使用业务口令。

如果您是解决方案合作伙伴,应使用系统用户访问口令(简称“系统口令”)来与已注册业务客户共享您的额度;对于其他任何目的,则应使用业务口令。请注意,此口令所代表的系统用户必须已向您的应用授予 business_management 权限,并且必须获得您业务资产组合的管理员财务编辑身份,才能将您的额度与他人共享。

权限

支持将嵌入式注册配置为向您的业务客户请求大多数权限,但是您可能仅需要以下权限:

  • whatsapp_business_management — 如果您的应用需要访问已注册客户的 WhatsApp Business 商业帐号设置和消息模板,此权限为必要项。
  • whatsapp_business_messaging — 如果您的应用需要访问已注册客户的公司电话号码设置,或者如果您的应用将被客户用来收发消息,此权限为必要项。

您可以指定应用在实现过程中需要哪些权限。

请注意,当应用处于开发模式时,系统将在嵌入式注册的授权屏幕中向拥有该应用的管理员开发者测试者身份的任何用户显示这些权限。但是,在您将应用切换到上线模式后,仅通过应用审核流程获得高级访问级别批准的权限才会显示在此流程中。

账单

解决方案合作伙伴

如果您是解决方案合作伙伴,您必须已有一个额度,并且已在 Meta Business Suite 的业务设置 > 支付面板中接受《额度委托 API 条款》。此外,作为注册流程的一部分,您必须与任何客户共享自己的额度。

技术代理与技术合作伙伴

如果您是技术代理或技术合作伙伴,您的已注册业务客户必须在其 WhatsApp Business 商业帐号中添加一个支付方式。有关添加方法,请参阅我们帮助中心文章将信用卡添加至 WhatsApp Business 开放平台帐号中介绍的步骤。

555 公司电话号码

对于已认证企业和云端 API 发消息数量上限已提高的企业,其业务客户有资格使用 555 公司电话号码(最多两个)。

这些号码在运作方式上与标准公司电话号码相同(显示名必须经过审核和批准,必须遵循基于对话的定价规则,受到质量评分的影响等等),而两者主要区别在于 555 号码:

  • 具有美国国家呼叫代码 (+1)
  • 具有 555 区号
  • 自动验证
  • 无法迁移到其他 WhatsApp Business 帐号,也无法在 WhatsApp Business 开放平台以外的平台使用

如果您的企业客户有资格使用 555 号码,并希望注册这样一个号码作为额外号码,请指示客户再次执行您实现的嵌入式注册。系统在要求企业客户选择一个公司电话号码时,会自动向其提供选择一个 555 号码的选项:

应用审核

在您的应用获准使用每项必要权限的高级访问级别之前,您将无法帮助业务客户进行注册。

请参阅应用审核,详细了解应用审核以及您成功完成该流程所必须提供的资料。

集成帮手

嵌入式注册集成帮手是应用面板中的一个设置和测试工具。使用该工具可执行以下操作:

  • 在各种流程配置中启动嵌入式注册
  • 查看企业客户完成此流程时系统返回的数据
  • 生成实现代码和注册查询(您可以将其复制粘贴到自己的网站、企业客户网站以及服务器)
  • 将 API 查询发送到帮助要完成此流程的客户注册时将需要使用的端点

前往应用面板 > WhatsApp > ES 集成工具,可访问集成帮手。

Webhooks

作为注册流程的一部分,您必须在完成嵌入式注册流程的每个业务客户的 WABA 上为自己的应用订阅 Webhooks。

根据您已订阅的 Webhooks 字段,Webhooks 将被触发并发送到该应用上配置的回调网址。这意味着您所有已注册业务客户的所有 Webhooks 都将发送到该应用的回调网址。但是,您可以覆盖个人 WhatsApp Business 商业帐号或公司电话号码上的回调网址。请参阅 Webhooks 覆盖,了解操作方法。

本地化

嵌入式注册流程支持 30 种语言。本地化流程将根据业务客户使用 Facebook 的相应语言版本自动触发。

阿拉伯语、捷克语、丹麦语、希腊语、英语(英国)、西班牙语(西班牙)、西班牙语、芬兰语、法语(法国)、希伯来语、印地语、匈牙利语、印度尼西亚语、意大利语、日语、韩语、挪威语(书面语)、荷兰语、波兰语、葡萄牙语(巴西)、葡萄牙语(葡萄牙)、罗马尼亚语、俄语、瑞典语、泰语、土耳其语、越南语、简体中文(中国)、繁体中文(香港)、繁体中文(台湾)。

后续步骤

了解如何在您的网站或门户中实现嵌入式注册