
Guide all'integrazione
Guida all'API di LinkedIn
Guida all'API email
Guida all'API di WhatsApp
Contatta le vendite
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.
graph.facebook.com/me/accounts?fields=id,name,tasks,access_token access_token: {PAGE_ACCESS_TOKEN_1}
access_token: {PAGE_ACCESS_TOKEN_2}
Un Page token per Pagina, admin e app
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.
Le Pagine dei vostri utenti, senza Page token da gestire
Collegate. L'utente collega il suo account Facebook tramite Hosted Auth e le sue Pagine arrivano insieme. Nessuna app Meta, nessuna App Review.
Elencate le Pagine. Chiamate GET /v2/{ACCOUNT_ID}/inboxes con la vostra X-API-KEY: ogni Pagina è una inbox PAGE_<page_id>_INBOX.
Agite come la Pagina. Rispondete con POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send, oppure pubblicate come la Pagina con post_as.
È 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.
GET / POST /{page-id}pages_manage_metadata · MANAGEPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENTGET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATEGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZEGET /{page-id}/conversationspages_messaging · MESSAGINGPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_listLe 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.
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.
Su Meta for Developers, con il caso d'uso "Manage everything on your Page".
App ID + App SecretRichiedere pages_show_list e ciò che serve alle vostre funzionalità.
Di breve durata: scambiarlo lato server (fb_exchange_token) con uno di lunga durata.
Ogni Pagina restituisce ID, task e token.
GET /me/accountsMeta: «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.
Per fare test su una Pagina che gestite, senza scrivere codice:
pages_show_list più le autorizzazioni che volete testare.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.
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.
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.
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.
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.
I task indicano cosa una persona può fare su una Pagina. /me/accounts li elenca per ogni Pagina; un amministratore può svolgerli tutti.
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.
pages_read_engagementLeggere 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.
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.
Solo chi ha un ruolo nell'app può concedere le autorizzazioni.
Una richiesta per autorizzazione e un'azienda verificata.
Qualsiasi amministratore di Pagina può concedere le autorizzazioni approvate.
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:
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.
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, 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.
Un problema su una Pagina non influisce sull'inbox personale né sulle altre Pagine.
api.unipile.com/v2/{ACCOUNT_ID}/inboxes
200 OK
PAGE_<page_id>_INBOXpost_as (API post Facebook)501 api/not_implemented)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.
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." }'
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.
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.
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.
| Domanda | Pages API di Meta | Account collegato Unipile |
|---|---|---|
| Chi collega la Pagina | Un amministratore della Pagina, tramite Facebook Login for Business nella vostra app Meta | Il vostro utente, tramite Hosted Auth |
| App Meta e App Review | Obbligatorie, più Advanced Access e Business Verification | Non necessarie da parte vostra |
| Token da gestire | Un Page token per Pagina, amministratore e app | Nessuno: un account_id e la vostra chiave API |
| Messaggi della Pagina | Messenger Platform, pages_messaging, finestra di 24 ore | Lettura e risposta; una Pagina non può avviare una conversazione |
| Pubblicare come Pagina | pages_manage_posts | post_as sull'endpoint dei post |
| Account personale dell'amministratore | Non disponibile per la messaggistica | Stessa connessione: chat personali, post e profilo |
| Stato per Pagina | Controllate voi ogni token | page_<page_id> in products_connection_status |
account_id e la vostra chiave APIpages_messaging, finestra di 24 orepages_manage_postspost_as sull'endpoint dei postpage_<page_id> in products_connection_statusSiete 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.
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.
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