有关嵌入式注册的常见问题

WhatsApp Business 商业帐号所有权和共享

公司拥有各自的 WhatsApp Business 商业帐号 (WABA),也会在商务管理平台中看到该帐号。嵌入式注册流程完成后,将通过业务解决方案提供商 (BSP) 的注册网站自动与其共享对该 WABA 的访问权。公司无须采取任何行动即可将相应 BSP 添加到该 WABA 中。

请参阅 公司自有 WABA

公司与企业解决方案提供方 (BSP) 共享 WhatsApp Business 商业帐号时,BSP 将同时收到商务管理平台通知和邮件。请参阅 管理帐号 > 共享通知

目前,公司只能与企业解决方案提供方共享其 WhatsApp Business 商业帐号的访问权。我们将探索更多方案,以便公司在未来与多方共享访问权。

无须特意对 WABA 添加系统管理员用户,因为他们会自动获得所有素材的访问权。

建议采用的方法是使用有雇员访问权的系统用户,而这些用户则需要添加到创建的每个 WABA 中,因为默认情况下他们没有访问权。此建议完全基于潜在安全风险提出。由于系统用户访问口令的有效期很长,因此口令的泄漏可能会引发潜在的安全措施违反行为,特别是相应帐号对整个商业帐号有管理员权限的情况。即便如此,如果决定保留系统管理员用户,则无须将其添加到 WABA 中。

不能。目前公司不能限制访问,因为客户拥有并且可以在其 WhatsApp 管理工具中查看 WhatsApp Business 商业帐号。

注册流程

Once the Embedded Signup flow is complete and all the business profile information is captured, the certificate will be available for download.

Beginning May 2, 2022, after signup, a compliance check with the WhatsApp platform policies is auto-triggered and performed in the background. If this check fails, we notify businesses via email and the account is disabled. Businesses have the ability to appeal.

如果企业准备好增加商家发起的对话数量、添加其他电话号码或申请成为官方商业帐号,则该企业必须发起公司验证 (BV)。

企业达到自己的限制时,系统将指示企业按照产品内的指南发起 BV 以进行升级。当前的 BV 流程或 OBA 申请流程没有任何更改。获批后,企业便可以向 1,000 位独立客户发送商家发起的对话,并根据我们的发消息限制升级要求 增加对话数量

Beginning May 2, 2022, the display name review is initiated after Business Verification (BV) is completed. The display name can be updated at any time. Any updates to the display name post BV have to go through a review again. For more details, visit Display name documentation.

其他 WhatsApp 检查

公司注册完毕后,企业解决方案提供方即可下载证书。注册完毕时,还应该启动 WhatsApp Business API 客户端,以使公司可以在未认证的状态下发送信息。

对于试用体验过程中所用的电话号码,以及已对其完成所有审查(公司验证、WhatsApp 检查、显示名审查)的电话号码,均可下载证书。要下载证书,请使用 phone_numbers 端点 或 WhatsApp 管理工具。只有 BSP 才能下载证书,不许公司下载。

如果公司没有通过我们的检查,我们会断开其手机号的连接。我们通过电子邮件和商务管理平台通知向业务解决方案提供商 (BSP) 和公司发出通知。届时 WhatsApp 将禁用相应手机号,BSP 则必须关闭该公司的 WhatApp Business API 客户端实例。

某些商务管理平台帐户已由于其他原因而通过验证。如果商务管理平台已经通过验证,则仍需要先通过我们的其他检查(显示名、商业政策等检查),然后才能发送大量消息。在这些检查完成之前,这些平台仍有权在未通过验证时进行试用体验。

如果公司想要使用已通过验证的商务管理平台帐户,但不是该商务管理平台帐户的管理员,则可尝试执行以下操作:

  • 请求将其添加为商务管理平台帐户的管理员。
  • 要求商务管理平台的管理员逐步完成嵌入式注册流程。
  • 也可转而创建一个新商务管理平台帐户,然后用该帐户逐步完成公司验证。

应用审核

应用审核由两部分组成:

  1. 应用验证 — 评估应用程序是否有效,是否遵循所说明的用例,是否达到用户体验质量标准
  2. 权限审核 — 评估开发者是否只申请了所需权限

业务解决方案提供商 (BSP) 必须有 business_management 权限,才能管理其客户的商业帐号,以及与客户的公司共享抵用金额度。

企业解决方案提供方需要 whatsapp_business_management 权限来管理电话号码和消息模板、发送消息,以及为 WhatsApp Business 商业帐号指定用户。

展示您应用程序使用 business_managementwhatsapp_business_management 权限的清晰依据。您应添加一个嵌入式注册集成的演示视频,并通过详细的开发者说明来支持用例。

按照屏幕录制指南上传视频和录屏文件,其中要包含您的集成、集成完成后会产生的效果,以及用户如何在沙盒模式中发送消息。

商务应用会自动获准适用于商务应用类型的所有权限和功能的标准访问权限。此举能够帮助您获取屏幕录制文件,以展示所请求的各项权限的有效用例。详情请参阅访问级别文档

账单和支付

通过嵌入式注册流程注册的企业会请求访问企业解决方案提供方 (BSP) 的额度,以为访问 WhatsApp Business 开放平台付费。这意味着企业向 BSP 支付费用,BSP 会收到向 Meta 支付的费用的汇总结算单。

为授予企业访问权限,BSP 必须 共享其额度

目前,企业无法直接向 WhatsApp 付费。

企业解决方案提供方可以撤销 Meta 商务管理平台 内或具有一系列 API 调用权限的单个企业 对自己额度的访问权限

企业解决方案提供方 (BSP) 作为额度所有者,是所有共享 BSP 额度的企业的“付款方”。BSP 应该且将会向 Meta 支付这些企业在 WhatsApp Business API 方面的所有费用。

嵌入式注册流程

嵌入式注册流程仅适用于网页浏览器,不适用于移动设备或移动版浏览器。请确保您的客户了解如何在网页上注册。

Facebook 登录集成代码的编写语言是 Vanilla JavaScript,其支持任何前端资源库,以及任何您选择的 JavaScript 框架。

仅企业解决方案提供商 (BSP) 合作伙伴能够在其网站上使用嵌入式注册流程。我们不允许在任何第三方产品上使用此流程。如有变动,我们将提供更详细的指南。

企业注册使用的电话号码和显示名应该是企业想要配合 WhatsApp Business 开放平台使用的电话号码和显示名。我们非常不建议您使用测试电话号码或个人电话号码,或者测试显示名进行注册,因为后期可能很难更改这些信息。

若注册 WhatsApp Messenger 或 WhatsApp Business 应用时已经使用了某个电话号码,则企业无法再次使用此号码进行注册。

企业目前无法在此流程中通过 IVR 号码注册,因为他们将无法用此类电话号码进行认证。

企业服务提供方一注册电话号码,该号码就会上线。注册成功后,号码将在几分钟之内上线。

原显示名经过审查后,企业即可在商务管理平台更改其显示名。更改后,企业需再次进行显示名审查。

显示名通过审查之后,系统会通过邮件和商务管理平台通知向企业解决方案提供商 (BSP) 发送通知,此时,企业需要重新下载证书,并重新配置 WhatsApp Business API 客户。BSP 还可以设置 Webhooks,以追踪显示名更改

目前,企业无法访问直接支持。我们正在评估直接支持的长期计划,若有更新,我们会进行分享。

企业成功完成嵌入式注册流程后,将会发送 Facebook 登录回调。企业解决方案供应商能够查询近期共享的 WhatsApp Business 商业帐号,并下载证书。

对于企业解决方案提供方

企业成功完成嵌入式注册流程后,系统将会发送 Facebook 登录回调。企业解决方案提供方 (BSP) 能够查询近期共享的 WhatsApp Business 商业帐号,并下载证书。企业的 WhatsApp Business 商业帐号也可以与 BSP 共享。

BSP 还应该协助企业完成公司验证流程,确保企业了解相关流程,并能够提供正确的证明。

对于企业

完成注册流程并获得所有商业简介信息后,您可以下载证书。企业可以不限量回复客户发起的对话(24 小时消息时间范围),并且可以在连续 24 小时内向 50 位独立客户发送商家发起的对话。

如果企业准备好增加商家发起的对话数量、添加其他电话号码或申请成为官方商业帐号,则该企业必须发起公司验证。

验证 WhatsApp 公司帐户已关联有效的支付方式。如果未关联支付方式,则使用消息模板发送消息时会失败。

验证您的 Facebook 应用具有 business_managementwhatsapp_business_management 权限。若问题未能得到解决,请打开直接支持请求单,向支持部门提供应用信息以及重现此问题的步骤。

在嵌入式注册流程中,用户每次只能选择或创建一个 WhatsApp Business 商业帐号。不过,我们确实支持用户再次完成流程,并创建或选择另一个 WhatsApp Business 商业帐号。

请注意,嵌入式注册流程的主要变更在于,客户将同时拥有商务管理平台和 WhatsApp Business 商业帐号,并能与企业解决方案提供方共享。

嵌入式注册流程支持 30 种语言。本地化流程将根据最终客户使用 Facebook 的相应语言版本自动触发。详情请参阅概览,翻译

不能,此为所有企业解决方案提供方 (BSP) 须遵守的标准化流程,因此所有企业的注册体验均相同。BSP 可以控制嵌入式注册流程之前和之后的体验,包括后续步骤、将企业引导向何方等。

WhatsApp Business 商业帐号编号收集

企业完成嵌入式 oAuth 流程注册后,JavaScript 回调将会获得 accessToken,该口令可以与 调试口令端点 一同使用,以获取共享的 WhatsApp Business 商业帐号。

client_whatsapp_business_accounts 端点 还可以用于检索所有共享的 WhatsApp Business 商业帐号的清单。

使用 调试口令端点时,您将获得企业与您共享的一份完整的 WhatsApp Business 商业帐号清单。您可以随时将这些帐号编号与您这边现有的编号相匹配,从而筛选出重复内容。

调试口令端点返回的 target_ids企业通过嵌入式注册流程 与您共享的 WhatsApp Business 商业帐号编号。

The client_whatsapp_business_accounts endpoint returns all client-owned WhatsApp Business Accounts that are shared with the Solution Partner.

If two WhatsApp business accounts were created at the same time through the embedded signup flow, the API response captures both WhatsApp Business Accounts.

In order to detect new phone numbers added to a WhatsApp Business Account, we'd recommend using the phone_numbers endpoint. It returns all client-owned WhatsApp Business Accounts that have been assigned to the Solution Partner, regardless of whether it is new or has a phone number set up yet.

Clients can create multiple WhatsApp Business Accounts under the same business ID. Client’s business information can be fetched with the WhatsApp Business Account endpoint.

Example request

curl -i -X GET "https://graph.facebook.com/v21.0/{business-id}/
  owned_whatsapp_business_accounts?
  access_token=system-user-access-token"

Example response

{ 
    "data": [
        {
            "id": 1906385232711451, 
            "name": "My WhatsApp Business Account", 
            "currency": "USD", 
            "timezone_id": "1", 
            "message_template_namespace": "abcdefghijk_12lmnop" 
        },
       {
            "id": 1972385232711141, 
            "name": "My Regional Account", 
            "currency": "INR", 
            "timezone_id": "5", 
            "message_template_namespace": "12abcdefghijk_34lmnop" 
        },

    ],
    "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}

客户可以再次完成嵌入式注册流程,选择一个现有的 WhatsApp Business 商业帐号,并添加一个新的电话号码。为了检测此更改,您可以查询所有客户 WhatsApp Business 商业帐号的 phone_numbers 端点,以记下新添加的电话号码。

您可以根据创建时间筛选和排序 WhatsApp Business 商业帐号。

电话号码

如果企业的电话号码已经注册到 WhatsApp Messenger 或 WhatsApp Business 应用程序,则该电话号码将无法用于嵌入式注册。如果号码正用于 WhatsApp Business 应用程序,则企业需要将其删除。

如需了解有关删除号码并请求使用该号码进行 WhatsApp 嵌入式注册的说明,请参阅 迁移电话号码

如果帐号未经认证,则该电话号码可进行 30 天的未认证使用体验。在此期间,该电话号码可进行注册,并用于覆盖有限数量的用户。帐号和电话号码显示名经过认证后,该电话号码即可用于日常使用。

如果帐号在 30 天内未完成认证,未认证试用体验将过期,而该电话号码会被取消连接。当发生此情况时,企业需要认证帐号才能重新注册该电话号码。

如需将其他电话号码添加到 WhatsApp Business 商业帐号,企业可以访问他们的 Facebook 商业帐号并添加其他号码。

嵌入式注册目前并不支持检索电话号码节点。您可以通过在 WhatsApp Business 商业帐号节点调用 phone_numbers 连线以检索电话号码及证书信息,操作如下:

https://graph.facebook.com/v21.0/{{WABA-ID}}/phone_numbers?fields=display_phone_number,name_status,certificate,new_certificate,new_name_status

如需获取更多信息,请参阅 WhatsApp Business 商业帐号管理 > 注册

执行 API 调用

  • 须遵守标准图谱 API 流量限制企业用例流量限制
  • 多个系统用户会视为单个用户。
  • 使用 oAuth 流程返回的用户访问口令可增加用户数量,进而增加流量上限。
  • 用户访问口令 — oAuth 流程返回的短期口令,可用于获取与您共享的 WhatsApp Business 商业帐号的清单。请参阅 访问口令文档, 了解更多信息。
  • 系统用户口令 — 系统用户代表服务器或软件,向由您商务管理平台帐号所有或管理的资产发出 API 调用。系统用户口令为长期口令,并没有过期时间。这些口令仍然可能因为其他原因失效,但不会仅因时间原因而过期。如果您生成新的系统用户口令,所有旧口令仍会有效并具有与新口令相同的权限,除非权限被撤销。将系统用户添加到 WhatsApp Business 商业帐号后,您即可在之后发出 API 调用以管理该帐号。
如果目前已与 BSP 共享 WhatsApp Business 商业帐号,则可通过共享的 WhatsApp Business 商业帐号获取客户的商务管理平台编号。

在以下的例子中,请使用指定的 WhatsApp Business 商业帐号编号。

请求:
curl -i -X GET "https://graph.facebook.com/v21.0/
  {whatsapp-business-account-id}?fields=owner_business_info&
  access_token={system-user-access-token}"
响应:
{ 
  "owner_business_info": { 
    "name": "Client Business Name", 
    "id": "1972385232742147" 
  }, 
}

如果客户企业之前没有与 BSP 共享 WhatsApp Business 商业帐号,或者客户企业将 BSP 从 WhatsApp Business 商业帐号的合作伙伴中移除,BSP 将无法通过上述 API 调用获取客户商务管理平台编号。详情请查看未共享的 WhatsApp Business 商业帐号
在以下示例中,请将信用额度编号用作委托额度编号。

请求:
  curl -i -X GET "https://graph.facebook.com/v21.0/{extended-credit-id}/
  owning_credit_allocation_configs?
  receiving_business_id={clients-business-id}&
  fields=id,receiving_business&
  access_token={system-user-access-token}"
响应:
{
  "id": "1972385232742140", // Allocation config (i.e., credit sharing) id
  "receiving_business": {
    "name": "Client Business Name"
    "id": "1972385232742147"
  },
}

请求:
curl -i -X GET "https://graph.facebook.com/v21.0/{business-id}/
  extendedcredits?fields=id,legal_entity_name&
  access_token={system-user-access-token}"
响应:
{
  "data": [
    {
      "id": "1972385232742146",    
      "legal_entity_name": "Your Legal Entity",
    }
  ]
}

该特定系统用户并没有更新 WhatsApp Business 商业帐号 (WABA) 的权限。请确认该特定系统用户拥有 WABA 的访问权限。若尚无相应权限,请将该特定系统用户添加至 WABA。