N8N中文教程
集成节点/Built in_nodes/Credentials

WhatsApp Business Cloud 凭据#

你可以使用这些凭据来认证以下节点:

  • WhatsApp Business Cloud
  • WhatsApp Trigger

要求#

要为 WhatsApp 创建凭据,你需要以下 Meta 资产:

  • 一个 Meta 开发者 账户:开发者账户允许你创建和管理 Meta 应用程序,包括 WhatsApp 集成。

设置 Meta 开发者账户

  1. 访问 Facebook 开发者网站。
  2. 点击右上角的 开始使用(如果显示的是 我的应用,说明你已经设置了开发者账户)。
  3. 同意条款和条件。
  4. 提供用于验证的电话号码。
  5. 选择你的职业或角色。
  • 一个 Meta 商务套件:WhatsApp 消息服务需要一个 Meta 商务套件(以前称为 Business Manager 账户)。界面可能仍会显示任一名称。

设置 Meta 商务套件

  1. 访问 Facebook 商务平台。
  2. 选择 创建账户
    • 如果你已有 Facebook 商务账户和套件但想创建新的套件,请在左侧菜单中打开商务套件选择器,并选择 创建商务套件
  3. 输入 商务套件名称
  4. 输入你的 姓名
  5. 输入一个 商务邮箱
  6. 选择 提交创建
  • 一个配置了 WhatsApp 的 Meta 商务应用:拥有开发者账户后,你需要创建一个 Meta 商务应用。

使用 WhatsApp 设置 Meta 商务应用

  1. 访问 Meta 开发者应用仪表板。
  2. 选择 创建应用
  3. 为你的应用添加产品 中,点击 WhatsApp 卡片中的 设置。更多细节请参考 添加 WhatsApp 产品。
  4. 这将打开 WhatsApp 快速入门 页面。选择你的商务套件。
  5. 选择 继续
  6. 在左侧菜单中,进入 应用设置 > 基本
  7. 为该应用设置 隐私政策 URL服务条款 URL
  8. 应用模式 更改为 上线(Live)

支持的认证方法#

  • API key(API 密钥):用于 WhatsApp Business Cloud 节点。
  • OAuth2:用于 WhatsApp Trigger 节点。

相关资源#

更多服务信息,请参考 WhatsApp 的 API 文档。 Meta 将创建 WhatsApp 商业应用的用户归类为技术提供商(Tech Providers);更多信息请参阅 Meta 的 面向技术提供商的入门指南。

使用 API 密钥#

使用 WhatsApp Business Cloud 节点需要配置 WhatsApp API 密钥凭证。 要配置此凭证,您需要:

  • 一个 API 访问令牌(Access Token)
  • 一个 企业账户 ID(Business Account ID)

生成访问令牌的步骤如下:

  1. 访问 Meta 开发者应用控制台。
  2. 选择您的 Meta 应用。
  3. 在左侧菜单中,选择 WhatsApp > API 设置(API Setup)
  4. 点击 生成访问令牌(Generate access token),并确认您希望授予的权限。
  5. 复制生成的 访问令牌(Access token),并在 n8n 中将其填入 Access Token 字段。
  6. 复制 WhatsApp Business Account ID,并在 n8n 中将其填入 Business Account ID 字段。

有关上述步骤的更多说明,请参考 在 WhatsApp 上测试商业消息功能。 完成应用的全面验证和上线还需要进一步配置。更多信息请参阅 Meta 的 面向技术提供商的入门指南 第 5 步及后续内容。关于 Meta 应用审核(App Review)流程的详细信息,请参阅 应用审核指南。

使用 OAuth2#

使用 WhatsApp Trigger 节点需要配置 WhatsApp OAuth2 凭证。 要配置此凭证,您需要:

  • 一个 客户端 ID(Client ID)
  • 一个 客户端密钥(Client Secret)

要获取这些项目,请按照以下步骤操作:

  1. 访问 Meta for Developers 应用仪表板。
  2. 选择你的 Meta 应用。
  3. 在左侧菜单中,选择 App settings > Basic
  4. 复制 App ID,并在 n8n 凭据中将其输入为 Client ID
  5. 复制 App Secret,并在 n8n 凭据中将其输入为 Client Secret

完全验证并上线你的应用还需要进一步的配置。更多信息请参考 Meta 的 技术提供商入门指南 第 5 步及后续内容。有关 Meta 应用审核(App Review)流程的更多详情,请参阅 应用审核文档。