Instagram API 連接為何中斷,以及如何保持連線
Instagram API 連接中斷,是因為 Meta 不再接受其存取權杖,或該帳戶不再符合資格:長期存取權杖 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 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 重新訂閱。
每個連接每月 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 監察
驗證日期