入门指南

本指南将帮助您使用云端 API 收发您的第一条消息。您还将了解如何配置 Webhooks,以便用于应用示例。

本指南适用于为自己或所在组织开发应用的开发者。如果您正在为其他企业开发应用,请参阅解决方案提供方

前期准备

您需要提供:

第 1 步:将 WhatsApp 产品添加到您的应用

如果您之前新建了应用,此时系统将提示将产品添加到您的应用。向下滚动,在 WhatsApp 下,选择设置。或者,从我的应用屏幕中选择您的应用,然后可再次按照相同说明将所需 WhatsApp 产品添加到该应用。

如果您有 Meta 业务帐户 (MBA),在将 WhatsApp 产品添加到您的应用时,系统会提示附加该帐户。如果没有该帐户,系统将通过一些提示帮助您创建一个帐户。将 MBA 附加到应用后,您就可以立即开始测试应用。

将 WhatsApp 产品添加到您的应用具有以下好处:

  • 提示您创建 Meta 业务帐户(如果没有该帐户)。
  • 自动为您创建测试 WhatsApp Business 商业帐号。由于您未支付消息费用,该帐号受到多项限制,仅可用于测试和开发。
  • 创建测试公司电话号码,并将其与您的 WhatsApp Business 商业帐号相关联。通过此号码,您可以向最多 5 个收信人电话号码免费发送消息。
  • 创建一组预先批准的消息模板。

第 2 步:添加收信人号码

添加有效的 WhatsApp 号码(必须能接收您发送的测试消息)。

在应用面板的左侧菜单中,导航到 WhatsApp > API 设置。在发送和接收消息下,依次选择收信人字段和管理电话号码清单

您可以添加任何有效的 WhatsApp 号码作为收信人。收信人号码将在 WhatsApp 中收到用于验证该号码的验证码。

您验证收信人号码之后,该号码现在在收信人字段中应该为选中状态。如需再添加收信人(总数不超过 5 个),请重复此流程。

第 3 步:发送测试消息

将预先批准的 hello_world 模板消息发送到您选中的收信人号码。

WhatsApp > API 设置面板中:

  1. 确保发信人字段中已选中测试公司电话号码。
  2. 确保收信人字段中已选中您希望接收消息的收信人电话号码。如果添加了多个号码,便可一次发送多条消息。
  3. 使用 API 发送消息面板中,点击发送消息按钮;

或者,将 cURL 命令复制并粘贴到一个新终端窗口,然后运行该命令。

请注意,代码表明您将要发送一条模板消息 (”type”:”template”) 并确定要使用的特定模板 (”name”:”hello_world”)。

第 4 步:克隆我们的应用示例并配置 Webhooks

Webhooks 可帮助您接收特定对象变更的实时 HTTP 通知。在 WhatsApp 中,Webhooks 可以向您发送应用中许多事件的通知,如消息接收和读取通知,甚至帐号变更。

添加回调网址,以便查看 Webhooks 的内容。按照 Webhooks 测试指南中的回调网址示例克隆我们的应用示例,该应用示例将接收 Webhooks 通知并在屏幕上显示 JSON 负载。

设置了 Webhooks 之后,重新发送模板消息,然后作出相应回复。随后,您应该会看到 4 个单独的 Webhooks 通知:消息发送、已送达和读取通知,以及传入消息的内容。

第 5 步:(非必要)添加真实的公司号码

拥有测试公司号码和测试 WhatsApp Business 商业帐号之后,您便可开始开发应用了。在开发应用时,使用这些测试资产发送消息不收取费用。

您准备好开始向客户发送消息后,就可以在 API 设置面板中添加一个真实的公司电话号码,并创建一个真实的 WhatsApp Business 商业帐号。