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

Facebook 專頁存取權杖:有效期多久,以及何種情況會令其失效

長期 Facebook 專頁存取權杖沒有到期日。應用程式會把某人的登入換成一個約 60 天有效的長期用戶權杖,並透過 /me/accounts 讀取專頁;該人須對專頁擁有完全控制權,或具備相應的任務存取權限。Meta 在某些情況下仍會令權杖失效,例如該人失去其在專頁上的角色。

每個你連接的專頁,easyCoexistence 都會取得一個長期專頁權杖,以加密方式保存,每 6 小時檢查一次該專頁,並在 Meta 停止接受權杖時向你發送電郵。

No expiry

由長期用戶權杖生成的長期專頁存取權杖沒有到期日。

About 60 days

長期用戶存取權杖一般的有效期;短期權杖的有效期約為一至兩小時。

492

專頁權杖所屬用戶已不再具備該專頁適當角色時的錯誤子代碼。

90 days

應用程式在這段時間內未使用某項權限,該用戶須重新授予。

PROFILE_PLUS_FULL_CONTROL

Meta API 可指派的專頁任務之一,其他還有 CREATE_CONTENT、MODERATE、MESSAGING 及 ANALYZE。

Facebook 專頁存取權杖會過期嗎?

這取決於其來源的用戶權杖。Meta 預設的用戶權杖與專頁權杖都是短期的,數小時內便會過期;長期用戶權杖一般約 60 天有效。由長期用戶權杖生成的專頁權杖沒有到期日:Meta 表示它只會在某些情況下過期或失效。Meta 亦提醒不要依賴權杖的有效期,因為有效期可能不經通知而改變。

如何取得長期專頁存取權杖?

用戶以 Facebook Login for Business 登入後,只需三次呼叫即可完成。第一步,應用程式把返回的代碼換成短期用戶權杖;第二步,於 GET /oauth/access_token 以 grant_type=fb_exchange_token 及應用程式密鑰,將其換成長期用戶權杖,Meta 建議此呼叫在伺服器端進行;第三步,以長期用戶權杖呼叫 GET /me/accounts,會返回用戶所授權的每個專頁,連同其 ID、用戶的任務及一個專頁權杖。

1Sign-inFacebook Login for Business returns a code
2User tokenThe code becomes a short-lived user token
3Long-livedfb_exchange_token trades it for about 60 days
4Page token/me/accounts returns one per Page, with no expiry

誰可以連接專頁並取得其權杖?

擁有該專頁,或可在該專頁上執行任務的人。在 Facebook 的專頁設定及 Meta Business Suite 中,即指擁有完全控制權,或只具備較窄的任務存取權限,例如「內容」或「訊息」。Meta 的 Pages API 概覽另指出,具備管理員權限者可執行所有任務。專頁權杖對每個專頁、用戶及應用程式而言都是獨一無二的,因此兩人連接同一個專頁,所持的權杖各不相同。Facebook 介面中的名稱對應 API 任務如下:

Full controlPROFILE_PLUS_FULL_CONTROL
ContentPROFILE_PLUS_CREATE_CONTENT: publish as the Page
MessagesPROFILE_PLUS_MESSAGING: send messages as the Page
Community activityPROFILE_PLUS_MODERATE: reply to and delete comments
InsightsPROFILE_PLUS_ANALYZE: view the Page's Insights
AdsPROFILE_PLUS_ADVERTISE: create ads

每項操作需要哪個任務?

Meta 會於每次呼叫時,檢查權杖背後的用戶是否持有允許該操作的任務,因此請以權限涵蓋所需工作的帳戶進行連接:

  • 文字、連結及相片貼文:CREATE_CONTENT。
  • 影片貼文:須具備等同管理員的任務,見 Meta Video API 概覽。
  • 以專頁身分處理留言 ID 及回覆:MODERATE。
  • Messenger 回覆及私人回覆:MESSAGING。
  • 洞察報告:ANALYZE。
  • 動態 Webhook:CREATE_CONTENT、MANAGE 或 MODERATE;messages 欄位:MESSAGING。

什麼情況會令專頁存取權杖失效?

Meta 會以錯誤代碼 190 表示它不再接受某個權杖;若為工作階段則為 102,並附上說明原因的驗證子代碼。用戶亦可在 Facebook 設定的「商業整合」下移除應用程式,藉此令應用程式的用戶權杖失效;應用程式 90 天未使用的權限,須重新授予。Meta 列出的子代碼如下:

  • 458:用戶未曾登入該應用程式。
  • 459 或 464:用戶須於 facebook.com 登入,以處理帳戶問題。
  • 460:用戶的密碼已更改。
  • 463 或 467:權杖已過期、被撤銷或以其他方式失效。
  • 492:專頁權杖背後的用戶已不再具備該專頁的適當角色。

easyCoexistence 如何保持專頁連接?

用戶登入時,每個專頁的權杖都由長期用戶權杖取得,因此無須按時程續期,並會以加密方式儲存。每 6 小時,它會以輕量的 Graph 呼叫檢查每個已連接的專頁。當 Meta 於該次檢查或任何工具呼叫中以錯誤 190 或 102 拒絕權杖時,該專頁會被標記為需要重新連接,其擁有人會收到電郵,合作夥伴平台亦會收到 channel.disconnected。之後以管理該專頁的帳戶再次登入,即可恢復連接。

我可以自行使用專頁權杖嗎?

並非權杖本身。get_social_credentials 會返回專頁 ID,以及位於 graph.facebook.com 的 Graph API 基底網址,但絕不會返回專頁權杖(依 Meta 條款);只要專頁保持連接,權杖便不會過期,不過 Meta 仍可能令其失效。MCP 工具會以該專頁身分執行呼叫,且不會暴露權杖;權杖及 Webhook 訂閱則由 easyCoexistence 負責管理。

常見錯誤

  • 從瀏覽器請求長期權杖。換取過程會附帶應用程式密鑰,因此 Meta 指示此呼叫必須在伺服器端進行,切勿在用戶端執行。
  • 嘗試延長已過期的權杖。Meta 不會把已過期的權杖轉為長期權杖,用戶必須重新完成登入。
  • 透過即將離開公司的人連接。專頁權杖依賴該人的存取權,一旦其失去角色便會停止運作,因此應使用會長期留任的帳戶連接。
  • 將權杖儲存於固定長度的欄位。Meta 會不時改變權杖長度,並建議使用可變長度類型,且不設固定上限。
使用 EasyCoexistence 完成這項設定

你的 AI 透過 MCP 工具使用該權杖,這些工具會自動加入權杖,而 get_social_credentials 則會把專頁 ID 及 API 基底網址交給你自己的程式。每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,前 3 天免費試用。

常見問題

如果應用程式停止使用 Facebook 權限,權限會過期嗎?

會。應用程式連續 90 天未使用某項權限,用戶須重新授予。

已過期的 Facebook 權杖可以轉為長期權杖嗎?

不可以。Meta 不會把已過期的權杖轉為長期權杖,因此用戶必須重新完成登入,才能讀取新的長期專頁權杖。

Facebook 專頁的錯誤 190 是什麼意思?

表示 Meta 不再接受該權杖。子代碼會說明原因,例如密碼更改後為 460,用戶在專頁上失去角色則為 492。

easyCoexistence 會更新 Facebook 專頁權杖嗎?

不需要。無須按時程更新,因為它所持有的專頁權杖沒有到期日。它會每 6 小時檢查一次每個專頁,如有需要重新連接,便會發送電郵通知你。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期