Facebook 專頁 API 連接為何停止運作,以及如何保持連線
Facebook 專頁連接會在 Meta 不再接受其存取權杖,或不再發送其事件時停止運作:權杖來自短期登入、用戶更改了密碼(錯誤 190,子代碼 460)、失去專頁上的角色(492)或在商業整合下移除了應用程式(458)、某項權限 90 日未被使用、應用程式長期處於不活躍狀態,或 Meta 限制了該專頁。
easyCoexistence 會從長期登入取得每個專頁的權杖,每 6 小時檢查專頁,並在 Meta 拒絕權杖時電郵通知您;一次 Facebook 登入即可將專頁以同一連接身份復原,連同其留言規則與自動化。
Meta 預設用戶與專頁權杖的有效期;由長期用戶權杖取得的專頁權杖沒有到期日。
在此期間內若無登入、API 呼叫或 webhook,Meta 會視應用程式為不活躍,並使其所有權杖失效。
pages_manage_posts 及 read_insights 等專頁權限不會隨 90 日數據存取期限到期。
Page Integrity 限制會阻止專頁透過 Messenger Platform API 發送訊息。
easyCoexistence 每隔多久以輕量 Graph 呼叫檢查每個已連接專頁,並在 Meta 拒絕權杖時電郵通知擁有者。
什麼會令專頁連接停止運作?
原因分四個層面:用戶的登入、應用程式的權限與狀態、專頁本身,以及 webhook 訂閱。每種原因的表現各異,大多數會以錯誤 190 回傳,並附上說明原因的子代碼:
為何專頁權杖會在數小時內到期?
因為它是透過 /me/accounts 以短期用戶權杖讀取的,因此它本身也是短期的。Meta 預設的用戶與專頁權杖會在數小時內到期,短期權杖約為一至兩小時。若在伺服器上以 fb_exchange_token 交換,用戶權杖的有效期約為 60 日,而以此讀取的專頁權杖沒有到期日。Meta 不會延長已到期的權杖:錯誤訊息為 Session has expired,子代碼為 463,用戶必須重新登入。
更改密碼或進行安全檢查後會發生什麼?
Meta 會使該用戶的權杖失效。登出或更改密碼會回傳錯誤 190,子代碼 460,訊息為 The session is invalid because the user logged out,而 Meta 亦警告安全事件可能會在預期到期前令權杖失效。子代碼 459 與 464 表示帳戶本身需要處理:用戶必須前往 facebook.com 解決問題,然後再次登入應用程式。否則,解決方法是重新登入,可由該用戶本人,或由專頁上擁有角色的其他人員進行。
用戶失去專頁上的角色時會發生什麼?
其專頁權杖會以錯誤 190、子代碼 492 停止運作,Meta 將此描述為與專頁存取權杖關聯的用戶,已不再於專頁上擁有適當角色。權杖是按專頁、用戶及應用程式分別發出的,因此其他具有角色的人員的權杖仍可正常運作。解決方法是由仍擁有完整控制或任務存取權的帳戶重新連接專頁,最好是不會即將離開該商業的帳戶。
有人在商業整合中移除應用程式時會發生什麼?
Meta 會使該應用程式為該用戶持有的用戶存取權杖失效,而以此讀取的專頁權杖也會一併停止運作,回傳錯誤 190、子代碼 458:用戶尚未授權此應用程式。用戶可在 Facebook 設定的「商業整合」下移除應用程式,之後 Meta 會呼叫應用程式的取消授權回調。系統用戶權杖則可在 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 記載了三種情況,並會在 App Dashboard 的警報收件箱中以緊急通知提出警告。若應用程式 90 日內沒有任何登入、Graph API 或 Marketing API 呼叫,以及沒有 webhook 通知,即被視為不活躍,Meta 會使其所有權杖失效;在 App Dashboard 中將其還原會把它升級至最新版本,但舊權杖仍然失效,因長期未用而被撤銷的權限亦須重新經 App Review 申請。每年的 Data Use Checkup 必須完成,而違反 Meta 的條款或政策,可能會限制 API 存取或撤銷權限。
Meta 限制專頁時會發生什麼?
受限的操作會失敗:錯誤 368(因違反政策而暫時被封鎖),或因訊息而回傳代碼 10、子代碼 1893063。Meta 的 Page Integrity API 會說明是哪一種情況:GET /{page-id}/page_status(需要 pages_manage_metadata)會回傳狀態 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,並在端點再次回應後,以專頁權杖對 subscribed_apps 發送 POST。
如何在發文失敗前發現連接已損壞?
透過定期檢查,因為 Meta 不會在權杖失效時通知應用程式。以專頁權杖執行的輕量呼叫,例如 GET /{page-id}?fields=id,name,其失敗方式與發文相同。以應用程式 ID 與密鑰作為存取權杖呼叫的 debug_token,會回傳 is_valid、expires_at 及已授予的範圍,若權杖已不能使用,還會回傳錯誤代碼與子代碼;page_status 會回報限制,而取消授權回調則會通知已移除應用程式。
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 的取消授權回調會送達 easyCoexistence,系統隨即移除該用戶所連接的專頁、刪除其權杖與事件目的地、從帳單中剔除,並發送 channel.removed。從控制台再次登入會以同一連接身份復原專頁,連同其留言規則與自動化,並重新訂閱 feed、messages 及 mention。在「需要重新連接」狀態之後,事件目的地亦會保留;在移除之後,則須以 set_social_webhook_destination 以新密鑰重新設定。
常見錯誤
- 重試錯誤 190。被拒絕的權杖每次呼叫都會以相同方式失敗,只有具備專頁角色的人員重新登入,才會產生有效的權杖。
- 為解除限制而重新連接。新權杖不會改變專頁的狀態;能改變狀態的是 page_status 中的建議操作,例如申訴。
- 申請產品很少使用的權限。若 90 日未被使用,它可能到期,而需要它的呼叫便會失敗;應在功能推出時才申請。
- 重新連接後仍保留舊權杖。新登入會回傳不同的權杖字串,若任務仍持有舊權杖,便會持續以 190 失敗。
每個連接每月由 US$ 9 降至 US$ 0.75,連接越多越便宜,首 3 天免費。
常見問題
用戶權杖於 60 日後到期,專頁權杖會否停止運作?
若專頁權杖是以該長期用戶權杖透過 /me/accounts 讀取的,則不會。這類專頁權杖沒有到期日,但本頁列出的原因仍可令其失效。
Meta 會在專頁權杖失效時通知我嗎?
權杖失效時不會通知,下一次呼叫便會回傳錯誤。若有人移除應用程式,Meta 會呼叫應用程式的取消授權回調;至於影響整個應用程式的風險,則會在 App Dashboard 的警報收件箱中警告。
其他人的權杖可以令專頁保持連接嗎?
可以。專頁權杖是按專頁、用戶及應用程式分別發出的,因此當某人的存取權結束時,仍在專頁上擁有角色的其他人員所持有的權杖會繼續運作。
easyCoexistence 對 Facebook 專頁收費多少?
每個連接每月由 US$ 9 降至 US$ 0.75,按您擁有的連接數量計算,每個專頁計為一個連接,並提供首 3 天免費。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期