为什么 Facebook 主页 API 连接会失效,以及如何保持连接
Facebook 主页连接在 Meta 不再接受其访问令牌或不再发送其事件时失效:该令牌来自短期登录;用户更改了密码(错误 190,子代码 460);用户失去了主页上的角色(492);或在业务集成中移除了应用(458);某项权限 90 天未使用;应用处于闲置状态;或 Meta 限制了该主页。
easyCoexistence 会从长期登录中获取每个主页的访问令牌,每 6 小时检查一次主页,并在 Meta 拒绝访问令牌时向你发送邮件。
Meta 默认用户访问令牌和主页访问令牌的有效期;由长期用户访问令牌获取的主页访问令牌没有过期时间。
若在此期间没有任何登录、API 调用或 Webhook,Meta 会判定该应用不活跃,并使其所有访问令牌失效。
pages_manage_posts 和 read_insights 等主页权限不会随 90 天数据访问期限而过期。
Page Integrity 限制会阻止主页通过 Messenger Platform API 发送消息。
每 6 小时,easyCoexistence 会用一次轻量的 Graph 调用检查每个已连接的主页,若 Meta 拒绝访问令牌,则向所有者发送邮件。
哪些原因会导致主页连接失效?
原因分为四个层面:人员的登录、应用的权限和状态、主页本身,以及 Webhook 订阅。每种原因表现各异,大多数会返回错误 190,并附带一个说明原因的子代码:
为什么主页访问令牌会在数小时内过期?
因为它是用短期用户访问令牌从 /me/accounts 读取的,因此它本身也是短期的。Meta 的默认用户和主页访问令牌会在数小时内过期,短期令牌通常约一至两小时。若在服务器端使用 fb_exchange_token 进行交换,用户访问令牌约可有效 60 天,而用它读取的主页访问令牌没有过期时间。Meta 不会延长已过期的令牌:错误信息为 “Session has expired”,子代码为 463,此时该人员必须重新登录。
密码更改或安全检查之后会发生什么?
Meta 会使该人员的访问令牌失效。注销或更改密码会返回错误 190,子代码 460,即“会话无效,因为用户已注销”。Meta 同时警告,安全事件可能会在令牌预期到期之前使其失效。子代码 459 和 464 表示账户本身需要处理:该人员须在 facebook.com 登录以解决问题,然后重新登录应用。否则,解决办法是重新登录,可以由该人员本人完成,也可以由在该主页上拥有角色的其他人完成。
当人员失去其在主页上的角色时会怎样?
其主页访问令牌会因错误 190(子代码 492)而停止工作。Meta 将其描述为:与该主页访问令牌关联的用户在该主页上已不再拥有适当的角色。令牌按主页、人员和应用分别签发,因此其他拥有角色的人员的令牌仍然有效。解决办法是使用仍拥有完全控制权或任务访问权限的账户重新连接该主页,最好选择不会很快离开企业的账户。
当有人在业务集成中移除应用时会怎样?
Meta 会使应用为该人员持有的用户访问令牌失效,用它们读取的主页访问令牌也随之失效,并返回错误 190,子代码 458:用户未授权该应用。人员在 Facebook 设置的业务集成中移除应用后,Meta 随即调用应用的 deauthorize callback。系统用户令牌可以在 Business Manager 的业务设置、集成、已连接的应用中以相同方式终止,应用也可以通过 DELETE /{user-id}/permissions 结束自身的访问权限。
主页权限会在 90 天后过期吗?
存在两条不同的 90 天规则,其中只有一条会影响主页权限。数据访问过期会在人员最后一次活跃 90 天后切断应用的访问,但不适用于 pages_show_list、pages_manage_posts、pages_messaging、read_insights 以及 Meta 列明不会过期的其他主页权限。权限过期则会生效:应用 90 天未使用的权限可能会过期,即使是经 App Review 批准的权限,人员也必须重新授予。在新的登录授予该权限之前,需要它的调用会失败,返回错误代码 10 或 200 系列中的某个代码。
整个应用会失去访问权限吗?
会的,共有三种有文档记载的情况,Meta 会在应用控制台的警报收件箱中以紧急通知提前警告。若应用 90 天内没有登录、没有 Graph API 或 Marketing API 调用,也没有 Webhook 通知,则会被判定为不活跃,Meta 会使其所有访问令牌失效。在应用控制台中将其恢复,会把应用升级到最新版本,但旧令牌仍然失效,因长期未使用而被取消的权限需要重新经过 App Review。年度 Data Use Checkup 必须完成,违反 Meta 的条款或政策可能会限制 API 访问或撤销权限。
当 Meta 限制主页时会怎样?
受限的操作会失败,返回错误 368,即因违反政策而被暂时封锁;或针对消息的错误代码 10,子代码 1893063。Meta 的 Page Integrity API 会说明具体情况:使用拥有 pages_manage_metadata 权限的 GET /{page-id}/page_status,会返回 ok、warning、restricted 或 suspended 状态,以及每个生效中的限制(如 page_publish、page_read_only、page_messaging 或 page_messaging_api)及其 expiration_time,还有 FILE_APPEAL 等建议操作。business_integrity Webhook 字段会在变化发生时报告。
为什么事件停止了,而 API 调用仍然正常?
因为 Webhook 有其自身的失效方式。连续一小时的投递失败后,Meta 会发送“Webhooks Disabled”警报,并取消该应用与主页的订阅,直到重新订阅为止。对于在应用设置中关闭了 App platform 的主页,Meta 则完全不发送任何内容。在这两种情况下,令牌都可以保持有效,因此故障发生后,请检查 GET /{page-id}/subscribed_apps;待端点恢复响应后,使用主页的访问令牌向其发送 POST 请求。
如何在帖子发布失败前发现连接已损坏?
通过定期检查,因为 Meta 不会在令牌失效时通知应用。使用主页访问令牌执行轻量调用,例如 GET /{page-id}?fields=id,name,其失败方式与发帖相同。以应用的 ID 和密钥作为访问令牌调用 debug_token,会返回 is_valid、expires_at 和已授予的权限范围;对于已失效的令牌,还会返回错误代码和子代码。page_status 会报告限制情况,而 deauthorize callback 则会通知应用已被移除。
curl -G "https://graph.facebook.com/v26.0/debug_token" \
--data-urlencode "input_token=$PAGE_TOKEN" \
--data-urlencode "access_token=$APP_ID|$APP_SECRET"
# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops working如何重新连接主页?
使用与最初连接时相同的流程,由仍拥有该主页角色的人员操作,并在存在原因时先将其解决:被要求安全验证的账户需在 facebook.com 登录,受限状态需按建议操作处理,失效的端点则需再次返回 200。新的登录会返回新的令牌字符串,因此应替换已存储的令牌,而不是同时保留两者:
当主页连接中断时,easyCoexistence 会做什么?
它会监控能够察觉的中断,并告知你。每 6 小时,它会用 GET /{page-id}?fields=id,name 检查每个已连接的主页。当 Meta 以错误 190 或 102 拒绝访问令牌时,无论是在该次检查中还是在任何工具调用中,该主页都会被标记为“需要重新连接”,其所有者会收到一封邮件,合作伙伴平台也会收到 channel.disconnected。其他拒绝情况,如缺少权限或政策封锁,会在工具结果中以 Meta 的代码和消息返回。
当有人在业务集成中移除应用时,Meta 的 deauthorize callback 会通知 easyCoexistence,后者会移除该人员连接的主页、删除其访问令牌和事件目的地、将其从账单中移除,并发送 channel.removed。从控制台重新登录后,主页会以同一连接恢复,包括其评论规则和自动化,并重新订阅 feed、messages 和 mention。处于“需要重新连接”状态后,事件目的地同样会保留;移除之后,则需通过 set_social_webhook_destination 使用新密钥重新设置。
常见错误
- 重试错误 190。被拒绝的令牌每次调用都会以相同方式失败,只有拥有该主页角色的人员重新登录,才能获得有效的令牌。
- 为解除限制而重新连接。新令牌不会改变主页的状态;真正起作用的是 page_status 中的建议操作,例如申诉。
- 申请产品很少使用的权限。该权限若 90 天未使用可能会过期,届时需要它的调用就会失败;应在功能上线时再申请。
- 重新连接后仍保留旧令牌。新登录会返回不同的令牌字符串,仍持有旧令牌的任务会持续因错误 190 而失败。
一次 Facebook 登录即可让主页以同一连接恢复,并保留其评论规则和自动化。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并含前 3 天免费试用。
常见问题
用户访问令牌 60 天后过期时,主页访问令牌会失效吗?
如果它是通过 /me/accounts 使用该长期用户访问令牌读取的,则不会:这类主页访问令牌没有过期时间,不过本页列出的原因仍可能使其失效。
当主页访问令牌失效时,Meta 会通知我吗?
令牌失效时不会通知,下一次调用才会返回错误。当有人移除应用时,Meta 会调用应用的 deauthorize callback,并且会在应用控制台的警报收件箱中警告应用层面的风险。
其他人的访问令牌能让主页保持连接吗?
可以。主页访问令牌按主页、人员和应用分别签发,因此当某人的访问权限结束时,另一位仍在该主页上拥有角色的人员的令牌依然有效。
easyCoexistence 对 Facebook 主页收费多少?
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75。收费取决于连接数量,每个主页计为一个连接,并含前 3 天免费试用。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间