Facebook 專頁存取權杖:有效期多久,以及何種情況會令其失效
長期 Facebook 專頁存取權杖沒有到期日。應用程式會把某人的登入換成一個約 60 天有效的長期用戶權杖,並透過 /me/accounts 讀取專頁;該人須對專頁擁有完全控制權,或具備相應的任務存取權限。Meta 在某些情況下仍會令權杖失效,例如該人失去其在專頁上的角色。
每個你連接的專頁,easyCoexistence 都會取得一個長期專頁權杖,以加密方式保存,每 6 小時檢查一次該專頁,並在 Meta 停止接受權杖時向你發送電郵。
由長期用戶權杖生成的長期專頁存取權杖沒有到期日。
長期用戶存取權杖一般的有效期;短期權杖的有效期約為一至兩小時。
專頁權杖所屬用戶已不再具備該專頁適當角色時的錯誤子代碼。
應用程式在這段時間內未使用某項權限,該用戶須重新授予。
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、用戶的任務及一個專頁權杖。
誰可以連接專頁並取得其權杖?
擁有該專頁,或可在該專頁上執行任務的人。在 Facebook 的專頁設定及 Meta Business Suite 中,即指擁有完全控制權,或只具備較窄的任務存取權限,例如「內容」或「訊息」。Meta 的 Pages API 概覽另指出,具備管理員權限者可執行所有任務。專頁權杖對每個專頁、用戶及應用程式而言都是獨一無二的,因此兩人連接同一個專頁,所持的權杖各不相同。Facebook 介面中的名稱對應 API 任務如下:
每項操作需要哪個任務?
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 會不時改變權杖長度,並建議使用可變長度類型,且不設固定上限。
你的 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 監察
驗證日期