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

Facebook 应用凭据#

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

  • Facebook 触发器 (Facebook Trigger)

Facebook Graph API 凭据 如果你想为 Facebook Graph API 节点创建凭据,请参考 Facebook Graph API 凭据 文档中的说明。

支持的认证方式#

  • 应用访问令牌(App access token)

相关资源#

更多服务信息,请参阅 Meta 的 Graph API 文档。

使用应用访问令牌#

要配置此凭据,你需要一个 Meta for Developers 账户,以及以下内容:

  • 一个应用 访问令牌(Access Token)
  • 可选的 应用密钥(App Secret):用于验证负载(payload)的完整性和来源

配置凭据共有五个步骤:

  1. 创建一个包含 Webhooks 产品的 Meta 应用。
  2. 为该应用生成一个应用访问令牌。
  3. 配置 Facebook 触发器。
  4. 可选:添加一个应用密钥。
  5. 应用审核(App Review):仅当你的应用用户在应用本身中没有角色时才需要。如果你是为自己内部用途创建该应用,则无需此步骤。

请参考以下每个步骤的详细说明。

创建一个 Meta 应用

要创建一个 Meta 应用,请执行以下操作:

  1. 进入 Meta 开发者 应用仪表板,然后选择 Create App(创建应用)。
  2. 如果你已有企业组合(business portfolio)并准备将应用关联到该组合,请选择对应的企业组合。如果你还没有企业组合,或暂时不想将其与组合关联,请选择 I don’t want to connect a business portfolio yet(我暂时不想关联企业组合),然后点击 Next(下一步)。此时会打开 Use cases(使用场景)页面。
  3. 选择 Other(其他),然后点击 Next(下一步)。
  4. 选择 Business(商业用途),然后点击 Next(下一步)。
  5. 填写必要信息:
    • 添加一个 App name(应用名称)。
    • 添加一个 App contact email(应用联系邮箱)。
    • 此处你可以再次选择是否关联企业组合,也可以跳过。
  6. 点击 Create app(创建应用)。
  7. 此时会打开 Add products to your app(为应用添加产品)页面。
  8. 在左侧菜单中选择 App settings > Basic(应用设置 > 基本信息)。
  9. 输入一个 Privacy Policy URL(隐私政策网址)。(此步骤是将应用设为“上线”状态所必需的。)
  10. 点击 Save changes(保存更改)。
  11. 在页面顶部,将 App Mode(应用模式)从 Development(开发中)切换为 Live(已上线)。
  12. 在左侧菜单中选择 Add Product(添加产品)。
  13. 此时会显示 Add products to your app 页面,选择 Webhooks
  14. Webhooks 产品页面将会打开。

更多关于创建应用、必填字段(如 Privacy Policy URL)以及添加产品的信息,请参阅 Meta 官方文档:Create an app。

有关应用模式及切换至 Live 模式的更多信息,请参考:App Modes 和 Publish | App Types。

生成应用访问令牌

接下来,生成一个应用访问令牌(App Access Token),供你的 n8n 凭据和 Webhooks 产品使用:

  1. 在新的标签页或窗口中,打开 Graph API Explorer。
  2. Access Token(访问令牌)部分,选择你刚刚创建的 Meta App(Meta 应用)。
  3. User or Page(用户或页面)选项中,选择 Get App Token(获取应用令牌)。
  4. 点击 Generate Access Token(生成访问令牌)。
  5. 页面会提示你登录并授权访问权限。请按照屏幕上的指引完成操作。

应用不可用

你可能会收到警告,提示该应用当前不可用。当你将应用设为“上线”状态后,可能需要等待几分钟才能成功生成访问令牌。

  1. 复制生成的令牌,并将其作为 Access Token(访问令牌)填入你的 n8n 凭据中。同时请在其他安全位置保存此令牌,因为后续配置 Webhooks 时也会用到它。
  2. 保存你的 n8n 凭据。

有关生成令牌的更多信息,请参阅 Meta 的 首次请求指南。

配置 Facebook 触发器#

现在你已经获得了访问令牌,可以配置 Facebook Trigger 节点:

  1. 在你的 Meta 应用中,从顶部导航栏复制 App ID
  2. 在 n8n 中,打开你的 Facebook Trigger 节点。
  3. App ID 粘贴到 APP ID 字段中。
  4. 点击 Execute step(执行步骤),使触发器进入监听模式。
  5. 返回到你打开 Meta 应用 Webhooks 功能配置的标签页或窗口。
  6. 订阅你希望接收 Facebook 触发通知的对象。对于每个订阅:
  7. 从 n8n 复制 Webhook URL,并将其填入 Meta 应用中的 Callback URL(回调 URL)
  8. 将之前复制的 Access Token(访问令牌) 填入 Verify token(验证令牌) 字段。
  9. 点击 Verify and save(验证并保存)。(如果 n8n 触发器未处于监听状态,此步骤将失败。)
  10. 某些 Webhook 订阅(如 User(用户))会提示你选择具体的事件进行订阅。请选择你感兴趣的事件。
  11. 你可以从 Meta 发送一些 Test(测试) 事件以确认配置是否正常工作。发送测试事件后,请在 n8n 中确认是否成功接收到。

更多详细信息,请参考 Facebook Trigger 节点文档。

可选:添加 App Secret(应用密钥)#

为了增强安全性,Meta 推荐添加 App Secret(应用密钥)。这将使用 appsecret_proof 参数对所有 API 调用进行签名。该应用密钥证明(app secret proof)是使用你的应用密钥作为密钥,对访问令牌进行 sha256 哈希计算得到的结果。

生成 App Secret 的步骤如下:

  1. 在 Meta 中查看你的应用时,从左侧菜单选择 App settings > Basic(应用设置 > 基本信息)
  2. App secret(应用密钥) 字段旁点击 Show(显示)
  3. 页面会提示你重新输入 Facebook 账户凭据。完成验证后,Meta 将显示 App Secret。
  4. 全选并复制该密钥,然后将其粘贴到 n8n 凭据中的 App Secret(应用密钥) 字段。
  5. 保存你的 n8n 凭据。

更多详细信息,请参考 App Secret 文档。

应用审核(App review)#

应用审核需要完成企业验证(Business Verification)。

如果你的应用将被以下用户使用,则必须通过应用审核流程:

  • 未在该应用中拥有任何角色的用户。
  • 未在已声明该应用的企业中拥有任何角色的用户。

如果您的应用用户仅限于在该应用中拥有角色的用户,则无需进行应用审核(App Review)。 在应用审核过程中,您可能需要为您的 webhook 订阅申请高级访问权限(advanced access)。 更多信息,请参考 Meta 的 App Review 和 Advanced Access 文档。

常见问题#

未验证应用的数量限制#

Facebook 规定,您最多只能在 15 个尚未关联到 Meta Verified Business Account 的应用上拥有开发者或管理员角色。 如果您超出此限制,请参阅 Limitations | Create an app 获取更多说明。