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)#
- 应用访问令牌
相关资源(Related resources)#
有关该服务的更多信息,请参阅 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:
- 创建一个带有 Webhooks 产品的 Meta 应用。
- 为该应用生成应用访问令牌。
- 配置 Facebook 触发器。
- 可选:添加应用密钥。
- 应用审核:仅在您的应用用户本身没有应用角色时才需要。如果您是为自己的内部用途创建该应用,则不需要进行此操作。
请参阅以下各步骤的详细说明。
🌐 Refer to the detailed instructions below for each step.
创建 Meta 应用(Create a Meta app)#
要创建 Meta 应用:
🌐 To create a Meta app:
- 前往 Meta 开发者 应用仪表板 并选择 创建应用。
- 如果你有商业组合并且准备将应用连接到它,请选择该商业组合。如果你没有商业组合或尚未准备好将应用连接到组合,请选择我暂时不想连接商业组合,然后选择下一步。使用场景页面将打开。
- 选择 其他,然后选择 下一步。
- 选择 业务 然后点击 下一步。
- 填写必要信息:
- 添加一个应用名称。
- 添加应用联系邮箱。
- 你可以在此处连接到业务组合,也可以跳过。
- 选择 创建应用。
- 将产品添加到你的应用 页面打开。
- 从左侧菜单中选择 应用设置 > 基本。
- 输入 隐私政策网址。(必须填写以使用“Live”应用。)
- 选择 保存更改。
- 在页面顶部,将 应用模式 从 开发 切换到 实时。
- 在左侧菜单中,选择 添加产品。
- 将产品添加到你的应用 页面出现。选择 Webhooks(网络钩子)。
- 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:
- 在另一个标签页或窗口中,打开 Graph API 探索器。
- 在 访问令牌 部分选择你刚创建的 Meta 应用。
- 在用户或页面中,选择获取应用令牌。
- 选择 生成访问令牌。
-
该页面会提示你登录并授予访问权限。请按照屏幕上的提示操作。
应用不可用
你可能会收到应用不可用的警告。一旦你将应用上线,可能需要几分钟的时间才能生成访问令牌。
-
复制令牌并将其作为 访问令牌 输入到你的 n8n 凭证中。同时也将此令牌保存到其他地方,因为在配置 Webhooks 时你将需要它。
- 保存 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:
- 在你的 Meta 应用中,从顶部导航栏复制 应用 ID。
- 在 n8n 中,打开你的 Facebook 触发器节点。
- 将 App ID 粘贴到 APP ID 字段中。
- 选择执行步骤以将触发器切换到监听模式。
- 返回到打开了你的 Meta 应用 Webhooks 产品配置的标签页或窗口。
- 订阅你希望接收 Facebook 触发通知的对象。对于每个订阅:
- 从 n8n 复制 Webhook URL 并将其作为 回调 URL 输入到你的 Meta 应用中。
- 将你上面复制的 访问令牌 输入为 验证令牌。
- 选择 验证并保存。(如果你的 n8n 触发器未在监听,此步骤将失败。)
- 某些 Webhook 订阅,例如 User,会提示你订阅单独的事件。请订阅你感兴趣的事件。
- 你可以从 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:
- 在 Meta 中查看你的应用时,从左侧菜单选择 应用设置 > 基本信息。
- 在 应用密钥 字段旁选择 显示。
- 该页面会提示你重新输入 Facebook 账户凭据。一旦你输入,Meta 就会显示应用密钥。
- 将其高亮以选择,复制,然后将其粘贴到你的 n8n 凭证中作为 应用密钥。
- 保存你的 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.