为何 Instagram API 连接会停止工作,以及如何保持连接
当 Meta 不再接受某个 Instagram API 连接的令牌,或该账户不再符合条件时,连接就会停止工作:长期访问令牌超过 60 天未刷新、更改密码、所有者移除权限或整个应用、切换为个人账户,或账户受到限制。每种情况都会返回各自的错误,大多数情况只需所有者重新登录即可修复。
easyCoexistence 全天候监控每个 Instagram 连接:在 60 天期满之前很早刷新令牌,每 6 小时检查一次账户,并在 Meta 拒绝访问时向您发送一次邮件,同时向平台发送 channel.disconnected,因此断开的连接只需一次登录即可恢复。
超过 60 天未刷新的 Instagram 令牌会过期,且无法再刷新。
错误代码 190 下的 Graph API 子代码,表示会话因更改密码而结束;该用户需要重新登录。
在 Meta 停用消息 Webhook 投递并取消应用对该账户的订阅之前,累计的失败投递次数。
Meta 可能会终止应用对 28 天内未使用的权限或功能的访问权限。
easyCoexistence 检查每个已连接 Instagram 账户的频率,并会在 60 天期满之前很早为令牌续期。
为什么 Instagram API 连接会停止工作?
因为 Meta 不再接受该令牌,或该账户不再符合 API 的使用条件。Meta 的文档列出了这些原因,每种原因都说明 API 返回的内容,以及恢复访问所需的步骤。这些问题大多会先以调用失败的形式显现,因此下文的检查会按计划查找它们:
| What the API returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A 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 off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A 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 重新订阅。
每个连接每月 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 监控
验证时间