PL
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.

Weryfikacja tokena 200 OK
GETgraph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN}
applicationTwoja aplikacja
is_validtrue
expires_atza 60 dnidługotrwały token użytkownika
data_access_expires_atza 90 dniodnawiany, gdy użytkownik jest aktywny
scopespublic_profilepages_show_list
TOKEN Brak refresh tokena: sprawdź, potem ponowne logowanie
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. 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. 2

    Wywołuj API swoim kluczem

    Wyślij X-API-KEY z account_id użytkownika: GET /v2/{ACCOUNT_ID}/chats.

  3. 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.

TokenDziała w imieniuJak go uzyskaćWażność i zastosowanie
UżytkownikaZalogowanej osobyFacebook Login lub Graph API ExplorerOd 1 do 2 godzin albo około 60 dni
StronyStrony na Facebooku/me/accounts z tokenem użytkownika administratoraZależy od tokena użytkownika
AplikacjiTwojej aplikacji MetaWywołanie client_credentials lub {APP_ID}|{APP_SECRET}Tylko wywołania server-to-server
System userTwojej firmyUstawienia firmy (Business Settings)Bez wygaśnięcia albo 60 dni
KlientaTwojej aplikacji, w kodzie klientaApp DashboardNie 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 administratora
Waż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

  1. Otwórz developers.facebook.com/tools/explorer
  2. Wybierz swoją aplikację Meta i „User Token”
  3. Dodaj potrzebne uprawnienia
  4. Kliknij Generate Access Token i zatwierdź
Produkcja, w 4 krokach

Facebook Login w Twojej aplikacji Meta

  1. Utwórz aplikację Meta (App ID, App Secret)
  2. Przekieruj użytkowników do /dialog/oauth z client_id, redirect_uri, state
  3. Przyznają uprawnienia; otrzymujesz code
  4. Twój serwer wywołuje /oauth/access_token z code i 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.

Facebook Ważność tokenów według Meta
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).

Facebook Co zwraca debug_token
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.

Facebook Co zwraca Graph API

{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }

190 Odczytaj error_subcode, zachowaj fbtrace_id dla wsparcia Meta
SubkodZnaczenieCo zrobić
458Aplikacja nie jest zainstalowanaZaloguj użytkownika ponownie
459Użytkownik zatrzymany na kontroli bezpieczeństwaUżytkownik loguje się na facebook.com
460Zmienione hasłoZaloguj użytkownika ponownie
463Token wygasłLogowanie, potem ponowna wymiana
464Niepotwierdzony użytkownikUżytkownik loguje się na facebook.com
467Nieważny tokenPołącz użytkownika ponownie
492Brak odpowiedniej roli na StronieNowy 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.

PytanieTokeny dostępu MetaKonto połączone przez Unipile
Co przechowujeszJeden token na użytkownika plus jeden na każdą kombinację Strony, administratora i aplikacjiJeden account_id na użytkownika i jeden klucz API
Co monitorujeszexpires_at i data_access_expires_at każdego tokenaStatus każdej Strony w metadata.products_connection_status
Co odnawiaszWymiana na długotrwały token lub logowanie przed 60. dniemBrak tokena Meta do wymiany
Przy błędzie 190Odczytaj subkod, potem poproś użytkownika o ponowne logowanieW 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 API
Co monitorujesz
Tokeny Metaexpires_at i data_access_expires_at każdego tokena
UnipileStatus każdej Strony w metadata.products_connection_status
Co 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.

Komisja Europejska
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