
Przewodnik po tokenach dostępu
Token dostępu API Facebook: tokeny użytkownika, Strony, aplikacji i system user w praktyce
Jak uzyskać każdy token, przedłużyć go do około 60 dni, sprawdzić przez debug_token i obsłużyć błąd 190, a także jak aplikacja SaaS może w ogóle pominąć zarządzanie tokenami.
GET
graph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN} applicationTwoja aplikacjais_validtrueexpires_atza 60 dnidługotrwały token użytkownikadata_access_expires_atza 90 dniodnawiany, gdy użytkownik jest aktywnyscopes
TOKEN
Brak refresh tokena: sprawdź, potem ponowne logowanie
Spis treści
Podstawy
Krótka odpowiedź
Token dostępu API Facebook to ciąg znaków, którego wymaga każde wywołanie Graph API. Token użytkownika uzyskujesz przez Facebook Login (lub w Graph API Explorer do testów), na serwerze wymieniasz go na długotrwały token ważny około 60 dni, a następnie wywołujesz /me/accounts, aby pobrać tokeny Stron. Nie ma klucza API ani refresh tokena: monitoruj tokeny przez debug_token i obsługuj błąd 190.
Dla SaaS obsługującego wielu klientów istnieje drugi model: użytkownicy łączą swoje konta Facebook przez Unipile, a Twoja aplikacja nigdy nie przechowuje tokena Meta.
Z Unipile
Żadnego tokenu Meta do pozyskania, przedłużania i debugowania
- 1
Połącz konto
Twój użytkownik raz łączy swoje konto Facebook lub Stronę przez Hosted Auth. Bez aplikacji Meta i bez App Review.
- 2
Wywołuj API swoim kluczem
Wyślij
X-API-KEYzaccount_idużytkownika:GET /v2/{ACCOUNT_ID}/chats. - 3
Obserwuj jeden status
Sprawdzaj
products_connection_status; w razie potrzeby użytkownik łączy się ponownie przez Hosted Auth.
Definicja
Czym jest token dostępu API Facebook?
Meta definiuje access token jako „nieprzejrzysty ciąg znaków, który identyfikuje użytkownika, aplikację lub Stronę na Facebooku”. Każde żądanie do Graph API go zawiera, a jego typ decyduje, w czyim imieniu działasz.
| Token | Działa w imieniu | Jak go uzyskać | Ważność i zastosowanie |
|---|---|---|---|
| Użytkownika | Zalogowanej osoby | Facebook Login lub Graph API Explorer | Od 1 do 2 godzin albo około 60 dni |
| Strony | Strony na Facebooku | /me/accounts z tokenem użytkownika administratora | Zależy od tokena użytkownika |
| Aplikacji | Twojej aplikacji Meta | Wywołanie client_credentials lub {APP_ID}|{APP_SECRET} | Tylko wywołania server-to-server |
| System user | Twojej firmy | Ustawienia firmy (Business Settings) | Bez wygaśnięcia albo 60 dni |
| Klienta | Twojej aplikacji, w kodzie klienta | App Dashboard | Nie jest sekretem |
Token użytkownika
Działa w imieniuZalogowanej osoby
Jak go uzyskaćFacebook Login lub Graph API Explorer
Ważność i zastosowanieOd 1 do 2 godzin albo około 60 dni
Token Strony
Działa w imieniuStrony na Facebooku
Jak go uzyskać
/me/accounts z tokenem użytkownika administratoraWażność i zastosowanieZależy od tokena użytkownika
Token aplikacji
Działa w imieniuTwojej aplikacji Meta
Jak go uzyskaćWywołanie
client_credentials lub {APP_ID}|{APP_SECRET}Ważność i zastosowanieTylko wywołania server-to-server
Token system user
Działa w imieniuTwojej firmy
Jak go uzyskaćUstawienia firmy (Business Settings)
Ważność i zastosowanieBez wygaśnięcia albo 60 dni
Token klienta
Działa w imieniuTwojej aplikacji, w kodzie klienta
Jak go uzyskaćApp Dashboard
Ważność i zastosowanieNie jest sekretem
Instagram ma własny proces: zobacz nasz przewodnik token API Instagrama.
Źródło: przewodnik Meta Access Tokens. Ostatnia weryfikacja: 17 listopada 2026.
Uzyskaj token
Jak uzyskać token dostępu API Facebook
Nie ma klucza API Facebooka: każde wywołanie używa access tokena. Do testów wygeneruj token dla własnego konta w Graph API Explorer. Na produkcji użytkownicy logują się do Twojej aplikacji Meta przez Facebook Login (for Business, gdy potrzebujesz ich Stron), a Twój serwer wymienia zwrócony kod na user access token.
Test, w 4 krokach
Graph API Explorer
- Otwórz
developers.facebook.com/tools/explorer - Wybierz swoją aplikację Meta i „User Token”
- Dodaj potrzebne uprawnienia
- Kliknij Generate Access Token i zatwierdź
Produkcja, w 4 krokach
Facebook Login w Twojej aplikacji Meta
- Utwórz aplikację Meta (App ID, App Secret)
- Przekieruj użytkowników do
/dialog/oauthzclient_id,redirect_uri,state - Przyznają uprawnienia; otrzymujesz
code - Twój serwer wywołuje
/oauth/access_tokenzcodei App Secret
Odpowiedź zawiera access_token, token_type i expires_in. Inne osoby mogą przyznać uprawnienia dopiero wtedy, gdy App Review nada Twojej aplikacji Advanced Access. Pełną ścieżkę dostępu opisuje nasz przegląd API Facebook, a jej część dotyczącą Stron przewodnik Facebook Page API.
Źródło: przewodnik Meta Manually Build a Login Flow (Graph API v27.0). Ostatnia weryfikacja: 17 listopada 2026.
Długotrwały token
Jak uzyskać długotrwały access token
Wyślij krótkotrwały token użytkownika do GET /oauth/access_token z grant_type=fb_exchange_token, swoim App ID i App Secret. Odpowiedź zawiera długotrwały token i jego expires_in, około 60 dni. Meta wyraża się jasno: „Wykonuj to wywołanie ze swojego serwera, a nie z klienta”.
- Wymień token przed wygaśnięciem. „Nie można użyć wygasłego tokena do uzyskania długotrwałego tokena”: gdy krótkotrwały token wygaśnie, użytkownik musi zalogować się ponownie.
- Zapisuj datę wygaśnięcia obok tokena.
- Tylko testujesz? Access Token Debugger ma przycisk Extend Access Token, który robi to samo dla Twojego własnego tokena.
Cykl życia tokena w kodzie
Karty od 1 do 3 korzystają z Graph API od Meta; karta 4 to Unipile, bez tokena Meta.
# Server side only: this call carries your App Secret
curl -G "https://graph.facebook.com/oauth/access_token" \
-d "grant_type=fb_exchange_token" \
-d "client_id={APP_ID}" \
-d "client_secret={APP_SECRET}" \
-d "fb_exchange_token={USER_ACCESS_TOKEN}"
# Response (abridged)
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "expires_in": 5183944 }
# App access token, for server-to-server calls such as debug_token
curl -G "https://graph.facebook.com/oauth/access_token" \
-d "client_id={APP_ID}" \
-d "client_secret={APP_SECRET}" \
-d "grant_type=client_credentials"
# Or pass it directly, without the call
access_token={APP_ID}|{APP_SECRET}
# Check any token with your app token
curl -G "https://graph.facebook.com/debug_token" \
-d "input_token={LONG_LIVED_USER_TOKEN}" \
-d "access_token={APP_ID}|{APP_SECRET}"
# Response (abridged)
{ "data": {
"app_id": "{APP_ID}",
"is_valid": true,
"expires_at": 1800057600,
"data_access_expires_at": 1802649600,
"scopes": ["public_profile", "pages_show_list"]
} }
# No Meta token: your API key and the user's account_id
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
--header "X-API-KEY: {API_KEY}"
# List the chats of the connected account
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
--header "X-API-KEY: {API_KEY}"
200 OK · długotrwały token użytkownika, około 60 dni
200 OK · nigdy w kodzie klienta ani w plikach binarnych aplikacji
200 OK · is_valid, expires_at, data_access_expires_at
200 OK · jeden account_id, brak tokena do wymiany
Żądania z przewodników Meta Long-Lived Access Tokens i Access Tokens. Unipile: dokumentacja Facebook Pages.
Tokeny Stron w skrócie
Z długotrwałym tokenem użytkownika administratora Strony GET /me/accounts zwraca każdą Stronę z jej własnym tokenem, który „nie ma daty wygaśnięcia i wygasa lub zostaje unieważniony tylko w określonych warunkach”. Szczegóły w naszym przewodniku Facebook Page API; aby publikować z takim tokenem, zobacz, jak publikować na Stronie z jej tokenem.
Ważność
Jak długo ważny jest token dostępu Facebook?
Według Meta krótkotrwały token użytkownika jest ważny od około jednej do dwóch godzin, a długotrwały około 60 dni. Tokeny Stron uzyskane z długotrwałego tokena i niektóre tokeny system user nie mają daty wygaśnięcia. Niezależnie od tego dostęp do danych użytkownika kończy się po 90 dniach jego nieaktywności.
Krótkotrwały token użytkownikaOd 1 do 2 godzin
Długotrwały token użytkownikaOkoło 60 dni
Token Strony z długotrwałego tokena użytkownikaBrak daty wygaśnięcia
Token system userNigdy albo 60 dni
Dostęp do danych użytkownika90 dni od ostatniej aktywności
Wygaśnięcie tokena to nie wygaśnięcie dostępu do danych
Meta podaje, że „okres wygaśnięcia dostępu do danych wynosi 90 dni, licząc od ostatniej aktywności użytkownika”. Użytkownik pozostaje zalogowany, ale Twoja aplikacja nie może odczytać jego danych, dopóki ponownie jej nie autoryzuje.
Żaden token nie jest wieczny: nawet token „bez wygaśnięcia” przestaje działać, gdy użytkownik usunie Twoją aplikację, zmieni hasło lub straci swoją rolę. Meta ostrzega: „Nie zakładaj, że te okresy ważności pozostaną takie same”.
Źródła: od Meta Access Tokens, Long-Lived Access Tokens, Authorization vs. data access oraz tokeny system user. Ostatnia weryfikacja: 17 listopada 2026.
System user
System user access tokeny dla procesów server-to-server
System user access token należy do użytkownika systemowego (system user) Twojego Business Managera, a nie do osoby. Według Meta pozwala „Twojej aplikacji wykonywać programowe, zautomatyzowane działania na obiektach reklamowych lub Stronach”. Generujesz go w ustawieniach firmy (Business Settings).
Opcja 1
Nigdy nie wygasa
Bez odnawiania, w przypadkach, gdy wyciek tokena jest akceptowalnym ryzykiem.
Opcja 2, zalecana
Wygasa po 60 dniach
Ustaw set_token_expires_in_60_days=true i odnawiaj przez fb_exchange_token przed 60. dniem.
- Tylko w obrębie tej samej firmy. System user i aplikacja należą do tego samego Business Managera, a „jeśli użytkownik nie ma dostępu, żądanie zostaje odrzucone”.
- Najpierw dostęp do Marketing API: co najmniej standard access.
Źródła: przewodniki Meta Install apps and generate tokens oraz Access Tokens. Ostatnia weryfikacja: 17 listopada 2026.
Debug
Jak sprawdzić token dostępu Facebook przez debug_token
Wywołaj GET /debug_token?input_token={TOKEN} z tokenem dostępu aplikacji (lub tokenem użytkownika jednego z deweloperów aplikacji). Zwraca ważność, datę wygaśnięcia, datę wygaśnięcia dostępu do danych i przyznane uprawnienia. Bez kodu: wklej token do Access Token Debugger (developers.facebook.com/tools/debug/accesstoken).
is_validCzy token nadal działa.
expires_atData wygaśnięcia tokena jako znacznik czasu Unix;
0 oznacza brak daty wygaśnięcia.data_access_expires_atKiedy kończy się dostęp do danych, nawet przy ważnym tokenie.
scopesPrzyznane uprawnienia;
granular_scopes dodaje ID obiektów docelowych.app_id, user_idDla kogo wydano token.
profile_idID Strony, w przypadku tokena Strony.
Aby sprawdzać na produkcji, czy token dostępu Facebook jest ważny, uruchamiaj cyklicznie na serwerze żądanie z karty 3 bloku kodu powyżej i zapisuj obie daty przy każdym tokenie. Brakujące uprawnienie w scopes wyjaśnia większość błędów typu „u mnie działa, u nich nie”.
Źródło: dokumentacja debug_token od Meta (Graph API v27.0). Ostatnia weryfikacja: 17 listopada 2026.
Błędy
Błędy tokena dostępu Facebook: kod 190 i jego subkody
Błąd 190 oznacza, że token dostępu Facebook wygasł lub jest nieważny. Wraca jako OAuthException, a jego error_subcode mówi, o co poprosić użytkownika. Ponowna próba z tym samym tokenem nigdy tego nie naprawi.
{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }
190
Odczytaj error_subcode, zachowaj fbtrace_id dla wsparcia Meta
| Subkod | Znaczenie | Co zrobić |
|---|---|---|
| 458 | Aplikacja nie jest zainstalowana | Zaloguj użytkownika ponownie |
| 459 | Użytkownik zatrzymany na kontroli bezpieczeństwa | Użytkownik loguje się na facebook.com |
| 460 | Zmienione hasło | Zaloguj użytkownika ponownie |
| 463 | Token wygasł | Logowanie, potem ponowna wymiana |
| 464 | Niepotwierdzony użytkownik | Użytkownik loguje się na facebook.com |
| 467 | Nieważny token | Połącz użytkownika ponownie |
| 492 | Brak odpowiedniej roli na Stronie | Nowy token od obecnego administratora |
Subkod 458
ZnaczenieAplikacja nie jest zainstalowana
Co zrobićZaloguj użytkownika ponownie
Subkod 459
ZnaczenieUżytkownik zatrzymany na kontroli bezpieczeństwa
Co zrobićUżytkownik loguje się na facebook.com
Subkod 460
ZnaczenieZmienione hasło
Co zrobićZaloguj użytkownika ponownie
Subkod 463
ZnaczenieToken wygasł
Co zrobićLogowanie, potem ponowna wymiana
Subkod 464
ZnaczenieNiepotwierdzony użytkownik
Co zrobićUżytkownik loguje się na facebook.com
Subkod 467
ZnaczenieNieważny token
Co zrobićPołącz użytkownika ponownie
Subkod 492
ZnaczenieBrak odpowiedniej roli na Stronie
Co zrobićNowy token od obecnego administratora
W SaaS obsługującym wielu klientów 492 to klasyka: administrator, który połączył Stronę, odchodzi. Pozostałe kody znajdziesz w naszej tabeli błędów API Facebook.
Źródło: przewodnik Meta Graph API error handling. Ostatnia weryfikacja: 17 listopada 2026.
Bezpieczeństwo
Przechowywanie i zabezpieczanie tokenów dostępu Facebook
Traktuj każdy token dostępu Facebook jak hasło do konta, które za nim stoi: trzymaj App Secret i tokeny aplikacji na serwerze, szyfruj tokeny użytkowników i Stron w spoczynku, podpisuj wywołania serwerowe przez appsecret_proof i usuwaj tokeny, gdy tylko klient się odłączy.
- Sekrety tylko po stronie serwera. Meta: „Nigdy nie umieszczaj na stałe tokenów dostępu aplikacji w kodzie po stronie klienta ani w plikach binarnych aplikacji” oraz „Używaj tokenów dostępu aplikacji wyłącznie w wywołaniach server-to-server”.
- Tokeny klienta są publiczne. Meta zaznacza, że „nie są tajne”, więc nigdy nie używaj ich do autoryzacji niczego wrażliwego.
- Podpisuj wywołania przez
appsecret_proof. Meta definiuje go jako „skrót sha256 Twojego access tokena, z App Secret jako kluczem”; włącz Require App Secret w App Dashboard. - Szyfrowanie w spoczynku, HTTPS w transmisji. Nie umieszczaj tokenów w logach ani w adresach URL.
- Jeden rekord na token. Zapisuj użytkownika, Stronę, aplikację i
expires_at. - Czyść po odłączeniu. Usuń token, gdy użytkownik odchodzi.
Źródła: przewodniki Meta Access Tokens i Securing Requests. Ostatnia weryfikacja: 17 listopada 2026.
Z Unipile
Pomiń zarządzanie tokenami: połącz konta Facebook swoich użytkowników
Z Unipile każdy użytkownik raz łączy swoje konto Facebook przez Hosted Auth. Strony, którymi zarządza, trafiają na ten sam account_id, a Ty wywołujesz API własnym kluczem (X-API-KEY). Po Twojej stronie: bez tokena Meta, bez aplikacji Meta i bez App Review.
| Pytanie | Tokeny dostępu Meta | Konto połączone przez Unipile |
|---|---|---|
| Co przechowujesz | Jeden token na użytkownika plus jeden na każdą kombinację Strony, administratora i aplikacji | Jeden account_id na użytkownika i jeden klucz API |
| Co monitorujesz | expires_at i data_access_expires_at każdego tokena | Status każdej Strony w metadata.products_connection_status |
| Co odnawiasz | Wymiana na długotrwały token lub logowanie przed 60. dniem | Brak tokena Meta do wymiany |
| Przy błędzie 190 | Odczytaj subkod, potem poproś użytkownika o ponowne logowanie | W razie potrzeby użytkownik łączy się ponownie przez Hosted Auth |
Co przechowujesz
Tokeny MetaJeden token na użytkownika plus jeden na każdą kombinację Strony, administratora i aplikacji
UnipileJeden
account_id na użytkownika i jeden klucz APICo monitorujesz
Tokeny Meta
expires_at i data_access_expires_at każdego tokenaUnipileStatus każdej Strony w
metadata.products_connection_statusCo odnawiasz
Tokeny MetaWymiana na długotrwały token lub logowanie przed 60. dniem
UnipileBrak tokena Meta do wymiany
Przy błędzie 190
Tokeny MetaOdczytaj subkod, potem poproś użytkownika o ponowne logowanie
UnipileW razie potrzeby użytkownik łączy się ponownie przez Hosted Auth
Połączone konto obejmuje wiadomości, skrzynki odbiorcze Stron, posty, komentarze i reakcje. Strona może odpowiadać w swoich rozmowach i publikować posty, ale nie może rozpocząć rozmowy. Zobacz kartę 4 powyżej oraz naszą stronę Facebook Messenger API.
Zgodność
Każdy użytkownik łączy własne konto
Unipile to niezależna firma, a nie oficjalna aplikacja Meta ani partner Meta. Działa w imieniu każdego uwierzytelnionego użytkownika, a każdy użytkownik nadal podlega warunkom Meta.
Buduj na Facebooku bez zarządzania tokenami
Każdy użytkownik raz łączy swoje konto Facebook; Ty korzystasz z jednego API dla Facebooka, LinkedIn, WhatsApp i e-maili. 7-dniowy bezpłatny okres próbny.
Regulowane przez UE
Digital Markets Act (DMA)
Każdy użytkownik łączy własne konto, bez przechowywania profili. Unipile nie jest partnerem Meta. Dowiedz się więcej
Wszystkie endpointy API Facebooka w jednym miejscu
Gdy konto jest już połączone, zobacz wszystkie endpointy Facebooka dostępne w Unipile lub przeczytaj kompletny przewodnik po API Facebook, w którym opisujemy uprawnienia, limity i błędy.
Token dostępu API Facebook: FAQ
Szybkie odpowiedzi o ważności tokenów, ich odświeżaniu, weryfikacji, przechowywaniu i błędzie 190.
Nie do końca. Długotrwały token użytkownika jest ważny około 60 dni. Tokeny Stron uzyskane z niego i niektóre tokeny system user nie mają daty wygaśnięcia, ale i tak przestają działać, gdy użytkownik usunie Twoją aplikację, zmieni hasło lub straci swoją rolę. Zaplanuj proces ponownego połączenia.
Nie w sensie OAuth: Meta nie dokumentuje grantu refresh_token dla Facebook Login. Ważny krótkotrwały token wymieniasz przez fb_exchange_token; gdy token wygaśnie, użytkownik loguje się ponownie. W natywnych aplikacjach mobilnych Meta odświeża długotrwałe tokeny raz dziennie, gdy dana osoba korzysta z Twojej aplikacji.
Bo 60 dni to górna granica, a nie gwarancja. Token przestaje działać wcześniej, gdy użytkownik zmieni hasło, usunie Twoją aplikację, trafi na kontrolę bezpieczeństwa (checkpoint) lub straci rolę na Stronie, a Meta ostrzega, że okresy ważności „mogą się zmienić bez ostrzeżenia lub wygasnąć wcześniej”. Odczytaj error_subcode błędu 190, aby wiedzieć, z którym przypadkiem masz do czynienia.
Wywołaj GET /debug_token?input_token={TOKEN} z tokenem dostępu aplikacji i odczytaj is_valid, expires_at, data_access_expires_at oraz scopes. Przy jednorazowym sprawdzeniu wklej token do Access Token Debugger od Meta.
Tak, jeśli traktujesz je jak hasła: szyfruj je w spoczynku, trzymaj z dala od logów i kodu klienta, a App Secret i tokenów aplikacji używaj wyłącznie w wywołaniach server-to-server. Podpisuj wywołania serwerowe przez appsecret_proof.
Błąd 190 z subkodem 492 oznacza nieważną sesję: użytkownik stojący za Page access tokenem nie ma już odpowiedniej roli na Stronie. Uzyskaj nowy token Strony od obecnego administratora.
Nie. Unipile to niezależna firma: nie jest partnerem Meta ani oficjalną aplikacją Meta i nie jest popierana, sponsorowana ani zatwierdzona przez Meta. Facebook jest znakiem towarowym Meta Platforms, Inc.
Nie. Wywołujesz Unipile swoim kluczem API i account_id każdego połączonego użytkownika. Użytkownicy łączą swoje konto Facebook i Strony, którymi zarządzają, przez hostowane uwierzytelnianie Unipile: po Twojej stronie bez aplikacji Meta, App Secret i App Review.
Zostało zaprojektowane zgodnie z Digital Markets Act: każdy użytkownik łączy własne konto, a Unipile działa w jego imieniu bez przechowywania profili użytkowników. Więcej na naszej stronie Digital Markets Act.
Tak. Każde połączone konto nadal podlega Warunkom korzystania Meta. Używaj API w uzasadnionych scenariuszach, takich jak obsługa klienta, CRM i bezpośrednie rozmowy; spam i nieautoryzowana automatyzacja mogą skutkować ograniczeniem kont.
Masz jeszcze pytania? Nasz zespół chętnie pomoże.
Porozmawiaj z ekspertem
