如何在 Facebook Developers 上设置 WhatsApp Cloud API

作者:xiaoxin.gao · 2025-09-19 · 阅读时间:4分钟

在本文中,我们将详细介绍如何在 Facebook Developers(现更名为 Meta for Developers)上设置 WhatsApp Cloud API,以便企业能够通过该 API 与客户进行更高效的沟通。

步骤 1:创建 Meta 账户和 WhatsApp Cloud API 应用

  1. 注册 Meta 开发者账户:访问 Meta for Developers 并使用您的 Facebook 凭证登录。
  2. 创建应用:点击 “Create App” 按钮。
  3. 选择应用类型:在 “What do you want your app to do?” 页面中选择 “Other” 类别。
  4. 选择业务类型:在下一个页面中选择 “Business” 选项并点击 “Next”。
  5. 填写应用信息:提供应用名称和联系邮箱。在 “Business Account” 字段中,选择现有的业务账户或选择 “No Business Manager account”(如果没有)。然后点击 “Create app” 按钮。
  6. 添加 WhatsApp 产品:在应用页面中,向下滚动以找到 WhatsApp 产品并点击 “Set up”。

步骤 2:添加联系信息

  1. 进入 WhatsApp > API Setup 页面:从侧边栏导航到该页面,然后向下滚动以找到 “Add phone number” 按钮。
  2. 设置 WhatsApp Business 配置文件:点击按钮后,会出现一个新窗口,用于设置您的 WhatsApp Business 配置文件。
  3. 链接电话号码:输入电话号码并选择验证方式以验证您的号码。请注意,一旦在此处关联电话号码,它将连接到 WhatsApp Cloud API,您将无法再使用该号码的移动应用。

步骤 3:设置 Webhooks

  1. 启用 Webhooks:从侧边栏导航到 “WhatsApp” 部分,然后选择 “Configuration” 链接。
  2. 编辑 Webhooks:点击 “Edit” 按钮,打开一个弹出窗口。
  3. 输入 Callback URL 和 Verify Token:在弹出窗口中,输入 Callback URL 和 Verify Token。例如,Callback URL 可以是 https://app.jalpi.com/api/v1/OfficialWhatsappHook,Verify Token 可以是 wa-smsidea
  4. 订阅 Webhook 字段:点击 “Manage” 按钮,然后在弹出窗口中点击每个字段前的 “Subscribe”。确保订阅所有字段,以便与您的消息服务无缝集成。
  5. 完成设置:点击 “Done” 按钮,完成 Webhooks 的设置。

步骤 4:创建永久访问令牌

  1. 进入 App Dashboard:点击页面顶部的 “App Dashboard” 按钮。
  2. 添加系统用户:在 “Business Settings” 页面中,点击 “System Users” 下的 “Add” 按钮。
  3. 创建系统用户:提供系统用户名称(例如 “system”),选择角色为 “Admin”,然后点击 “Create System User” 按钮。
  4. 添加资产:点击 “Add Assets”,选择 “Apps”,选择您的应用,并为 “Manage App” 启用 “Full Control”,然后点击 “Save Changes”。
  5. 生成永久令牌:点击 “Generate New Token” 按钮,选择您的应用,并将 “Token Expiration” 设置为 “Never”。在 “Available Permissions” 列表中,选择 “WhatsApp Business Messaging” 和 “WhatsApp Business Management”,然后点击 “Generate Token” 按钮。
  6. 复制访问令牌:生成访问令牌后,复制它。

步骤 5:在第三方平台(如 Jalpi)上完成设置

  1. 登录第三方平台:登录到您的 Jalpi 账户。
  2. 添加 WhatsApp 实例:在 “WhatsApp Instance > Add Instance” 下,更新所有字段,如 From Number、Permanent Access Token、Phone Number id、WhatsApp Business AccountId、WhatsApp Business ManagerId、App Id 等。
  3. 完成设置:更新详细信息后,您就可以开始接收用户发起的消息并回复了。如果您想直接向尚未与您的号码互动的人发送企业发起的消息,则需要完成下一步,即添加支付详情。

通过以上步骤,您可以在 Facebook Developers 上成功设置 WhatsApp Cloud API,从而实现与客户的高效沟通。