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)的完整性和来源
配置凭据共有五个步骤:
- 创建一个包含 Webhooks 产品的 Meta 应用。
- 为该应用生成一个应用访问令牌。
- 配置 Facebook 触发器。
- 可选:添加一个应用密钥。
- 应用审核(App Review):仅当你的应用用户在应用本身中没有角色时才需要。如果你是为自己内部用途创建该应用,则无需此步骤。
请参考以下每个步骤的详细说明。
创建一个 Meta 应用
要创建一个 Meta 应用,请执行以下操作:
- 进入 Meta 开发者 应用仪表板,然后选择 Create App(创建应用)。
- 如果你已有企业组合(business portfolio)并准备将应用关联到该组合,请选择对应的企业组合。如果你还没有企业组合,或暂时不想将其与组合关联,请选择 I don’t want to connect a business portfolio yet(我暂时不想关联企业组合),然后点击 Next(下一步)。此时会打开 Use cases(使用场景)页面。
- 选择 Other(其他),然后点击 Next(下一步)。
- 选择 Business(商业用途),然后点击 Next(下一步)。
- 填写必要信息:
- 添加一个 App name(应用名称)。
- 添加一个 App contact email(应用联系邮箱)。
- 此处你可以再次选择是否关联企业组合,也可以跳过。
- 点击 Create app(创建应用)。
- 此时会打开 Add products to your app(为应用添加产品)页面。
- 在左侧菜单中选择 App settings > Basic(应用设置 > 基本信息)。
- 输入一个 Privacy Policy URL(隐私政策网址)。(此步骤是将应用设为“上线”状态所必需的。)
- 点击 Save changes(保存更改)。
- 在页面顶部,将 App Mode(应用模式)从 Development(开发中)切换为 Live(已上线)。
- 在左侧菜单中选择 Add Product(添加产品)。
- 此时会显示 Add products to your app 页面,选择 Webhooks。
- Webhooks 产品页面将会打开。
更多关于创建应用、必填字段(如 Privacy Policy URL)以及添加产品的信息,请参阅 Meta 官方文档:Create an app。
有关应用模式及切换至 Live 模式的更多信息,请参考:App Modes 和 Publish | App Types。
生成应用访问令牌
接下来,生成一个应用访问令牌(App Access Token),供你的 n8n 凭据和 Webhooks 产品使用:
- 在新的标签页或窗口中,打开 Graph API Explorer。
- 在 Access Token(访问令牌)部分,选择你刚刚创建的 Meta App(Meta 应用)。
- 在 User or Page(用户或页面)选项中,选择 Get App Token(获取应用令牌)。
- 点击 Generate Access Token(生成访问令牌)。
- 页面会提示你登录并授权访问权限。请按照屏幕上的指引完成操作。
应用不可用
你可能会收到警告,提示该应用当前不可用。当你将应用设为“上线”状态后,可能需要等待几分钟才能成功生成访问令牌。
- 复制生成的令牌,并将其作为 Access Token(访问令牌)填入你的 n8n 凭据中。同时请在其他安全位置保存此令牌,因为后续配置 Webhooks 时也会用到它。
- 保存你的 n8n 凭据。
有关生成令牌的更多信息,请参阅 Meta 的 首次请求指南。
配置 Facebook 触发器#
现在你已经获得了访问令牌,可以配置 Facebook Trigger 节点:
- 在你的 Meta 应用中,从顶部导航栏复制 App ID。
- 在 n8n 中,打开你的 Facebook Trigger 节点。
- 将 App ID 粘贴到 APP ID 字段中。
- 点击 Execute step(执行步骤),使触发器进入监听模式。
- 返回到你打开 Meta 应用 Webhooks 功能配置的标签页或窗口。
- 订阅你希望接收 Facebook 触发通知的对象。对于每个订阅:
- 从 n8n 复制 Webhook URL,并将其填入 Meta 应用中的 Callback URL(回调 URL)。
- 将之前复制的 Access Token(访问令牌) 填入 Verify token(验证令牌) 字段。
- 点击 Verify and save(验证并保存)。(如果 n8n 触发器未处于监听状态,此步骤将失败。)
- 某些 Webhook 订阅(如 User(用户))会提示你选择具体的事件进行订阅。请选择你感兴趣的事件。
- 你可以从 Meta 发送一些 Test(测试) 事件以确认配置是否正常工作。发送测试事件后,请在 n8n 中确认是否成功接收到。
更多详细信息,请参考 Facebook Trigger 节点文档。
可选:添加 App Secret(应用密钥)#
为了增强安全性,Meta 推荐添加 App Secret(应用密钥)。这将使用 appsecret_proof 参数对所有 API 调用进行签名。该应用密钥证明(app secret proof)是使用你的应用密钥作为密钥,对访问令牌进行 sha256 哈希计算得到的结果。
生成 App Secret 的步骤如下:
- 在 Meta 中查看你的应用时,从左侧菜单选择 App settings > Basic(应用设置 > 基本信息)。
- 在 App secret(应用密钥) 字段旁点击 Show(显示)。
- 页面会提示你重新输入 Facebook 账户凭据。完成验证后,Meta 将显示 App Secret。
- 全选并复制该密钥,然后将其粘贴到 n8n 凭据中的 App Secret(应用密钥) 字段。
- 保存你的 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 获取更多说明。