跳到主要内容

Facebook App 凭据

这些凭据可用于以下节点的身份验证：

信息

Facebook Graph API 凭据

如果要为 Facebook Graph API 节点创建凭据，请按照 Facebook Graph API 凭据文档中的说明操作。

支持的身份验证方式 ​

  • App access token（应用访问令牌）

相关资源 ​

有关该服务的更多信息，请参阅 Meta Graph API 文档。

使用应用访问令牌 ​

配置此凭据需要一个 Meta for Developers 账号，以及：

  • 应用 Access Token（访问令牌）
  • 可选的 App Secret（应用密钥）：用于验证载荷的完整性及来源。

设置凭据需要五个步骤：

  1. 创建 Meta 应用，添加 Webhooks 产品。
  2. 为该应用生成应用访问令牌。
  3. 配置 Facebook 触发器。
  4. 可选：添加应用密钥。
  5. 应用审核：仅当应用用户在应用本身中没有角色时才需要。如果仅供内部使用，则无需此步骤。

各步骤的详细说明如下。

创建 Meta 应用 ​

创建 Meta 应用的步骤如下：

  1. 打开 Meta Developer 的应用控制台，选择 Create App（创建应用）。
  2. 填写应用详情：
    • 添加 App name（应用名称）。
    • 添加 App contact email（应用联系邮箱）。
  3. 选择符合应用用途的 Use case（使用场景）。Webhooks 产品属于 Meta 的 Business（业务）套件，因此选择 Other（其他），再选择 Next（下一步）。
  4. 将 App type（应用类型）设为 Business（业务），再选择 Next（下一步）。
  5. 如果你有业务资产组合，且已准备好将应用关联到它，请选择该业务资产组合。如果没有或尚未准备好关联，保留 No business portfolio selected（未选择业务资产组合）。
  6. 选择 Create app（创建应用）。
  7. 随后打开 Add products to your app（为应用添加产品）页面，选择 Webhooks。

创建应用、填写隐私政策 URL 等必需字段及添加产品的更多信息，请参阅 Meta 的创建应用文档。

将 Meta 应用上线 ​

信息

何时将应用切换为 Live（正式）模式

在 Development（开发）模式下，只有在应用中具有角色（管理员、开发者或测试者）的人才能进行身份验证或生成令牌。如果仅连接自己的账户，可将应用保持为开发模式。

  1. 从左侧菜单选择 App settings > Basic（应用设置 > 基本）。
  2. 输入 Privacy Policy URL（隐私政策 URL），这是将应用切换为 Live（正式）模式前的必填项。
  3. 选择 Save changes（保存更改）。
  4. 如果需要没有应用角色的用户进行身份验证，将 App Mode（应用模式）从 Development（开发）切换为 Live（正式）。

应用模式和切换为 Live（正式）模式的更多信息，请参阅应用模式和发布 | 应用类型。

生成应用访问令牌 ​

然后创建应用访问令牌，供 n8n 凭据和 Webhooks 产品使用：

  1. 在单独的选项卡或窗口中打开 Graph API explorer（Graph API 浏览器）。

  2. 在 Access Token（访问令牌）部分，选择刚创建的 Meta App（Meta 应用）。

  3. 在 User or Page（用户或公共主页）中，选择 Get App Token（获取应用令牌）。

  4. 选择 Generate Access Token（生成访问令牌）。

  5. 页面提示你登录并授予访问权限，请按照屏幕提示操作。

    应用不可用

    可能收到应用不可用的警告。将应用上线后，可能需要等待几分钟才能生成访问令牌。

  6. 复制令牌，填入 n8n 凭据的 Access Token（访问令牌）。还需将令牌另存一份，后续配置 Webhooks 时会用到。

  7. 保存 n8n 凭据。

生成令牌的更多信息，请参阅 Meta 的首次请求说明。

配置 Facebook Trigger ​

取得令牌后，即可配置 Facebook Trigger 节点：

  1. 在 Meta 应用中，从顶部导航栏复制 App ID（应用 ID）。
  2. 在 n8n 中打开 Facebook Trigger 节点。
  3. 将 App ID（应用 ID）粘贴到 APP ID 字段。
  4. 选择 Execute step（执行步骤），使触发器进入监听状态。
  5. 返回打开 Meta 应用 Webhooks 产品配置的选项卡或窗口。
  6. Subscribe（订阅）希望通过 Facebook Trigger 接收通知的对象。对于每个订阅：
    1. 从 n8n 复制 Webhook URL，填入 Meta 应用的 Callback URL（回调 URL）。
    2. 将上面复制的 Access Token（访问令牌）填入 Verify token（验证令牌）。
    3. 选择 Verify and save（验证并保存）。如果 n8n 触发器未处于监听状态，此步骤会失败。
    4. 某些 webhook 订阅（例如 User）会提示你订阅具体事件，请选择需要的事件。
    5. 可从 Meta 发送一些 Test（测试）事件，确认配置正常。发送后，请在 n8n 中确认已收到。

更多信息，请参阅 Facebook Trigger 节点文档。

可选：添加 App Secret（应用密钥） ​

为增强安全性，Meta 建议添加 App Secret（应用密钥），通过 appsecret_proof 参数为全部 API 调用签名。应用密钥证明是以应用密钥为键，对访问令牌计算得到的 SHA-256 哈希。

生成 App Secret 的步骤如下：

  1. 在 Meta 中查看应用时，从左侧菜单选择 App settings > Basic（应用设置 > 基本）。
  2. 选择 App secret（应用密钥）字段旁的 Show（显示）。
  3. 页面会提示你重新输入 Facebook 账户凭据。完成后，Meta 会显示 App Secret。
  4. 选中并复制该值，粘贴到 n8n 凭据的 App Secret（应用密钥）。
  5. Save（保存）n8n 凭据。

更多信息，请参阅 App Secret 文档。

应用审核 ​

应用审核要求完成业务验证。

如果应用将由符合以下情况的人员使用，必须经过应用审核：

  • 在应用本身中没有角色。
  • 在认领该应用的业务中没有角色。

如果全部应用用户都在应用本身中具有角色，则无需应用审核。

应用审核过程中，可能需要为 webhook 订阅申请高级访问权限。

更多信息，请参阅 Meta 的应用审核和高级访问权限文档。

常见问题 ​

未验证应用数量限制 ​

对于尚未关联到 Meta 已验证业务账户的应用，Facebook 最多允许你在 15 个应用中具有开发者或管理员角色。

超过此限制时，请参阅限制 | 创建应用。

本文为社区中文翻译。查看对应英文原文