登录开始免费试用
easyCoexistence 官方 API

如何将 Facebook Page 连接到 API 或 AI 代理

Facebook Page 通过 Facebook Login for Business 连接到 API 或 AI 代理。拥有该 Page 或可在其上执行任务的人,使用 Facebook 登录并批准应用的 Page 权限,包括发布内容、评论、Messenger 和洞察数据;随后应用从 /me/accounts 读取每个 Page 的访问令牌。若该令牌来自长期用户访问令牌,则没有到期日期。

easyCoexistence 通过 Facebook Login for Business 一次登录即可连接您的 Facebook Page,并加密保存每个 Page 的访问令牌,每 6 小时检查一次,使 Claude、ChatGPT 或您自己的平台能够通过 Meta 官方 API 发布、排期、回复评论和私信,并读取洞察数据。

Owner or task

要从某人处获取 Page 访问令牌,该人必须是该 Page 的拥有者,或能在其上执行任务。

Admin access

在 Facebook 界面中被授予 Page 管理员权限的人,可以执行该 Page 的所有任务。

No expiry

由长期用户访问令牌生成的长期 Page 访问令牌没有到期日期。

Task access

拥有任务权限的人通过 Meta Business Suite 等工具管理 Page,而非直接在 Facebook 上操作。

1 hour

easyCoexistence 连接链接在其会话过期前有效的时长。

谁可以连接 Page?

拥有该 Page 或可在其上执行任务的人,因为 Meta 只向这类人发放 Page 访问令牌。在 Facebook 的 Page 访问权限设置中,这指的是具有完全或部分控制权的 Facebook 访问权限,或通过 Meta Business Suite 或 Ads Manager 使用的任务权限;Meta 的 Pages API 概述补充说明,管理员权限涵盖所有任务。每次调用都会根据该人的任务进行检查,因此请使用对所需工作拥有相应权限的账户进行连接:

  • 发布帖子:CREATE_CONTENT。
  • 回复和删除评论:MODERATE。
  • Messenger 回复和私下回复:MESSAGING。
  • 洞察数据:ANALYZE。

登录时该人会看到什么?

Facebook 自己的登录窗口,由 Facebook Login for Business 运行。应用会打开 Facebook 登录对话框,并传入一个配置的 config_id,该配置指定了访问令牌类型、资产和所需权限;若使用用户访问令牌配置,该人会用个人 Facebook 账户登录,并授予应用访问其 Page 的权限。Facebook 返回一个 code,应用服务器将其兑换为用户访问令牌,再兑换为长期用户访问令牌,然后读取 /me/accounts,获取每个 Page 及其访问令牌。

每项权限的作用是什么?

该人会在同一窗口中一并批准这些权限,每项权限都会开放 Graph API 的一部分功能。easyCoexistence 请求以下九项权限,使智能体能够在 Page 上发布、回复和衡量效果;每项说明均取自 Meta 权限参考文档对该权限所允许内容的描述:

pages_show_listAccess the list of Pages a person manages
pages_read_engagementRead content the Page posted, and metadata and insights about the Page
pages_manage_postsCreate, edit and delete the Page's posts
pages_manage_engagementCreate, edit and delete comments posted on the Page
pages_read_user_contentRead what others post on the Page, such as posts, comments and ratings
pages_manage_metadataSubscribe to webhooks about activity on the Page, and update its settings
pages_messagingManage and access the Page's conversations in Messenger
read_insightsRead Insights data for Pages the person owns
business_managementRead and write with the Business Manager API

哪些 Page 会成为连接?

登录返回访问令牌的每个 Page 都会成为独立的连接,并与其他连接一样计费。若某个 Page 已在另一个 easyCoexistence 账户上使用,它会保留在该账户中,并被报告为已连接,因此即使有人拥有其访问权限,也无法将其从付费账户中移走。之后再次登录时,会引入此后新增的 Page,并刷新已连接 Page 的访问令牌。

如何连接到 easyCoexistence?

在控制台中通过一次登录完成:选择新建连接,然后选择 Facebook,使用管理该 Page 的 Facebook 账户登录,并选择 Page。尚未绑定银行卡的账户会先被要求绑定卡片,因为每个连接都会计费。Facebook 返回后,每个 Page 显示为已连接,easyCoexistence 会为其订阅动态、消息和提及的 Webhook 字段,加密保存其访问令牌,并每 6 小时检查一次。

1New connectionIn the easyCoexistence dashboard
2FacebookFacebook's own login window opens
3ApproveThe Pages and the nine permissions
4ConnectedEach Page ready for Claude, ChatGPT or your code

平台如何连接其客户的 Page?

通过 Partner API 使用托管连接链接。您的后端向 /api/v1/connect-sessions 提交请求,其中 channel 设为 facebook 并附带 redirect_url,然后将客户引导至返回的 url,客户在该页面继续使用 Facebook 登录,无需拥有自己的 easyCoexistence 账户。浏览器携带 session、status 和 channel_id 返回,您的后端随后通过 GET /connect-sessions/:id 进行确认。每个通过登录连接的 Page 都会触发 channel.connected 事件,并携带您的 external_ref,除非它已被标记给您的其他客户。

Create a connect session for a Facebook Page
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "facebook",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821"
  }'

连接后会发生什么?

该 Page 即可供在其上运行的任何功能使用。list_social_accounts 将其返回给 Claude、ChatGPT 或您自己的智能体;get_social_credentials 将其 Page ID 和 API 基础地址交给您的代码;设置端点后,其动态变化、Messenger 消息和提及会通过 set_social_webhook_destination 或 PUT /api/v1/channels/:id/webhook. 发送到您的端点。

连接为何会失败?

通常有以下四种原因,每种都有直接的解决方法:

  • 该人没有管理任何 Page:Facebook 不会返回可连接的 Page,因此请以有权访问该 Page 的人身份登录。
  • 该人取消了登录:不会连接任何内容,重新开始即可打开新的窗口。
  • 该 Page 已连接到另一个 easyCoexistence 账户:请先在该账户中将其移除。
  • 连接链接已超过一小时才被打开:请创建新的会话。

设置方法

  1. Check your accessMake sure your Facebook account has full control, partial control or task access on the Page.
  2. Start the connectionIn the easyCoexistence dashboard, choose New connection, then Facebook.
  3. Approve the permissionsSign in with Facebook and approve access for the Pages you want to connect.
  4. Point your AI at itAdd https://easycoexistence.com/api/mcp to Claude or ChatGPT, or call the Page from your own code.

常见错误

  • 通过即将离开公司的人员进行连接。Page 访问令牌依赖该人的访问权限,一旦其失去权限,令牌便会失效,因此请使用会长期保留的账户登录。
  • 仅依赖重定向中的 status。任何人都可以在 URL 中输入 status=connected,因此请从您的后端通过 GET /connect-sessions/:id 确认会话。
  • 在 Facebook 连接会话中发送 webhook_url。API 会拒绝该参数;连接成功后,请使用 PUT /api/v1/channels/:id/webhook 为每个 Page 设置事件转发。
  • 仅读取重定向中的 channel_id。一次 Facebook 登录可以连接多个 Page,因此请通过 GET /api/v1/channels 列出它们,并按 channel 和 external_ref 筛选。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费试用。

常见问题

我需要自己的 Meta 开发者应用才能连接 Page 吗?

不需要。easyCoexistence 的 Meta 应用会请求 Page 权限,因此该人只需用 Facebook 登录并批准这些权限,无需自己的应用、App Review 或 Business Verification。

具有任务权限的人可以连接 Page 吗?

可以,前提是这些任务涵盖所需工作:Meta 会向任何能在 Page 上执行任务的人发放 Page 访问令牌,然后根据该人的任务检查每次调用。

我可以连接多个 Facebook Page 吗?

可以。登录获取的每个 Page 都会成为独立的连接,随着您的连接总数增加,每个连接每月按 US$ 9 至 US$ 0.75 计费。

如果 Page 已在其他地方连接,该怎么办?

只要 Page 仍在第一个 easyCoexistence 账户上使用,它就无法加入第二个账户。请先在该账户中将其移除,然后重新连接。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间