Skip to content

Facebook 应用凭据(Facebook App credentials)#

你可以使用以下凭据验证以下节点:

🌐 You can use these credentials to authenticate the following nodes:

Facebook Graph API 凭证

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

支持的身份验证方法(Supported authentication methods)#

  • 应用访问令牌

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

🌐 Refer to Meta's Graph API documentation for more information about the service.

使用应用访问令牌(Using app access token)#

要配置此凭证,你需要一个 Meta for Developers 账户以及:

🌐 To configure this credential, you'll need a Meta for Developers account and:

  • 应用 访问令牌
  • 可选的 应用密钥:用于验证载荷的完整性和来源。

设置凭据共有五个步骤:

🌐 There are five steps in setting up your credential:

  1. 创建一个带有 Webhooks 产品的 Meta 应用
  2. 为该应用生成应用访问令牌
  3. 配置 Facebook 触发器
  4. 可选:添加应用密钥
  5. 应用审核:仅在您的应用用户本身没有应用角色时才需要。如果您是为自己的内部用途创建该应用,则不需要进行此操作。

请参阅以下各步骤的详细说明。

🌐 Refer to the detailed instructions below for each step.

创建 Meta 应用(Create a Meta app)#

要创建 Meta 应用:

🌐 To create a Meta app:

  1. 前往 Meta 开发者 应用仪表板 并选择 创建应用
  2. 如果你有商业组合并且准备将应用连接到它,请选择该商业组合。如果你没有商业组合或尚未准备好将应用连接到组合,请选择我暂时不想连接商业组合,然后选择下一步使用场景页面将打开。
  3. 选择 其他,然后选择 下一步
  4. 选择 业务 然后点击 下一步
  5. 填写必要信息:
    • 添加一个应用名称
    • 添加应用联系邮箱
    • 你可以在此处连接到业务组合,也可以跳过。
  6. 选择 创建应用
  7. 将产品添加到你的应用 页面打开。
  8. 从左侧菜单中选择 应用设置 > 基本
  9. 输入 隐私政策网址。(必须填写以使用“Live”应用。)
  10. 选择 保存更改
  11. 在页面顶部,将 应用模式开发 切换到 实时
  12. 在左侧菜单中,选择 添加产品
  13. 将产品添加到你的应用 页面出现。选择 Webhooks(网络钩子)
  14. Webhooks 产品已打开。

有关创建应用、所需字段(如隐私政策 URL)以及添加产品的更多信息,请参阅 Meta 的 创建应用 文档。

🌐 Refer to Meta's Create an app documentation for more information on creating an app, required fields like the Privacy Policy URL, and adding products.

有关应用模式及切换到实时模式的更多信息,请参阅应用模式发布 | 应用类型

🌐 For more information on the app modes and switching to Live mode, refer to App Modes and Publish | App Types.

生成应用访问令牌(Generate an App Access Token)#

接下来,创建一个应用访问令牌,供你的 n8n 凭据和 Webhooks 产品使用:

🌐 Next, create an app access token to be used by your n8n credential and the Webhooks product:

  1. 在另一个标签页或窗口中,打开 Graph API 探索器
  2. 访问令牌 部分选择你刚创建的 Meta 应用
  3. 用户或页面中,选择获取应用令牌
  4. 选择 生成访问令牌
  5. 该页面会提示你登录并授予访问权限。请按照屏幕上的提示操作。

    应用不可用

    你可能会收到应用不可用的警告。一旦你将应用上线,可能需要几分钟的时间才能生成访问令牌。

  6. 复制令牌并将其作为 访问令牌 输入到你的 n8n 凭证中。同时也将此令牌保存到其他地方,因为在配置 Webhooks 时你将需要它。

  7. 保存 n8n 凭据。

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

🌐 Refer to the Meta instructions for Your First Request for more information on generating the token.

配置 Facebook 触发器(Configure the Facebook Trigger)#

既然你已经获得了令牌,就可以配置 Facebook 触发器节点:

🌐 Now that you have a token, you can configure the Facebook Trigger node:

  1. 在你的 Meta 应用中,从顶部导航栏复制 应用 ID
  2. 在 n8n 中,打开你的 Facebook 触发器节点。
  3. App ID 粘贴到 APP ID 字段中。
  4. 选择执行步骤以将触发器切换到监听模式。
  5. 返回到打开了你的 Meta 应用 Webhooks 产品配置的标签页或窗口。
  6. 订阅你希望接收 Facebook 触发通知的对象。对于每个订阅:
    1. 从 n8n 复制 Webhook URL 并将其作为 回调 URL 输入到你的 Meta 应用中。
    2. 将你上面复制的 访问令牌 输入为 验证令牌
    3. 选择 验证并保存。(如果你的 n8n 触发器未在监听,此步骤将失败。)
    4. 某些 Webhook 订阅,例如 User,会提示你订阅单独的事件。请订阅你感兴趣的事件。
    5. 你可以从 Meta 发送一些 测试 事件来确认功能是否正常。如果发送了测试事件,请在 n8n 中验证其接收情况。

有关更多信息,请参阅 Facebook 触发节点 文档。

🌐 Refer to the Facebook Trigger node documentation for more information.

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

为了增强安全性,Meta 建议添加 应用密钥(App Secret)。这会使用 appsecret_proof 参数对所有 API 调用进行签名。应用密钥证明是使用你的应用密钥作为密钥,对访问令牌进行 sha256 哈希生成的。

🌐 For added security, Meta recommends adding an App Secret. This signs all API calls with the appsecret_proof parameter. The app secret proof is a sha256 hash of your access token, using your app secret as the key.

要生成应用密钥:

🌐 To generate an App Secret:

  1. 在 Meta 中查看你的应用时,从左侧菜单选择 应用设置 > 基本信息
  2. 应用密钥 字段旁选择 显示
  3. 该页面会提示你重新输入 Facebook 账户凭据。一旦你输入,Meta 就会显示应用密钥。
  4. 将其高亮以选择,复制,然后将其粘贴到你的 n8n 凭证中作为 应用密钥
  5. 保存你的 n8n 凭证。

有关更多信息,请参阅 应用密钥文档

🌐 Refer to the App Secret documentation for more information.

应用审核(App review)#

应用审核需要业务验证。

🌐 App Review requires Business Verification.

如果你的应用将由以下人群使用,则必须经过应用审核:

🌐 Your app must go through App Review if it will be used by someone who:

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

如果你的应用用户仅限于在应用本身拥有角色的用户,则无需进行应用审核。

🌐 If your only app users are users who have a role on the app itself, App Review isn't required.

作为应用审核流程的一部分,你可能需要申请 Webhook 订阅的高级访问权限。

🌐 As part of the App Review process, you may need to request advanced access for your webhook subscriptions.

有关更多信息,请参阅 Meta 的 应用审核高级访问 文档。

🌐 Refer to Meta's App Review and Advanced Access documentation for more information.

常见问题(Common issues)#

未验证应用限制(Unverified apps limit)#

Facebook 最多只允许你在 15 个尚未关联到 Meta 验证企业账户的应用上拥有开发者或管理员角色。

🌐 Facebook only lets you have a developer or administrator role on a maximum of 15 apps that aren't already linked to a Meta Verified Business Account.

如果你超过该限制,请参考 限制 | 创建应用

🌐 Refer to Limitations | Create an app if you're over that limit.