IT
Guida agli access token

Access token dell'API Facebook: token utente, di Pagina, di app e di utente di sistema

Come ottenere ogni token, estenderlo a circa 60 giorni, verificarlo con debug_token e gestire l'errore 190, e come un'app SaaS può fare a meno della pipeline dei token.

Verifica token 200 OK
GETgraph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN}
applicationLa vostra app
is_validtrue
expires_attra 60 giorniuser token di lunga durata
data_access_expires_attra 90 giornirinnovato se l'utente è attivo
scopespublic_profilepages_show_list
TOKEN Nessun refresh token: verificare, poi nuovo login
In breve

Un access token dell'API Facebook è la stringa richiesta da ogni chiamata alla Graph API. Si ottiene uno user token tramite Facebook Login (o il Graph API Explorer per i test), lo si scambia sul proprio server con un token di lunga durata di circa 60 giorni, poi si chiama /me/accounts per i Page token. Non esistono chiave API né refresh token: si monitorano i token con debug_token e si gestisce l'errore 190.

Per un SaaS con molti clienti esiste un secondo modello: gli utenti collegano i propri account Facebook tramite Unipile e la vostra app non detiene mai un token Meta.

Con Unipile

Nessun token Meta da ottenere, estendere o debuggare

  1. 1

    Collegate l'account

    L'utente collega una sola volta il suo account Facebook o la sua Pagina tramite Hosted Auth. Nessuna app Meta, nessuna App Review.

  2. 2

    Chiamate con la vostra chiave API

    Inviate X-API-KEY con l'account_id dell'utente: GET /v2/{ACCOUNT_ID}/chats.

  3. 3

    Monitorate un solo stato

    Controllate products_connection_status; se necessario, l'utente si ricollega tramite Hosted Auth.

Definizione

Che cos'è un access token dell'API Facebook?

Meta definisce un access token come «una stringa opaca che identifica un utente, un'app o una Pagina Facebook». Ogni richiesta alla Graph API ne include uno, e il suo tipo determina per conto di chi si agisce.

TokenAgisce perCome si ottieneDurata e uso
UtenteUna persona che ha effettuato l'accessoFacebook Login o Graph API ExplorerDa 1 a 2 ore, o circa 60 giorni
PaginaUna Pagina Facebook/me/accounts con lo user token di un amministratoreSegue il suo user token
AppLa vostra app MetaChiamata client_credentials, o {APP_ID}|{APP_SECRET}Solo chiamate server-to-server
Utente di sistemaLa vostra aziendaImpostazioni del BusinessNessuna scadenza, o 60 giorni
ClientLa vostra app, nel codice clientDashboard dell'appNon è un segreto
Token utente
Agisce perUna persona che ha effettuato l'accesso
Come si ottieneFacebook Login o Graph API Explorer
Durata e usoDa 1 a 2 ore, o circa 60 giorni
Token di Pagina
Agisce perUna Pagina Facebook
Come si ottiene/me/accounts con lo user token di un amministratore
Durata e usoSegue il suo user token
Token di app
Agisce perLa vostra app Meta
Come si ottieneChiamata client_credentials, o {APP_ID}|{APP_SECRET}
Durata e usoSolo chiamate server-to-server
Token di utente di sistema
Agisce perLa vostra azienda
Come si ottieneImpostazioni del Business
Durata e usoNessuna scadenza, o 60 giorni
Token client
Agisce perLa vostra app, nel codice client
Come si ottieneDashboard dell'app
Durata e usoNon è un segreto

Instagram ha un flusso proprio: consultate la nostra guida al token dell'API Instagram.

Fonte: la guida Access Tokens di Meta. Ultima verifica: 17 novembre 2026.

Ottenere un token

Come ottenere un access token dell'API Facebook

Non esiste una chiave API Facebook: ogni chiamata usa un access token. Per i test, generatene uno per il vostro account nel Graph API Explorer. In produzione, gli utenti accedono alla vostra app Meta con Facebook Login (for Business quando servono le loro Pagine) e il vostro server scambia il codice ricevuto con uno user access token.

Test, in 4 passaggi

Graph API Explorer

  1. Aprite developers.facebook.com/tools/explorer
  2. Scegliete la vostra app Meta e «User Token»
  3. Aggiungete le autorizzazioni necessarie
  4. Cliccate su Generate Access Token e approvate
Produzione, in 4 passaggi

Facebook Login nella vostra app Meta

  1. Create un'app Meta (App ID, App Secret)
  2. Indirizzate gli utenti a /dialog/oauth con client_id, redirect_uri, state
  3. Concedono le autorizzazioni; ricevete un code
  4. Il vostro server chiama /oauth/access_token con il code e l'App Secret

La risposta contiene access_token, token_type ed expires_in. Altre persone possono concedere autorizzazioni solo dopo che l'App Review ha dato alla vostra app l'Advanced Access. Il percorso di accesso completo è nella nostra panoramica dell'API Facebook, e il lato Pagine nella guida all'API Pagine Facebook.

Fonte: la guida Manually Build a Login Flow di Meta (Graph API v27.0). Ultima verifica: 17 novembre 2026.

Token di lunga durata

Come ottenere un access token di lunga durata

Inviate lo user token di breve durata a GET /oauth/access_token con grant_type=fb_exchange_token, il vostro App ID e il vostro App Secret. La risposta contiene un token di lunga durata e il relativo expires_in, circa 60 giorni. Meta è esplicita: «Effettuate questa chiamata dal vostro server, non da un client».

  • Scambiatelo prima della scadenza. «Non è possibile usare un token scaduto per richiedere un token di lunga durata»: una volta scaduto il token breve, l'utente deve accedere di nuovo.
  • Salvate la scadenza come data accanto al token.
  • Solo per test? L'Access Token Debugger ha un pulsante Extend Access Token che fa lo stesso per un vostro token.

Il ciclo di vita del token nel codice

Le schede da 1 a 3 usano la Graph API di Meta; la scheda 4 è Unipile, senza token 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 · user token di lunga durata, circa 60 giorni
200 OK · mai nel codice client o nei binari dell'app
200 OK · is_valid, expires_at, data_access_expires_at
200 OK · un account_id, nessun token da scambiare

Richieste tratte dalle guide Long-Lived Access Tokens e Access Tokens di Meta. Unipile: documentazione Facebook Pages.

I Page token, in breve

Con lo user token di lunga durata di un amministratore della Pagina, GET /me/accounts restituisce ogni Pagina con il proprio token, che «non ha una data di scadenza e scade o viene invalidato solo in determinate condizioni». I dettagli sono nella guida all'API Pagine Facebook; per pubblicare con questo token, vedete come pubblicare su una Pagina con il suo token.

Durata

Quanto dura un access token di Facebook?

Secondo Meta, uno user token di breve durata vale da una a due ore circa e uno di lunga durata circa 60 giorni. I Page token ottenuti da un token di lunga durata e alcuni token di utente di sistema non hanno data di scadenza. A parte questo, l'accesso ai dati di un utente si interrompe dopo 90 giorni di inattività.

Facebook Durata dei token, secondo Meta
User token di breve durataDa 1 a 2 ore
User token di lunga durataCirca 60 giorni
Page token, da uno user token di lunga durataNessuna data di scadenza
Token di utente di sistemaMai, o 60 giorni
Accesso ai dati dell'utente90 giorni dopo l'ultima attività
La scadenza del token non è la scadenza dell'accesso ai dati

Meta indica che «il periodo di scadenza dell'accesso ai dati è di 90 giorni, a partire dall'ultima attività dell'utente». L'utente resta connesso, ma la vostra app non può leggere i suoi dati finché non la autorizza di nuovo.

Nessun token è permanente: anche un token «senza scadenza» smette di funzionare quando l'utente rimuove la vostra app, cambia password o perde il proprio ruolo. Meta avverte: «Non fate affidamento sul fatto che queste durate restino invariate».

Fonti: le guide di Meta Access Tokens, Long-Lived Access Tokens, Authorization vs. data access e la pagina sui token di utente di sistema. Ultima verifica: 17 novembre 2026.

Utente di sistema

Access token di utente di sistema per i processi server-to-server

Un system user access token appartiene a un utente di sistema del vostro Business Manager, non a una persona. Secondo Meta consente alla «vostra app di eseguire azioni programmatiche e automatizzate su oggetti Ad o Pagine». Si genera nelle Impostazioni del Business.

Opzione 1

Non scade mai

Nessun rinnovo, per i casi in cui la fuga di un token è un rischio accettabile.

Opzione 2, consigliata

Scade dopo 60 giorni

Impostate set_token_expires_in_60_days=true e rinnovate con fb_exchange_token prima del 60° giorno.

  • Solo la stessa azienda. L'utente di sistema e l'app appartengono allo stesso Business Manager e, «se l'utente non ha accesso, la richiesta viene rifiutata».
  • Prima serve l'accesso alla Marketing API: accesso standard o superiore.

Fonti: le guide di Meta Install apps and generate tokens e Access Tokens. Ultima verifica: 17 novembre 2026.

Debug

Come verificare un access token di Facebook con debug_token

Chiamate GET /debug_token?input_token={TOKEN} con un app access token (o lo user token di uno sviluppatore dell'app). Restituisce validità, scadenza, scadenza dell'accesso ai dati e autorizzazioni concesse. Senza codice, incollate il token nell'Access Token Debugger (developers.facebook.com/tools/debug/accesstoken).

Facebook Cosa restituisce debug_token
is_validSe il token funziona ancora.
expires_atScadenza del token, come timestamp Unix; 0 significa nessuna data di scadenza.
data_access_expires_atQuando termina l'accesso ai dati, anche con un token valido.
scopesAutorizzazioni concesse; granular_scopes aggiunge gli ID di destinazione.
app_id, user_idPer chi è stato emesso il token.
profile_idL'ID della Pagina, per un Page token.

Per verificare in produzione se un access token di Facebook è valido, eseguite periodicamente sul vostro server la richiesta della scheda 3 del blocco di codice qui sopra e salvate entrambe le date con ogni token. Un'autorizzazione mancante in scopes spiega la maggior parte dei bug del tipo «da me funziona, da loro no».

Fonte: il riferimento debug_token di Meta (Graph API v27.0). Ultima verifica: 17 novembre 2026.

Errori

Errori dell'access token di Facebook: il codice 190 e i suoi subcode

L'errore 190 significa che l'access token di Facebook è scaduto o non è valido. Viene restituito come OAuthException e il suo error_subcode indica cosa chiedere all'utente. Riprovare con lo stesso token non risolve mai il problema.

Facebook Cosa restituisce la Graph API

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

190 Leggere error_subcode, conservare fbtrace_id per il supporto Meta
SubcodeSignificatoCosa fare
458App non installataFar accedere di nuovo l'utente
459Utente bloccato da un checkpointL'utente accede su facebook.com
460Password modificataFar accedere di nuovo l'utente
463Token scadutoNuovo accesso, poi nuovo scambio
464Utente non confermatoL'utente accede su facebook.com
467Token non validoRicollegare l'utente
492Nessun ruolo adeguato sulla PaginaNuovo token da un amministratore attuale
Subcode 458
SignificatoApp non installata
Cosa fareFar accedere di nuovo l'utente
Subcode 459
SignificatoUtente bloccato da un checkpoint
Cosa fareL'utente accede su facebook.com
Subcode 460
SignificatoPassword modificata
Cosa fareFar accedere di nuovo l'utente
Subcode 463
SignificatoToken scaduto
Cosa fareNuovo accesso, poi nuovo scambio
Subcode 464
SignificatoUtente non confermato
Cosa fareL'utente accede su facebook.com
Subcode 467
SignificatoToken non valido
Cosa fareRicollegare l'utente
Subcode 492
SignificatoNessun ruolo adeguato sulla Pagina
Cosa fareNuovo token da un amministratore attuale

In un SaaS multi-cliente, il 492 è il caso classico: l'amministratore che ha collegato una Pagina se ne va. Gli altri codici sono nella nostra tabella degli errori dell'API Facebook.

Fonte: la guida Graph API error handling di Meta. Ultima verifica: 17 novembre 2026.

Sicurezza

Archiviare e proteggere gli access token di Facebook

Trattate ogni access token di Facebook come la password dell'account a cui appartiene: tenete App Secret e token di app sul vostro server, cifrate a riposo i token utente e di Pagina, firmate le chiamate server con appsecret_proof ed eliminate i token non appena un cliente si scollega.

  • Segreti solo lato server. Meta: «Non inserite mai gli app access token nel codice lato client o nei binari dell'app» e «Usate gli app access token solo nelle chiamate server-to-server».
  • I token client sono pubblici. Meta precisa che «non sono segreti»: non usateli mai per autorizzare operazioni sensibili.
  • Firmate le chiamate con appsecret_proof. Meta lo definisce «un hash sha256 del vostro access token, che usa l'app secret come chiave»; attivate Require App Secret nella dashboard dell'app.
  • Cifratura a riposo, HTTPS in transito. Tenete i token fuori da log e URL.
  • Un record per token. Salvate utente, Pagina, app ed expires_at.
  • Eliminazione alla disconnessione. Cancellate il token quando un utente se ne va.

Fonti: le guide Access Tokens e Securing Requests di Meta. Ultima verifica: 17 novembre 2026.

Con Unipile

Niente gestione dei token: collegate gli account Facebook dei vostri utenti

Con Unipile, ogni utente collega il proprio account Facebook una sola volta, tramite Hosted Auth. Le Pagine che gestisce arrivano sullo stesso account_id e voi chiamate l'API con la vostra chiave (X-API-KEY). Nessun token Meta, nessuna app Meta e nessuna App Review da parte vostra.

DomandaAccess token MetaAccount collegato a Unipile
Cosa salvateUn token per utente, più uno per Pagina, amministratore e appUn account_id per utente e una chiave API
Cosa monitorateexpires_at e data_access_expires_at per ogni tokenUno stato per Pagina in metadata.products_connection_status
Cosa rinnovateScambio di lunga durata o login prima del 60° giornoNessun token Meta da scambiare
In caso di errore 190Analizzare il subcode, poi chiedere all'utente di accedere di nuovoL'utente si ricollega tramite Hosted Auth se necessario
Cosa salvate
Token MetaUn token per utente, più uno per Pagina, amministratore e app
UnipileUn account_id per utente e una chiave API
Cosa monitorate
Token Metaexpires_at e data_access_expires_at per ogni token
UnipileUno stato per Pagina in metadata.products_connection_status
Cosa rinnovate
Token MetaScambio di lunga durata o login prima del 60° giorno
UnipileNessun token Meta da scambiare
In caso di errore 190
Token MetaAnalizzare il subcode, poi chiedere all'utente di accedere di nuovo
UnipileL'utente si ricollega tramite Hosted Auth se necessario

Un account collegato copre messaggi, inbox delle Pagine, post, commenti e reazioni. Una Pagina può rispondere alle proprie conversazioni e pubblicare post, ma non può avviare una conversazione. Vedete la scheda 4 qui sopra e la nostra pagina API Facebook Messenger.

Conformità

Ogni utente collega il proprio account

Unipile è un'azienda indipendente, non un'app ufficiale di Meta né un Meta Partner. Agisce per conto di ogni utente autenticato e ogni utente resta vincolato ai termini di Meta.

Sviluppate su Facebook senza pipeline di token

Ogni utente collega il proprio account Facebook una sola volta; voi usate un'unica API per Facebook, LinkedIn, WhatsApp ed email. Prova gratuita di 7 giorni.

Commissione europea
Regolamentato dall'UE Digital Markets Act (DMA)

Ogni utente collega il proprio account, senza archiviazione dei profili. Unipile non è un Meta Partner. Per saperne di più

Tutti gli endpoint dell'API Facebook in un unico posto

Una volta collegato l'account, consultate tutti gli endpoint Facebook disponibili con Unipile, oppure leggete la guida completa all'API Facebook per autorizzazioni, limiti ed errori.

FAQ sull'access token dell'API Facebook

Risposte rapide su durata dei token, rinnovo, verifica della validità, archiviazione ed errore 190.

Non davvero. Uno user token di lunga durata vale circa 60 giorni. I Page token derivati da esso e alcuni token di utente di sistema non hanno data di scadenza, ma smettono comunque di funzionare quando l'utente rimuove la vostra app, cambia password o perde il proprio ruolo. Prevedete un flusso di ricollegamento.

Non nel senso OAuth: Meta non documenta alcun grant refresh_token per Facebook Login. Si scambia un token di breve durata ancora valido con fb_exchange_token; una volta scaduto un token, l'utente deve accedere di nuovo. Nelle app mobili native, Meta rinnova i token di lunga durata una volta al giorno quando la persona usa la vostra app.

Perché 60 giorni sono un limite massimo, non una garanzia. Un token scade in anticipo quando l'utente cambia password, rimuove la vostra app, incontra un checkpoint di sicurezza o perde il proprio ruolo sulla Pagina, e Meta avverte che le durate «possono cambiare senza preavviso o scadere in anticipo». Leggete l'error_subcode dell'errore 190 per capire di quale caso si tratta.

Chiamate GET /debug_token?input_token={TOKEN} con il vostro app access token e leggete is_valid, expires_at, data_access_expires_at e scopes. Per una verifica occasionale, incollate il token nell'Access Token Debugger di Meta.

Sì, se li trattate come password: cifrateli a riposo, teneteli fuori dai log e dal codice client e usate l'App Secret e i token di app solo nelle chiamate server-to-server. Firmate le chiamate server con appsecret_proof.

L'errore 190 con subcode 492 indica una sessione non valida: l'utente a cui è legato un Page access token non ha più un ruolo adeguato sulla Pagina. Ottenete un nuovo Page token da un amministratore attuale.

No. Unipile è un'azienda indipendente: non è un Meta Partner né un'app ufficiale di Meta, e non è sostenuta, sponsorizzata o approvata da Meta. Facebook è un marchio di Meta Platforms, Inc.

No. Chiamate Unipile con la vostra chiave API e l'account_id di ogni utente collegato. Gli utenti collegano il proprio account Facebook e le Pagine che gestiscono tramite l'autenticazione ospitata di Unipile: nessuna app Meta, App Secret o App Review da parte vostra.

È progettata in linea con il Digital Markets Act: ogni utente collega il proprio account e Unipile agisce per suo conto senza archiviare i profili degli utenti. Maggiori dettagli nella nostra pagina sul Digital Markets Act.

Sì. Ogni account collegato resta vincolato ai Termini di servizio di Meta. Usate l'API per scenari legittimi come assistenza clienti, CRM e conversazioni dirette; spam e automazioni non autorizzate possono portare alla limitazione degli account.

Avete ancora domande? Il nostro team è qui per aiutarvi.

Parla con un esperto