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

Facebook 專頁 API 連接為何停止運作,以及如何保持連線

Facebook 專頁連接會在 Meta 不再接受其存取權杖,或不再發送其事件時停止運作:權杖來自短期登入、用戶更改了密碼(錯誤 190,子代碼 460)、失去專頁上的角色(492)或在商業整合下移除了應用程式(458)、某項權限 90 日未被使用、應用程式長期處於不活躍狀態,或 Meta 限制了該專頁。

easyCoexistence 會從長期登入取得每個專頁的權杖,每 6 小時檢查專頁,並在 Meta 拒絕權杖時電郵通知您;一次 Facebook 登入即可將專頁以同一連接身份復原,連同其留言規則與自動化。

Hours

Meta 預設用戶與專頁權杖的有效期;由長期用戶權杖取得的專頁權杖沒有到期日。

90 days

在此期間內若無登入、API 呼叫或 webhook,Meta 會視應用程式為不活躍,並使其所有權杖失效。

Exempt

pages_manage_posts 及 read_insights 等專頁權限不會隨 90 日數據存取期限到期。

page_messaging_api

Page Integrity 限制會阻止專頁透過 Messenger Platform API 發送訊息。

6 hours

easyCoexistence 每隔多久以輕量 Graph 呼叫檢查每個已連接專頁,並在 Meta 拒絕權杖時電郵通知擁有者。

什麼會令專頁連接停止運作?

原因分四個層面:用戶的登入、應用程式的權限與狀態、專頁本身,以及 webhook 訂閱。每種原因的表現各異,大多數會以錯誤 190 回傳,並附上說明原因的子代碼:

Short-lived sign-in190, subcode 463: the Page token expired with the user token it came from
Password change or logout190, subcode 460
Account checkpoint190, subcode 459 or 464: the person must log in at facebook.com
Role removed from the Page190, subcode 492
App removed in Business integrations190, subcode 458, and a call to the deauthorize callback
Permission unused for 90 daysCode 10, or one from 200 to 299, on the calls that need it
App inactive for 90 daysAll of the app's tokens invalidated
Page restricted368, or 10 with subcode 1893063 for messages
Webhooks failing for an hourThe app unsubscribed from the Page's events

為何專頁權杖會在數小時內到期?

因為它是透過 /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 會回報限制,而取消授權回調則會通知已移除應用程式。

Inspect a Page token with debug_token
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。新登入會產生新的權杖字串,因此應以新權杖取代已儲存者,而非同時保留兩者:

1Fix the causeCheckpoint, restriction or endpoint first
2Sign in againFacebook Login for Business, code exchanged on the server
3Long-lived tokenfb_exchange_token, about 60 days
4New Page tokenRead /me/accounts and replace the stored one
5Subscribe againPOST /{page-id}/subscribed_apps if events had stopped

專頁連接中斷時,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 失敗。
使用 EasyCoexistence 完成這項設定

每個連接每月由 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 監察

驗證日期