
Guide all'integrazione
Guida all'API di LinkedIn
Guida all'API email
Guida all'API di WhatsApp
Contatta le vendite
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.
graph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN} applicationLa vostra appis_validtrueexpires_attra 60 giorniuser token di lunga duratadata_access_expires_attra 90 giornirinnovato se l'utente è attivoscopesNessun refresh token: verificare, poi nuovo login
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.
Nessun token Meta da ottenere, estendere o debuggare
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.
Chiamate con la vostra chiave API
Inviate X-API-KEY con l'account_id dell'utente: GET /v2/{ACCOUNT_ID}/chats.
Monitorate un solo stato
Controllate products_connection_status; se necessario, l'utente si ricollega tramite Hosted Auth.
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.
| Token | Agisce per | Come si ottiene | Durata e uso |
|---|---|---|---|
| Utente | Una persona che ha effettuato l'accesso | Facebook Login o Graph API Explorer | Da 1 a 2 ore, o circa 60 giorni |
| Pagina | Una Pagina Facebook | /me/accounts con lo user token di un amministratore | Segue il suo user token |
| App | La vostra app Meta | Chiamata client_credentials, o {APP_ID}|{APP_SECRET} | Solo chiamate server-to-server |
| Utente di sistema | La vostra azienda | Impostazioni del Business | Nessuna scadenza, o 60 giorni |
| Client | La vostra app, nel codice client | Dashboard dell'app | Non è un segreto |
/me/accounts con lo user token di un amministratoreclient_credentials, o {APP_ID}|{APP_SECRET}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.
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.
developers.facebook.com/tools/explorer/dialog/oauth con client_id, redirect_uri, statecode/oauth/access_token con il code e l'App SecretLa 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.
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».
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}"
Richieste tratte dalle guide Long-Lived Access Tokens e Access Tokens di Meta. Unipile: documentazione Facebook Pages.
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.
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à.
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.
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.
Nessun rinnovo, per i casi in cui la fuga di un token è un rischio accettabile.
Impostate set_token_expires_in_60_days=true e rinnovate con fb_exchange_token prima del 60° giorno.
Fonti: le guide di Meta Install apps and generate tokens e Access Tokens. Ultima verifica: 17 novembre 2026.
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).
0 significa nessuna data di scadenza.granular_scopes aggiunge gli ID di destinazione.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.
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.
{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }
Leggere error_subcode, conservare fbtrace_id per il supporto Meta
| Subcode | Significato | Cosa fare |
|---|---|---|
| 458 | App non installata | Far accedere di nuovo l'utente |
| 459 | Utente bloccato da un checkpoint | L'utente accede su facebook.com |
| 460 | Password modificata | Far accedere di nuovo l'utente |
| 463 | Token scaduto | Nuovo accesso, poi nuovo scambio |
| 464 | Utente non confermato | L'utente accede su facebook.com |
| 467 | Token non valido | Ricollegare l'utente |
| 492 | Nessun ruolo adeguato sulla Pagina | Nuovo 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.
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.
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.expires_at.Fonti: le guide Access Tokens e Securing Requests di Meta. Ultima verifica: 17 novembre 2026.
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.
| Domanda | Access token Meta | Account collegato a Unipile |
|---|---|---|
| Cosa salvate | Un token per utente, più uno per Pagina, amministratore e app | Un account_id per utente e una chiave API |
| Cosa monitorate | expires_at e data_access_expires_at per ogni token | Uno stato per Pagina in metadata.products_connection_status |
| Cosa rinnovate | Scambio di lunga durata o login prima del 60° giorno | Nessun token Meta da scambiare |
| In caso di errore 190 | Analizzare il subcode, poi chiedere all'utente di accedere di nuovo | L'utente si ricollega tramite Hosted Auth se necessario |
account_id per utente e una chiave APIexpires_at e data_access_expires_at per ogni tokenmetadata.products_connection_statusUn 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.
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.
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.
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