登入開始免費試用
easyCoexistence 官方 API

Instagram API 連接為何中斷,以及如何保持連線

Instagram API 連接中斷,是因為 Meta 不再接受其存取權杖,或該帳戶不再符合資格:長期存取權杖 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 Login 時,長期存取權杖自上次更新起有效 60 天。以 grant_type=ig_refresh_token 更新,可再獲得 60 天,前提是權杖至少已存在 24 小時、尚未過期,且擁有者已授予 instagram_business_basic。60 天過後,呼叫會以代碼 190 失敗,只有重新登入才能解決。使用 Unified Login 時,由設定決定權杖是否會過期。

更改密碼與移除權限會有什麼影響?

更改密碼可能會結束權杖所屬的會話。Meta 的 Graph API 錯誤指南將其報告為代碼 190,子代碼 460,並說明該人士必須重新登入應用程式。從未授予或已被移除的權限會返回代碼 10,或 200 至 299 範圍內的代碼;在私訊方面,代碼 200 加子代碼 2534041 表示擁有者已關閉訊息存取。Meta 的平台條款也允許其終止應用程式對 28 日內未使用的權限或功能的存取權。

擁有者移除應用程式時會發生什麼?

應用程式對非公開資料的存取權即告終止。擁有者可在 Instagram 的「網站權限」、「應用程式和網站」、「已啟用」中移除應用程式,Meta 則會呼叫應用程式業務登入設定中儲存的取消授權回調 URL。Instagram 幫助中心表示,被移除的應用程式此後只能取得帳戶的公開資料,因此連接已告結束,直至擁有者重新登入為止。

帳戶類型變更或受限時會有什麼影響?

兩者任一都會令帳戶脫離 API 所服務的範圍。Meta 的 API 只支援專業帳戶,其 Unified Login 疑難排解表格指出,切換為個人帳戶的帳戶會返回錯誤訊息 (#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 視為需要重新連接。
  • 提供取消授權回調,讓你在 Instagram 設定中的移除操作能即時通知你。
  • 閱讀應用程式上的開發者警報與業務電郵,Meta 會在這裡發出 Webhook 與審查通知。
  • 按帳戶記錄每個錯誤的代碼、子代碼與 fbtrace_id,以便將受限與錯誤要求區分開來。

如何為每種情況重新連接?

多數原因都以同一步驟解決,即由帳戶擁有者重新登入,發出新的代碼與權杖。例外是擁有者在 Instagram 應用程式中更改的設定:

  • 存取權杖過期、更改密碼、應用程式或權限被移除:請擁有者再次透過登入流程,並批准權限。
  • 個人帳戶:在 Instagram 應用程式中切換回商業帳戶或創作者帳戶,然後重新登入。
  • 訊息已關閉:在「已連接的工具」下開啟「允許存取訊息」,無需重新登入。
  • 受限帳戶:完成 Instagram 應用程式的要求;重新登入不會有任何改變。
  • Webhook 已停用:修復端點,然後重新訂閱該帳戶。

easyCoexistence 如何保持連接?

它全天候監察每個已連接的 Instagram 帳戶。當 60 天之中剩餘不足 20 天時更新權杖,每 6 小時以 GET /me 檢查帳戶,並在 Meta 拒絕權杖的瞬間標記該連接需要重新連接,無論這是來自該項檢查還是工具呼叫。它會即時回應 Meta 的 Webhook 傳送,並於之後轉發;當擁有者在 Instagram 設定中移除應用程式,Meta 的取消授權回調會結束該連接,並將其從帳單中移除。

easyCoexistence 如何通知你,以及如何重新連接?

只通知一次,以電郵發出,並指明帳戶,附有通往該渠道頁面的按鈕;平台亦會收到已簽署的 channel.disconnected 事件。在擁有者採取行動前,list_social_accounts 會顯示狀態與 Meta 的最後錯誤,而工具會回覆該帳戶需要重新連接。重新連接只需以同一 Instagram 帳戶登入一次,即可恢復同一連接及其設定。

常見錯誤

  • 只在呼叫失敗後才更新存取權杖。權杖一旦過期,Meta 便會拒絕更新,因此應在權杖仍有效時安排續期。
  • 將受限帳戶送回登入流程。代碼 25 加子代碼 2207050 反映的是帳戶狀態,應由擁有者在 Instagram 應用程式中處理。
  • 未設定取消授權回調。這樣一來,在 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 監察

驗證日期