WhatsApp Business 开放平台

入门指南

本文档介绍了将嵌入式注册流程集成至您网站或客户网站所需完成的步骤以及满足的条件。

准备工作

如要开始集成嵌入式注册流程，您首先需要设置商务管理平台和 Meta 应用。

商务管理平台

您需要使用商务管理平台帐户来管理您的额度和已注册客户的 WhatsApp Business 商业帐号 (WABA)。如需了解创建商务管理平台帐户的相关信息，请参阅创建商务管理平台。完成商务管理平台设置后，请进行公司验证。

Meta 应用

在 Meta 开发者帐户中，创建应用，选择业务类型。您可以通过应用面板访问自己的任意 Meta 应用，以控制设置并请求权限。

业务应用会自动获准使用适用于业务应用类型的所有权限和功能的标准访问级别，因此您可以使用此访问权限级别开发并测试您的应用。

标准访问级别可有效限制业务应用，使其仅可访问由具有应用身份或公司身份的应用用户拥有的数据。如要发布 Meta 应用，则此应用必须通过应用审核，并请求 whatsapp_business_management 权限的高级访问级别。我们建议您尽快开始这一流程。您无需等待嵌入式注册全部实施完毕，即可开始此流程。

您还需要请求用于 WhatsApp 云端 API 的 whatsapp_business_messaging 权限，因为这是 API 调用的必要项。

强烈建议您不要请求除了这两项权限之外的其他权限，因为这会不必要地减缓您的注册流程。

访问口令

业务集成工具系统用户访问口令和系统用户访问口令都可以用来访问已注册客户的数据。您使用的口令类型取决于您要使用 Facebook 登录还是企业版 Facebook 登录来配置嵌入式注册，以及您是技术代理还是解决方案提供商。

技术代理

技术代理的首选口令是业务集成工具系统用户访问口令，因为这些口令的使用对象是单个客户。每当客户完成通过企业版 Facebook 登录进行配置的嵌入式注册时，系统都会向您返回代码。您可以通过更换此代码，获得业务集成工具系统用户访问口令。如果您使用通过 Facebook 登录进行配置的嵌入式注册（不推荐），则必须改为使用系统用户访问口令。

如果您使用系统用户访问口令，系统用户必须向您的应用授予 whatsapp_business_management 权限。

解决方案合作伙伴

您必须使用系统用户访问口令，才能与已注册的客户共享您的额度。对于所有其他请求，首选解决方案是使用业务集成工具系统用户访问口令。

每当客户完成通过企业版 Facebook 登录进行配置的嵌入式注册时，系统都会返回代码。您可以通过更换此代码，获得业务集成工具系统用户访问口令。如果您使用通过 Facebook 登录进行配置的嵌入式注册（不推荐），则必须改为使用系统用户访问口令。

请注意，对于系统用户访问口令，您的系统用户必须已向您的应用授予 whatsapp_business_management 权限（您可以在生成该口令时授予），并且您必须为系统用户授予财务编辑身份，他们才能与已注册客户共享您的额度。

如要向您的系统用户授予财务编辑身份，请执行以下操作：

  1. 登录 Meta Business Suite。
  2. 在左上角下拉菜单中找到您的商务管理平台帐户，并点击“设置”图标（齿轮）。
  3. 点击业务设置。
  4. 前往用户 > 系统用户。
  5. 编辑用户并向其授予财务编辑身份。

额度

您需要设置额度，才能通过 WhatsApp Business 开放平台发送消息。您需要与客户共享这一额度。因此，请确保您已接受商务管理平台中业务设置 > 支付下的《额度委托 API 条款》。

如需了解如何通过商务管理平台（而非通过 API）共享额度，请参阅分享月度结算访问权限。

WhatsApp Business 开放平台本地 API 客户端

如要使用本地 API，请确保您运行的 WhatsApp Business API 客户端版本尚未过期。

集成流程

作为集成流程的一部分，您的 Meta 应用必须通过应用审核，并请求 whatsapp_business_management 权限的高级访问级别。我们建议您尽快开始这一流程。您无需等待嵌入式注册全部实施完毕，即可开始此流程。

1：嵌入注册流程

设置 Facebook JavaScript SDK 和 Facebook 登录，以将注册流程嵌入您的网站或客户网站。您可以根据需要将此流程嵌入您所拥有的多个网页或网站。

2：与必要端点集成

嵌入注册流程后，将此流程与必要 API 端点集成，以完成集成流程。在转到下一步前，您必须完成以下操作：

完成注册后，请使用 message_templates 端点获取预先批准的消息模板和命名空间，这样企业便可以开始发送消息。

您必须使用安全的端点 (HTTPS)。详情请参阅登录安全。

3：订阅 WABA 以接收 Webhooks

企业完成注册后，您便可订阅所有希望接收 Webhooks 通知的 WABA。您可以将 Webhooks 设置为在以下情况下向您发送通知：

  • 电话号码显示名已更新；
  • 电话号码质量状态已更新；
  • 帐号已审核、升级或遭到禁用。

可选

您可以根据需要执行以下操作：

另请参阅