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

为何 Instagram API 连接会停止工作,以及如何保持连接

当 Meta 不再接受某个 Instagram API 连接的令牌,或该账户不再符合条件时,连接就会停止工作:长期访问令牌超过 60 天未刷新、更改密码、所有者移除权限或整个应用、切换为个人账户,或账户受到限制。每种情况都会返回各自的错误,大多数情况只需所有者重新登录即可修复。

easyCoexistence 全天候监控每个 Instagram 连接:在 60 天期满之前很早刷新令牌,每 6 小时检查一次账户,并在 Meta 拒绝访问时向您发送一次邮件,同时向平台发送 channel.disconnected,因此断开的连接只需一次登录即可恢复。

60 days

超过 60 天未刷新的 Instagram 令牌会过期,且无法再刷新。

460

错误代码 190 下的 Graph API 子代码,表示会话因更改密码而结束;该用户需要重新登录。

1 hour

在 Meta 停用消息 Webhook 投递并取消应用对该账户的订阅之前,累计的失败投递次数。

28 days

Meta 可能会终止应用对 28 天内未使用的权限或功能的访问权限。

6 hours

easyCoexistence 检查每个已连接 Instagram 账户的频率,并会在 60 天期满之前很早为令牌续期。

为什么 Instagram API 连接会停止工作?

因为 Meta 不再接受该令牌,或该账户不再符合 API 的使用条件。Meta 的文档列出了这些原因,每种原因都说明 API 返回的内容,以及恢复访问所需的步骤。这些问题大多会先以调用失败的形式显现,因此下文的检查会按计划查找它们:

What the API returnsWhat restores it
Token not refreshed for 60 daysCode 190; a refresh is no longer possibleThe owner signs in again
Password changedCode 190 with subcode 460The owner signs in again
Permission missing or removedCode 10, or a code from 200 to 299A new sign-in that grants it
App removed in Instagram's settingsA call to the app's deauthorize callbackA new sign-in, if the owner wants it back
Switched to a personal account(#10) Access is denied because the instagram account type is not business or creator.Back to Business or Creator, then a new sign-in
Allow access to messages offCode 200 with subcode 2534041, on DMsThe owner turns the setting back on
Account restricted, inactive or checkpointedCode 25 with subcode 2207050The owner acts in the Instagram app
Webhook endpoint failing for an hourA Webhooks Disabled alert, the account unsubscribedA working endpoint, then a new subscription

令牌何时过期,何时仍可刷新?

使用 Instagram 登录时,长期访问令牌自上次刷新起有效 60 天。使用 grant_type=ig_refresh_token 刷新,可再获得 60 天有效期,前提是令牌至少已存在 24 小时、尚未过期,并且所有者已授予 instagram_business_basic 权限。超过 60 天后,调用会以错误代码 190 失败,只有重新登录才能恢复。使用统一登录时,由配置决定令牌是否会过期。

更改密码和移除权限会造成什么影响?

更改密码可能会结束令牌所属的会话。Meta 的 Graph API 错误指南将其报告为错误代码 190,子代码 460,并说明该用户必须重新登录应用。从未授予或已被移除的权限会返回错误代码 10,或 200 至 299 之间的错误代码;在私信方面,错误代码 200 加子代码 2534041 表示所有者已关闭消息访问权限。Meta 平台条款还允许其终止应用对 28 天未使用的权限或功能的访问权限。

所有者移除应用后会发生什么?

应用对非公开数据的访问随即结束。所有者可在 Instagram 中依次进入“网站权限”、“应用和网站”、“活跃”,移除该应用;Meta 随后会调用应用业务登录设置中保存的 deauthorize 回调 URL。Instagram 帮助中心称,此后已移除的应用只能访问该账户的公开信息,因此在所有者重新登录之前,连接即告结束。

账户类型更改或受到限制时会发生什么?

两者任一都会使账户超出 API 的服务范围。Meta 的 API 仅适用于专业账户,其统一登录故障排除表给出了一条消息:对于已切换为个人账户的账户,会返回 (#10) Access is denied because the instagram account type is not business or creator。所有者需切换回专业账户,然后重新连接。受限、未激活或需要安全验证的账户会返回错误代码 25,子代码 2207050,所有者需在 Instagram 应用中解决该问题。

Webhook 如何停止接收?

通过失败的端点。Meta 会对 Instagram 通知重试最多 36 小时,但消息投递的标准更严格:失败 15 分钟后,警报会发送至开发者账户;一小时后,Meta 会发出“Webhooks Disabled”警报,并取消应用对该账户的订阅。端点恢复正常后,使用相同字段发送 POST /<IG_ID>/subscribed_apps,即可重新开启通知。

如何在用户发现之前察觉断开?

按计划检查连接,而不是等待帖子发布失败:

  • 每次交换和刷新令牌后存储 expires_in,并在令牌存在满一天后,于第 60 天之前很早进行刷新。
  • 按计划发起一次低成本的已认证调用,例如 GET /me?fields=user_id,username,并将错误代码 190 或 102 视为需要重新连接。
  • 提供 deauthorize 回调,使 Instagram 设置中的移除操作能立即通知您。
  • 阅读开发者警报,以及应用上的业务邮箱,Meta 会在这些地方发送 Webhook 和审核通知。
  • 按账户记录每个错误的代码、子代码和 fbtrace_id,以便将受限情况与错误请求区分开来。

如何为每种情况重新连接?

大多数原因都通过同一步骤解决:由账户所有者重新登录,从而签发新的代码和令牌。例外的是所有者在 Instagram 应用中更改的设置:

  • 令牌过期、更改密码、应用或权限被移除:让所有者重新完成登录,并批准权限。
  • 个人账户:在 Instagram 应用中切换回专业账户或创作者账户,然后重新登录。
  • 私信已关闭:在“已连接的工具”下开启“允许访问消息”;无需重新登录。
  • 账户受限:完成 Instagram 应用的要求;重新登录无济于事。
  • Webhook 已停用:修复端点,然后重新订阅该账户。

easyCoexistence 如何保持连接?

它全天候监控每个已连接的 Instagram 账户。当剩余有效期不足 60 天中的 20 天时,它会刷新令牌;每 6 小时使用 GET /me 检查一次账户;一旦 Meta 拒绝令牌,无论是在该检查中还是在工具调用中,它都会立即将连接标记为需要重新连接。它会立即响应 Meta 的 Webhook 投递,随后再转发。当所有者在 Instagram 设置中移除应用时,Meta 的 deauthorize 回调会结束连接,并将其从账单中移除。

easyCoexistence 如何通知您,以及如何重新连接?

会通过电子邮件通知一次,邮件中注明账户,并附有通往该渠道页面的按钮;平台还会收到一个已签名的 channel.disconnected 事件。在所有者采取行动之前,list_social_accounts 会显示状态及 Meta 的最后一条错误,工具也会回复该账户需要重新连接。重新连接只需使用同一个 Instagram 账户登录一次,即可恢复相同的连接及其设置。

常见错误

  • 只在调用失败后才刷新令牌。令牌过期后,Meta 会拒绝刷新,因此应趁其仍有效时安排续期。
  • 让受限账户重新登录。错误代码 25 加子代码 2207050 表示账户状态,应由所有者在 Instagram 应用中解决。
  • 未设置 deauthorize 回调。这样,Instagram 设置中的移除操作只会在下一次调用失败时才显现。
  • 修复失败的端点后就停手等待。收到“Webhooks Disabled”警报后,通知会保持关闭,直到账户通过 POST /<IG_ID>/subscribed_apps 重新订阅。
使用 EasyCoexistence 完成这些操作

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

常见问题

使用 Instagram 令牌能防止它过期吗?

不能。只有刷新才能延长长期令牌的有效期,超过 60 天未刷新的令牌无论使用多少次都会过期。

Instagram 会在 90 天未使用后移除商业应用吗?

不会。Instagram 帮助中心称,具有管理商业和创作者账户权限的应用,不会因 90 天不活跃而过期。

已断开的账户仍计入 easyCoexistence 账单吗?

仍会计入,直到您重新连接或将其移除。所有者在 Instagram 设置中移除应用的账户,在 Meta 报告移除后即会从计数中移除。

监控一个 Instagram 账户的 easyCoexistence 费用是多少?

每个连接的监控已包含在内:每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费。

继续阅读

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

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

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

验证时间