IT
Guida alla Pages API

API Pagine Facebook: Page access token, autorizzazioni e un modo più semplice di collegare le Pagine

Page access token, task della Pagina, autorizzazioni pages_* e App Review nel 2026, e come un'app SaaS può collegare le Pagine gestite dai propri utenti.

Page access token 200 OK
GETgraph.facebook.com/me/accounts?fields=id,name,tasks,access_token
Northwind BakeryFacebookPagina · controllo totale
access_token: {PAGE_ACCESS_TOKEN_1}
CREATE_CONTENTMODERATEMESSAGINGANALYZEADVERTISEMANAGE
Harbor YogaFacebookPagina · accesso parziale
access_token: {PAGE_ACCESS_TOKEN_2}
ANALYZEMESSAGING
Richiede pages_show_list Facebook Login for Business App Review per le Pagine dei clienti
TOKEN Un Page token per Pagina, admin e app
In breve

L'API Pagine Facebook (Meta la chiama Facebook Pages API) è un insieme di endpoint della Graph API per gestire una Pagina Facebook: pubblicare e leggere post, moderare i commenti, leggere gli insights e gestire le conversazioni della Pagina. Ogni chiamata richiede un Page access token, ottenuto da una persona che può svolgere task sulla Pagina. Per le vostre Pagine, gestite da persone con un ruolo sulla vostra app, non serve l'App Review; per servire le Pagine dei vostri clienti occorre un'app che l'abbia superata.

Per un SaaS con molti clienti esiste un secondo modello: gli utenti collegano i propri account Facebook tramite Unipile e le loro Pagine arrivano insieme alla connessione.

Con Unipile

Le Pagine dei vostri utenti, senza Page token da gestire

  1. Collegate. L'utente collega il suo account Facebook tramite Hosted Auth e le sue Pagine arrivano insieme. Nessuna app Meta, nessuna App Review.

  2. Elencate le Pagine. Chiamate GET /v2/{ACCOUNT_ID}/inboxes con la vostra X-API-KEY: ogni Pagina è una inbox PAGE_<page_id>_INBOX.

  3. Agite come la Pagina. Rispondete con POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send, oppure pubblicate come la Pagina con post_as.

Definizione

Cos'è l'API Pagine Facebook?

È la parte della Graph API costruita attorno al nodo Page: endpoint che leggono e modificano una Pagina, i suoi post, i commenti e le metriche. La messaggistica passa dalla Messenger Platform e le inserzioni dalla Marketing API, con lo stesso Page access token.

Nonostante il nome, la Graph API non è GraphQL. È un'API HTTP con versioni, su graph.facebook.com, organizzata in nodi, edge e campi. Per il quadro completo (Login, Messenger, versioni, rate limit), vedete come si combinano le API di Facebook.

Facebook Cosa copre la Pages API
Dati della PaginaLeggere e aggiornare dati e impostazioni della PaginaGET / POST /{page-id}pages_manage_metadata · MANAGE
PostPubblicare, leggere, modificare ed eliminare post come PaginaPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENT
CommentiLeggere, rispondere ed eliminare i commenti ai post della Pagina (guida all'API dei commenti)GET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATE
InsightsMetriche della Pagina e dei postGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZE
ConversazioniL'inbox della Pagina, tramite la Messenger PlatformGET /{page-id}/conversationspages_messaging · MESSAGING
WebhookEventi in tempo reale su feed e inbox della Pagina, una volta installata l'app sulla Pagina tramite l'edge subscribed_appsPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_list

Limiti di frequenza della Facebook Pages API

Le chiamate effettuate con un Page access token rientrano nei limiti Business Use Case di Meta, calcolati per Pagina: 4.800 chiamate moltiplicate per il numero di utenti coinvolti nelle 24 ore, cioè le persone che hanno interagito con la Pagina in quell'intervallo. Ogni risposta contiene un header X-Business-Use-Case-Usage con il vostro utilizzo attuale. I limiti delle altre API Facebook sono nella nostra guida all'API Facebook.

Fonti: la panoramica della Pages API, Manage a Page, Page Insights, Webhooks for Pages, Posts, Comments, Page conversations, subscribed_apps, il rate limiting e il riferimento delle autorizzazioni di Meta. Ultima verifica: 17 novembre 2026.

Access token

Come ottenere un Page access token di Facebook

Non esiste una chiave API per le Pagine Facebook. Un amministratore della Pagina accede alla vostra app Meta con Facebook Login for Business, che vi fornisce uno user access token. Poi GET /me/accounts restituisce tutte le Pagine che gestisce, con i relativi task e un Page access token per ciascuna.

1

Creare un'app Meta

Su Meta for Developers, con il caso d'uso "Manage everything on your Page".

App ID + App Secret
2

Aggiungere Facebook Login for Business

Richiedere pages_show_list e ciò che serve alle vostre funzionalità.

Finestra di login
3

Ottenere uno user access token

Di breve durata: scambiarlo lato server (fb_exchange_token) con uno di lunga durata.

{USER_ACCESS_TOKEN}
4

Chiamare /me/accounts

Ogni Pagina restituisce ID, task e token.

GET /me/accounts

Meta: «I Page access token sono unici per ogni combinazione di Pagina, amministratore e app». Dieci Pagine di clienti, dieci token da salvare e monitorare.

La chiamata di scambio e la richiesta /me/accounts sono pronte da copiare nella scheda «Scambio token Meta» del blocco di codice più sotto. I token utente, app e utente di sistema sono trattati nella nostra guida al token di accesso API Facebook.

Ottenere un Page access token nel Graph API Explorer

Per fare test su una Pagina che gestite, senza scrivere codice:

  • Scegliete la vostra app nel menu delle app del Graph API Explorer e aggiungete pages_show_list più le autorizzazioni che volete testare.
  • Aprite il menu «User or Page», scegliete la vostra Pagina e generate il token: l'Explorer vi chiede di concedere le autorizzazioni.
  • Copiate il token mostrato in alto nello strumento. È di breve durata: scambiatelo come al passaggio 3 per ottenere un Page token che non scade.

Quanto dura un Page access token di Facebook?

Dipende dallo user token di partenza. Un Page token ottenuto con uno user token di breve durata vale circa un'ora. Scambiate prima lo user token con uno di lunga durata, richiamate /me/accounts e, secondo Meta, il Page token ottenuto non ha data di scadenza, anche se può comunque essere invalidato.

Facebook Durata dei token secondo Meta
User token di breve durataDa una a due ore circa
User token di lunga durataCirca 60 giorni
Page token da uno user token di breve durata«Valido per 1 ora»
Page token da uno user token di lunga durata«Non ha data di scadenza», ma può essere invalidato

Fonti: Access Tokens, Long-Lived Access Tokens e Get a Page Access Token di Meta; i passaggi del Graph API Explorer vengono dalla sua guida. Meta aggiunge: «Non fate affidamento sul fatto che queste durate restino invariate». Ultima verifica: 17 novembre 2026.

Un Page access token di Facebook può non scadere mai?

Sì. Un Page access token di lunga durata, ottenuto chiamando /me/accounts con uno user token di lunga durata, non ha data di scadenza. Secondo Meta, i Page access token di lunga durata «scadono o vengono invalidati solo in determinate condizioni». È il Page token «permanente» di cui parlano la maggior parte delle guide. Non è però eterno: gli eventi qui sotto lo invalidano comunque, quindi salvatelo, monitorate gli errori e prevedete un flusso di ricollegamento. Per le Pagine di proprietà della vostra azienda, l'altra opzione è un token utente di sistema.

Cosa invalida un Page token in produzione

  • L'amministratore perde il ruolo sulla Pagina. Meta rilascia Page token solo a chi ha un ruolo sulla Pagina: ottenete un nuovo token da un altro amministratore.
  • L'amministratore si disconnette dalla vostra app, cambia password o rimuove la vostra app. Deve accedere di nuovo.
  • La vostra app perde un'autorizzazione. L'accesso si interrompe allora per tutti i clienti contemporaneamente.

Meta segnala questi casi con l'errore 190. I relativi subcode e come verificare un token con debug_token sono descritti nella nostra guida al token di accesso API Facebook; per un Page token la soluzione è sempre la stessa: chiedere all'amministratore di ricollegarsi.

Autorizzazioni

Task della Pagina e autorizzazioni: chi può fare cosa

Una chiamata va a buon fine solo se la persona dietro il token può svolgere il task corrispondente sulla Pagina e se la vostra app dispone dell'autorizzazione corrispondente, con l'Advanced Access per le persone esterne all'app.

Gli 8 task della Pagina

I task indicano cosa una persona può fare su una Pagina. /me/accounts li elenca per ogni Pagina; un amministratore può svolgerli tutti.

Facebook Task della Pagina
ADVERTISECreare inserzioni e post della Pagina non pubblicati
ANALYZEVedere gli insights della Pagina e quale amministratore ha pubblicato un post o un commento
CREATE_CONTENTPubblicare contenuti come Pagina
MANAGEAssegnare e gestire i task della Pagina; necessario anche per aggiornarne dati e impostazioni
MANAGE_LEADSVedere e gestire i lead
MESSAGINGInviare messaggi come Pagina
MODERATERispondere ai commenti sui post della Pagina ed eliminarli
VIEW_MONETIZATION_INSIGHTSVedere gli insights sulla monetizzazione

Le autorizzazioni pages_* da richiedere

Le autorizzazioni indicano cosa può fare la vostra app. Un'app Meta creata con il caso d'uso "Manage everything on your Page" parte con pages_show_list, business_management e public_profile. Aggiungete solo ciò che una funzionalità usa: ogni autorizzazione viene esaminata separatamente.

Facebook Autorizzazioni pages_*
pages_show_listElencare le Pagine gestite da una persona: il selettore di Pagine dopo il login
pages_read_engagementLeggere contenuti, metadati, follower e insights della Pagina
pages_manage_postsCreare, modificare ed eliminare i post della Pagina
pages_manage_engagementCreare, modificare ed eliminare i commenti pubblicati sulla Pagina
pages_read_user_contentLeggere post e commenti dei visitatori sulla Pagina, eliminarne i commenti
read_insightsLeggere gli insights della Pagina, insieme a pages_read_engagement
pages_messagingGestire e accedere alle conversazioni della Pagina su Messenger
pages_manage_metadataIscriversi ai webhook della Pagina e aggiornarne le impostazioni

Leggere Pagine che non gestite è un caso diverso: richiede la funzionalità Page Public Content Access, che Meta limita all'analisi o alla visualizzazione di post e interazioni sulle Pagine, con una propria App Review e la Business Verification.

Fonti: la panoramica della Pages API (task), Manage a Page (MANAGE per le impostazioni), Page Insights, il riferimento delle autorizzazioni (descrizioni riassunte) e Page Public Content Access di Meta. Ultima verifica: 17 novembre 2026.

App Review

App Review: perché funziona sulla vostra Pagina ma non su quelle dei clienti

La vostra app parte con lo Standard Access e Meta precisa che «le autorizzazioni con Standard Access possono essere richieste solo agli utenti che hanno un ruolo nell'app richiedente». Il prototipo funziona sulla vostra Pagina e fallisce quando un cliente effettua l'accesso. Per servire le loro Pagine serve l'Advanced Access, concesso per singola autorizzazione tramite l'App Review.

1Standard Access

Solo il vostro team

Solo chi ha un ruolo nell'app può concedere le autorizzazioni.

2Revisione

App Review

Una richiesta per autorizzazione e un'azienda verificata.

3Advanced Access

Live per i clienti

Qualsiasi amministratore di Pagina può concedere le autorizzazioni approvate.

Cosa deve gestire un SaaS multi-cliente

Una volta in produzione, ogni Pagina cliente è una piccola integrazione a sé: un login dell'amministratore, un token salvato, i task di quell'amministratore, un controllo di stato e un flusso di riconnessione. Nulla nell'API Pagine Facebook li tiene sotto controllo per voi tra i diversi tenant. La guida all'invio di Meta richiede:

  • Una registrazione dello schermo per autorizzazione, che mostri l'utente mentre la concede e la funzionalità che la usa: «Qualsiasi autorizzazione o funzionalità richiesta priva di registrazione dello schermo non sarà approvata».
  • Una descrizione per autorizzazione, il più specifica possibile.
  • Accesso per i revisori: un'app pubblica o istruzioni per raggiungere la funzionalità.
  • Solo le autorizzazioni di cui l'app ha bisogno.

Meta richiede anche la Business Verification: «La Business Verification è necessaria per ottenere l'Advanced Access».

Fonti: i livelli di accesso, la guida all'invio per l'App Review e la panoramica della Pages API di Meta («Tutte le autorizzazioni e funzionalità relative alle Pagine richiedono l'approvazione tramite il processo di App Review»). Ultima verifica: 17 novembre 2026.

Messaggistica

Messaggi delle Pagine Facebook: dove la Pages API passa il testimone a Messenger

Le conversazioni della Pagina non fanno parte della Pages API vera e propria. Passano dalla Messenger Platform, con lo stesso Page access token, l'autorizzazione pages_messaging e il task MESSAGING.

Le persone sono identificate da un Page-scoped ID (PSID), scrivono per prime e la Pagina può rispondere per 24 ore dopo il loro ultimo messaggio. Come un'app SaaS legge e risponde a queste conversazioni è spiegato nella nostra pagina sull'API Facebook Messenger. Per le conversazioni di un profilo personale, consultate l'API Facebook Messenger per account personali; per ciò che Meta fattura, vedete i prezzi dell'API Facebook Messenger.

Con Unipile

Un altro modello: collegare le Pagine gestite dai vostri utenti

Con Unipile, l'utente collega il proprio account Facebook una sola volta, tramite Hosted Auth. Le Pagine che amministra vengono attivate sullo stesso account_id, per impostazione predefinita. Nessuna app Meta, nessuna App Review, nessun Page token da parte vostra.

La tua app Sincronizzato
Una connessione
FacebookAnna LeeInbox personale
FacebookNorthwind BakeryInbox della Pagina
FacebookHarbor YogaInbox della Pagina
Northwind Bakery 2Harbor YogaPersonale
Leo MartinIl negozio è aperto domenica?Pagina
Sara KimFoto di un ordine di tortaPagina
Omar HaddadTu: Pronto a mezzogiornoPagina
Stato della connessione
Inbox personaleConnesso
Northwind BakeryConnesso
Harbor YogaDa verificare

Un problema su una Pagina non influisce sull'inbox personale né sulle altre Pagine.

GET api.unipile.com/v2/{ACCOUNT_ID}/inboxes 200 OK
Una Pagina collegata può
  • Leggere i messaggi della Pagina: ogni Pagina compare come inbox PAGE_<page_id>_INBOX
  • Rispondere nelle conversazioni della Pagina
  • Pubblicare post come Pagina, con il parametro post_as (API post Facebook)
  • Leggere i post della Pagina
Non può
  • Avviare una nuova conversazione: la persona scrive per prima
  • Eliminare i propri messaggi (501 api/not_implemented)
  • Pubblicare storie
  • Usare i Gruppi Facebook

Ogni Pagina indica il proprio stato in metadata.products_connection_status (chiave page_<page_id>). La stessa connessione porta con sé i messaggi personali dell'amministratore e la stessa API copre LinkedIn, WhatsApp, Instagram, Telegram, email e calendari.

Lo stesso compito nel codice

Elencare le Pagine, poi rispondere a una conversazione della Pagina. La scheda «Meta Graph API» usa un Page token, la scheda «Scambio token Meta» mostra come ottenere un Page token che non scade e la scheda «Unipile» usa l'account collegato.

# 1. List the Pages a person manages, with tasks and Page tokens
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={USER_ACCESS_TOKEN}"

# Response (abridged)
{ "data": [ {
    "id": "{PAGE_ID}",
    "name": "Northwind Bakery",
    "tasks": ["CREATE_CONTENT", "MODERATE", "MESSAGING", "ANALYZE"],
    "access_token": "{PAGE_ACCESS_TOKEN}"
} ] }

# 2. Store one token per Page, then call Page endpoints with it
curl "https://graph.facebook.com/{PAGE_ID}/conversations?platform=messenger&access_token={PAGE_ACCESS_TOKEN}"
# 1. Server side: exchange the short lived user token for a long lived one
curl "https://graph.facebook.com/oauth/access_token?grant_type=fb_exchange_token&client_id={APP_ID}&client_secret={APP_SECRET}&fb_exchange_token={SHORT_LIVED_USER_TOKEN}"

# Response
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "token_type": "bearer", "expires_in": 5183944 }

# 2. Call /me/accounts with the long lived user token:
#    the Page tokens it returns have no expiration date
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={LONG_LIVED_USER_TOKEN}"
# 1. List the inboxes of the connected account: one per managed Page,
#    with the ID PAGE_{PAGE_ID}_INBOX
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. List the chats of one Page inbox
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes/PAGE_{PAGE_ID}_INBOX/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 3. Reply in a Page chat (chat ID PAGE_{PAGE_ID}_{THREAD_KEY})
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Yes, we open at 9am on Sunday." }'
200 OK · un Page access token per Pagina, amministratore e app
200 OK · expires_in è in secondi: circa 60 giorni per lo user token
200 OK · un solo account_id per l'inbox personale e tutte le Pagine

Chiamate Meta verificate su Long-Lived Access Tokens il 17 novembre 2026. Attivazione, ID delle inbox e post_as sono descritti nella documentazione Facebook Pages.

Conformità

Ogni utente collega il proprio account

Unipile è un'azienda indipendente, non un'app ufficiale di Meta né un Meta Partner. Si connette per conto di ogni utente autenticato e ogni utente resta vincolato ai termini di Meta. Usatela per le conversazioni con i clienti sulle Pagine gestite dai vostri utenti.

Scelta

Pages API o account collegato: quale si adatta al vostro prodotto?

La Pages API di Meta è adatta a un team che gestisce le proprie Pagine o ha bisogno di insights e inserzioni. Un account collegato è adatto a un SaaS i cui utenti portano le proprie Pagine.

DomandaPages API di MetaAccount collegato Unipile
Chi collega la PaginaUn amministratore della Pagina, tramite Facebook Login for Business nella vostra app MetaIl vostro utente, tramite Hosted Auth
App Meta e App ReviewObbligatorie, più Advanced Access e Business VerificationNon necessarie da parte vostra
Token da gestireUn Page token per Pagina, amministratore e appNessuno: un account_id e la vostra chiave API
Messaggi della PaginaMessenger Platform, pages_messaging, finestra di 24 oreLettura e risposta; una Pagina non può avviare una conversazione
Pubblicare come Paginapages_manage_postspost_as sull'endpoint dei post
Account personale dell'amministratoreNon disponibile per la messaggisticaStessa connessione: chat personali, post e profilo
Stato per PaginaControllate voi ogni tokenpage_<page_id> in products_connection_status
Chi collega la Pagina
Pages API di MetaUn amministratore della Pagina, tramite Facebook Login for Business nella vostra app Meta
UnipileIl vostro utente, tramite Hosted Auth
App Meta e App Review
Pages API di MetaObbligatorie, più Advanced Access e Business Verification
UnipileNon necessarie da parte vostra
Token da gestire
Pages API di MetaUn Page token per Pagina, amministratore e app
UnipileNessuno: un account_id e la vostra chiave API
Messaggi della Pagina
Pages API di MetaMessenger Platform, pages_messaging, finestra di 24 ore
UnipileLettura e risposta; una Pagina non può avviare una conversazione
Pubblicare come Pagina
Pages API di Metapages_manage_posts
Unipilepost_as sull'endpoint dei post
Account personale dell'amministratore
Pages API di MetaNon disponibile per la messaggistica
UnipileStessa connessione: chat personali, post e profilo
Stato per Pagina
Pages API di MetaControllate voi ogni token
Unipilepage_<page_id> in products_connection_status

Siete ancora indecisi tra Login, Messenger, Marketing API e Pagine? La nostra griglia decisionale indica quale API Facebook vi serve per ogni tipo di prodotto.

Collegate le Pagine senza una pipeline di token

Lasciate che ogni utente colleghi il proprio account Facebook una sola volta e gestite inbox e post delle sue Pagine con la stessa API dei suoi account LinkedIn, WhatsApp ed email. Prova gratuita di 7 giorni, senza carta di credito.

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

Le Pagine sono solo una parte del quadro. Consultate tutti gli endpoint Facebook disponibili con Unipile (messaggi, post, commenti, profili, webhook), oppure leggete la guida completa all'API Facebook.

FAQ sull'API Pagine Facebook

Risposte rapide sul Page access token di Facebook, la sua durata, l'App Review e le autorizzazioni.

Fate accedere un amministratore della Pagina alla vostra app Meta con Facebook Login for Business, richiedendo pages_show_list. Scambiate lo user token con uno di lunga durata sul vostro server con grant_type=fb_exchange_token, poi chiamate GET /me/accounts: ogni Pagina viene restituita con il proprio access_token e i task che l'amministratore può svolgere.

Dipende dallo user token da cui deriva. Secondo Meta, un Page token ottenuto con uno user token di breve durata è valido per 1 ora. Se lo ottenete da uno user token di lunga durata (circa 60 giorni), il Page token non ha data di scadenza, ma un logout, un cambio di password o la rimozione dell'app lo invalidano comunque.

Sì. Chiamate /me/accounts con uno user token di lunga durata e i Page token restituiti non hanno data di scadenza. Non sono però permanenti in ogni caso: se l'amministratore perde il suo ruolo sulla Pagina, cambia password o rimuove la vostra app, il token smette di funzionare e l'amministratore deve ricollegarsi.

La vostra app dispone solo dello Standard Access, quindi solo chi ha un ruolo nell'app può concederle autorizzazioni. Per servire le Pagine dei clienti, ogni autorizzazione richiede l'Advanced Access, concesso tramite App Review con una registrazione dello schermo per autorizzazione, e Meta richiede per questo la Business Verification.

Quasi tutte le integrazioni partono da pages_show_list. Poi aggiungete solo ciò che usate: pages_read_engagement per leggere contenuti e metadati, pages_manage_posts per pubblicare, pages_manage_engagement per i commenti, pages_messaging per le conversazioni, pages_manage_metadata per webhook e impostazioni e read_insights per le metriche.

No. Unipile è un'azienda indipendente, non un Meta Partner, e Meta non la sostiene, sponsorizza né approva. Collegare le Pagine tramite Unipile non fa nemmeno del vostro prodotto un'app Meta. Facebook e Messenger sono marchi di Meta Platforms, Inc.

No. Invece di un'app Meta che raccoglie Page access token, i vostri utenti collegano una sola volta il proprio account Facebook tramite l'autenticazione ospitata di Unipile, e le Pagine che amministrano arrivano con quella connessione. Da parte vostra non ci sono App Review, Advanced Access né Business Verification da completare.

È costruita nello spirito del Digital Markets Act: ogni amministratore di Pagina collega il proprio account, Unipile agisce per suo conto sulle Pagine che già gestisce e non memorizza i profili utente. I dettagli sono nella nostra pagina sul Digital Markets Act.

Sì. Una Pagina collegata tramite Unipile resta soggetta alle Condizioni d'uso di Meta e alle normative sulle Pagine. Limitatevi a usi legittimi come rispondere ai clienti nell'inbox della Pagina, pubblicare i contenuti della Pagina stessa o sincronizzare le conversazioni in un CRM; spam e automazioni non autorizzate possono portare alla limitazione dell'account o della Pagina.

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

Parla con un esperto