IT
Guida per sviluppatori

Guida all'API Facebook: Graph API, accesso, limiti e account collegati

Cosa coprono le API Facebook di Meta nel 2026, come ottenere gli access token e superare l'App Review, cosa l'API ufficiale non consente più e come un'app SaaS può invece collegare gli account Facebook dei propri utenti.

La tua app Live
FacebookAnna LeePersonale FacebookNorthwind BakeryPagina
Post
Northwind BakeryCome Pagina · Ora

Il nostro menu autunnale arriva lunedì.

243
Julia NashÈ tornato il pane alla zucca!
Messaggi
Maya RossA Northwind Bakery
Consegnate anche la domenica?
Sì, dalle 9 alle 12.
Visualizzato
Webhook Nuovo messaggio Nuova reazione
GETchats POSTmessages/send POSTposts 200 OK
In breve

Sì, Facebook ha un'API: la Graph API, l'interfaccia HTTP di Meta per leggere e scrivere i dati di Facebook. Prodotti come la Pages API, la Messenger Platform e la Marketing API si basano su di essa. Vi si accede tramite un'app Meta, access token concessi da utenti o Pagine e autorizzazioni approvate nell'App Review.

Questa guida associa ogni API Facebook al tipo di account che serve, spiega accesso e limiti, elenca ciò che Meta ha rimosso e poi presenta un altro modello per le app SaaS: permettere a ogni utente di collegare il proprio account Facebook tramite l'API Facebook Messenger di Unipile.

Definizione

Esiste un'API Facebook?

Sì. Meta espone i dati di Facebook agli sviluppatori tramite la Graph API, un'API HTTP con versioni. Ogni altro prodotto Facebook per sviluppatori, dalla gestione delle Pagine a Messenger fino alle inserzioni, è un insieme di endpoint della Graph API con autorizzazioni e revisione proprie.

Non esiste un'unica chiave API. Ciò che si ottiene dipende dai dati a cui si accede: una persona che effettua l'accesso alla vostra app, una Pagina Facebook che gestisce o un account pubblicitario. Ognuno ha il proprio tipo di token e la propria revisione da parte di Meta.

Facebook Di chi sono i dati che leggete?
Un utenteUser access token da Facebook Login, limitato alle autorizzazioni concesse dalla persona.
Una PaginaPage access token, per chi ha un ruolo (task) su quella Pagina.
Un account pubblicitarioAccesso alla Marketing API tramite un'azienda e i suoi utenti di sistema.
Graph API

Cos'è la Facebook Graph API?

La Graph API è l'API HTTP alla base di ogni integrazione Facebook. Tutte le richieste vanno a graph.facebook.com e quasi ogni endpoint richiede un access token. I dati sono organizzati come un grafo di nodi, edge e campi.

Nodi

Oggetti

Un singolo oggetto con un ID: un utente, una Pagina, un post, un commento, una foto. Esempio: GET /{page-id}.

Edge

Connessioni

Raccolte collegate a un nodo, come i post di una Pagina o i commenti di un post. Esempio: GET /{page-id}/feed.

Campi

Proprietà

I dati richiesti su un nodo, selezionati con il parametro fields. Esempio: ?fields=id,message,created_time.

Versioni e Graph API Explorer

Ogni richiesta può indicare una versione nel percorso, ad esempio /v27.0/, rilasciata il 4 novembre 2026. Meta pubblica diverse versioni l'anno e mantiene ciascuna per almeno due anni: conviene pianificare gli aggiornamenti, e il changelog indica fino a quando ogni versione resta disponibile. Il Graph API Explorer permette di testare le chiamate prima di scrivere codice, e la scheda Meta Graph API dell'esempio di codice più sotto mostra una prima richiesta: la lettura del feed di una Pagina.

Fonte: il changelog della Graph API di Meta, che indicava la v27.0 (introdotta il 4 novembre 2026) come ultima versione. Ultima verifica: 17 novembre 2026.

Panoramica

Le API Facebook in sintesi

Ogni API Facebook serve un tipo di account. Per scegliere quella giusta basta una domanda: si agisce per conto di una persona, di una Pagina o di un inserzionista?

APICosa faAccount servitoAccesso richiesto
Graph APILegge e scrive oggetti FacebookUtenti, Pagine, aziendeApp Meta, access token, autorizzazioni
Pages APIPubblica post, modera commenti, legge i dati della Pagina. Guida: API post FacebookPagine FacebookPage access token, task della Pagina, App Review
Messenger PlatformInvia e riceve le conversazioni della PaginaPagine Facebook e account professionali InstagramPage token, autorizzazione di messaggistica, App Review
Marketing APICrea inserzioni e ne misura il rendimentoAccount pubblicitariVerifica dell'azienda, autorizzazioni ads
Conversions APIInvia eventi web e offline per le inserzioniAziende che fanno pubblicitàPixel o dataset, token di utente di sistema
Facebook LoginFa accedere le persone alla vostra appUtenti FacebookApp Meta con Facebook Login
Graph API
Cosa faLegge e scrive oggetti Facebook
AccountUtenti, Pagine, aziende
AccessoApp Meta, access token, autorizzazioni
Pages API
Cosa faPubblica post, modera commenti, legge i dati della Pagina. Guida: API post Facebook
AccountPagine Facebook
AccessoPage access token, task della Pagina, App Review
Messenger Platform
Cosa faInvia e riceve le conversazioni della Pagina
AccountPagine Facebook e account professionali Instagram
AccessoPage token, autorizzazione di messaggistica, App Review
Marketing API
Cosa faCrea inserzioni e ne misura il rendimento
AccountAccount pubblicitari
AccessoVerifica dell'azienda, autorizzazioni ads
Conversions API
Cosa faInvia eventi web e offline per le inserzioni
AccountAziende che fanno pubblicità
AccessoPixel o dataset, token di utente di sistema
Facebook Login
Cosa faFa accedere le persone alla vostra app
AccountUtenti Facebook
AccessoApp Meta con Facebook Login

La messaggistica su Instagram passa dalla stessa Messenger Platform: si veda la nostra guida alla Messenger API per Instagram. WhatsApp ha una piattaforma propria, trattata nella guida all'API WhatsApp.

Scelta

Quale API Facebook serve?

Partite da ciò che fa il vostro prodotto, non dall'elenco delle API. Ogni situazione qui sotto rimanda a un'API e ai suoi requisiti di accesso.

Pubblicate sulla vostra Pagina

Pages API

Page access token di un amministratore della Pagina, task della Pagina, App Review. Guida all'API per le Pagine Facebook.

Rispondete a chi scrive alla vostra Pagina

Messenger Platform

Page token, pages_messaging, finestra di messaggistica di 24 ore.

Gestite o misurate inserzioni

Marketing API e Conversions API

Accesso all'account pubblicitario, verifica dell'azienda, utenti di sistema.

Permettete l'accesso con Facebook

Facebook Login

Un'app Meta con Facebook Login configurato.

I vostri utenti collegano i propri account nel vostro SaaS

API Unipile

Account personali e Pagine che gestiscono, tramite autenticazione ospitata (hosted auth).

Accesso

Come ottenere l'accesso all'API Facebook

Non esiste una chiave API a sé stante. Si crea un'app Meta, le persone le concedono access token tramite Facebook Login e Meta esamina le autorizzazioni richieste dall'app prima che possa servire il pubblico.

1

Creare un account sviluppatore Meta

Registrarsi su Meta for Developers con il proprio account Facebook.

2

Creare un'app Meta

Scegliere il tipo di app e il caso d'uso, poi annotare App ID e App Secret.

3

Aggiungere Facebook Login for Business

Utenti e amministratori di Pagina effettuano l'accesso e concedono le autorizzazioni all'app.

4

Richiedere le autorizzazioni

Ad esempio pages_show_list, pages_manage_posts o pages_messaging.

5

Superare l'App Review

L'Advanced Access è necessario prima che persone senza un ruolo nell'app possano usarla.

Access token: utente, Pagina, app e utente di sistema

TokenAgisce perUso tipico
User access tokenAgisce per una persona che ha effettuato l'accesso alla vostra appDi breve durata per impostazione predefinita, scambiabile con un token di lunga durata
Page access tokenAgisce per una Pagina, ottenuto da /me/accountsRichiesto dalla maggior parte degli endpoint della Pages API e di Messenger
App access tokenAgisce per l'app stessaImpostazioni dell'app e alcuni dati pubblici
System user tokenAgisce per un'azienda, senza una personaProcessi server to server, inserzioni e Pagine di proprietà dell'azienda
User access token
Agisce perAgisce per una persona che ha effettuato l'accesso alla vostra app
Uso tipicoDi breve durata per impostazione predefinita, scambiabile con un token di lunga durata
Page access token
Agisce perAgisce per una Pagina, ottenuto da /me/accounts
Uso tipicoRichiesto dalla maggior parte degli endpoint della Pages API e di Messenger
App access token
Agisce perAgisce per l'app stessa
Uso tipicoImpostazioni dell'app e alcuni dati pubblici
System user token
Agisce perAgisce per un'azienda, senza una persona
Uso tipicoProcessi server to server, inserzioni e Pagine di proprietà dell'azienda

La durata cambia a seconda del tipo. Secondo Meta, i token utente a breve durata restano validi in genere da una a due ore e quelli a lunga durata circa 60 giorni, mentre i token utente di sistema possono essere configurati per non scadere in base al tempo; Meta avverte che queste durate possono cambiare senza preavviso. La procedura completa, dalla generazione di un token al suo scambio e debug, è nella nostra guida al token di accesso API Facebook, mentre il Page access token di Facebook è trattato nella guida alla Page API.

Autorizzazioni, task della Pagina e App Review

La maggior parte degli endpoint della Pages API richiede un Page access token di una persona che può svolgere un task sulla Pagina, come CREATE_CONTENT o MODERATE. In modalità sviluppo, solo le persone con un ruolo nell'app possono usarla. Per servire altri utenti, ogni autorizzazione richiede l'Advanced Access, concesso dopo l'App Review, e le app aziendali spesso necessitano anche della verifica dell'azienda.

Fonti: la guida agli access token e la panoramica della Pages API di Meta. Ultima verifica: 17 novembre 2026.

Tempo reale

Webhook dell'API Facebook: ricevere gli eventi in tempo reale

Invece del polling, Meta invia gli eventi a un endpoint HTTPS di vostra proprietà: nuovi messaggi della Pagina, conferme di lettura e reazioni. La configurazione richiede quattro passaggi.

1

Verificare l'endpoint

Meta invia una richiesta GET con hub.mode, hub.verify_token e hub.challenge. Controllare il token e restituire il challenge.

2

Iscrivere la Pagina

Chiamare POST /{page-id}/subscribed_apps con un Page access token e i campi necessari, come messages.

3

Validare ogni payload

Ogni evento include un header X-Hub-Signature-256, una firma SHA256 generata con il vostro App Secret.

4

Rispondere in fretta

Restituire subito 200 OK. Per Messenger, Meta chiede una risposta entro 5 secondi e disattiva l'iscrizione dopo un'ora di errori.

Facebook Campi webhook di Messenger
messagesUna persona invia un messaggio alla Pagina
message_readsLa persona ha letto il vostro messaggio
message_deliveriesIl vostro messaggio è stato consegnato
message_reactionsLa persona ha reagito a un messaggio
messaging_postbacksLa persona ha toccato un pulsante o una voce di menu
POST /{page-id}/subscribed_apps success

Con Unipile si registra un unico URL di webhook e si ricevono messaggi nuovi, modificati ed eliminati, conferme di lettura e reazioni per ogni account Facebook collegato, nello stesso formato degli altri canali.

Fonti: la guida introduttiva ai webhook e i webhook di Messenger di Meta. Ultima verifica: novembre 2026.

Limiti

Cosa non permette l'API Facebook ufficiale

Diverse funzioni che ci si aspetta da un'API Facebook sono state rimosse o non sono mai state offerte alle app di terze parti. Conoscerle presto fa risparmiare settimane di progettazione.

  • Pubblicare su un profilo personale. L'autorizzazione publish_actions è stata deprecata il 24 aprile 2018 e le app l'hanno persa il 1° agosto 2018. Le app possono pubblicare sulle Pagine, non sul diario di una persona.
  • Usare i Gruppi Facebook. Meta ha deprecato la Groups API con la Graph API v19.0 il 23 gennaio 2024, inclusa l'autorizzazione publish_to_groups.
  • Inviare messaggi da un account personale. La Messenger Platform permette a una Pagina Facebook o a un account professionale Instagram di rispondere alle persone. La finestra di messaggistica standard è di 24 ore dall'ultimo messaggio della persona. Scoprite come funziona un'API Facebook Messenger per account personali.

Fonti: il changelog di Facebook Login, l'annuncio della Graph API v19.0 e la panoramica della Messenger Platform di Meta. Ultima verifica: novembre 2026.

Servono le conversazioni dei vostri utenti?

Se la vostra app ha bisogno di Messenger, post e commenti degli account che gli utenti collegano da soli, scoprite l'API Facebook Messenger di Unipile.

Rate limit

Rate limit e versioni dell'API Facebook

La Graph API conteggia le chiamate secondo due sistemi, a seconda del token utilizzato.

Rate limit della piattaforma 200 x utenti chiamate all'ora Chiamate effettuate con un token utente o app, conteggiate in base al numero di utenti dell'app.
Business Use Case, Pagine 4.800 x utenti coinvolti chiamate ogni 24 ore Chiamate agli endpoint delle Pagine con un token di Pagina o di utente di sistema.

Leggete gli header di utilizzo che Meta restituisce con ogni risposta, rallentate prima di raggiungere il limite e aggiornate la versione della Graph API prima che quella in uso venga ritirata.

Fonte: la guida ai rate limit di Meta. Ultima verifica: novembre 2026.

Errori

Errori comuni dell'API Facebook e come risolverli

Gli errori della Graph API restituiscono un code, spesso un error_subcode, e un fbtrace_id da comunicare al supporto Meta. Leggete il codice prima di riprovare: solo alcuni errori si risolvono con il tempo.

CodiceSignificatoCosa fare
190Access token scaduto o non valido (sottocodici 463, 467)Ottenere un nuovo token; chiedere all'utente di accedere di nuovo. Vedere la guida al token di accesso API Facebook
10, da 200 a 299Autorizzazione non concessa o revocataRichiedere di nuovo l'autorizzazione, verificare l'App Review
4, 17, 613Troppe chiamate per l'app o per l'utenteFare una pausa, poi riprovare con backoff
100Parametro o ID non validoControllare l'ID e il token inviati
368Blocco temporaneo per violazione delle regoleAttendere, poi rivedere ciò che è stato inviato
506Post duplicatoModificare il contenuto prima di ripubblicare
10 / 2018278Messaggio inviato fuori dalla finestra consentitaRispondere solo mentre la finestra di messaggistica è aperta
Codice 190
SignificatoAccess token scaduto o non valido (sottocodici 463, 467)
Cosa fareOttenere un nuovo token; chiedere all'utente di accedere di nuovo. Vedere la guida al token di accesso API Facebook
Codice 10, da 200 a 299
SignificatoAutorizzazione non concessa o revocata
Cosa fareRichiedere di nuovo l'autorizzazione, verificare l'App Review
Codice 4, 17, 613
SignificatoTroppe chiamate per l'app o per l'utente
Cosa fareFare una pausa, poi riprovare con backoff
Codice 100
SignificatoParametro o ID non valido
Cosa fareControllare l'ID e il token inviati
Codice 368
SignificatoBlocco temporaneo per violazione delle regole
Cosa fareAttendere, poi rivedere ciò che è stato inviato
Codice 506
SignificatoPost duplicato
Cosa fareModificare il contenuto prima di ripubblicare
Codice 10 / 2018278
SignificatoMessaggio inviato fuori dalla finestra consentita
Cosa fareRispondere solo mentre la finestra di messaggistica è aperta

Fonti: la gestione degli errori della Graph API e i codici di errore di Messenger di Meta. Ultima verifica: novembre 2026.

Prezzi

L'API Facebook è gratuita?

In gran parte sì. Meta non vende l'accesso alla Graph API. Ciò che costa sono la pubblicità, alcuni tipi di messaggi e il tempo di sviluppo per costruire e mantenere un'integrazione.

Accesso alla Graph APINessun costoMeta non fa pagare le chiamate alla Graph API. Il costo è la configurazione dell'app, l'App Review e la manutenzione.
Conversazioni MessengerUso gratuitoMeta descrive la Messenger Platform come gratuita; i messaggi di marketing vengono fatturati tramite l'account pubblicitario.
InserzioniLa spesa pubblicitariaChiamare la Marketing API è gratuito, ma le campagne che crea si pagano come qualsiasi altra inserzione.

I costi per tipo di messaggio, le novità di fatturazione del 2026 e il costo reale di gestire un'app Meta sono trattati nella nostra guida ai prezzi, che spiega in dettaglio se l'API Facebook è gratuita. Se i vostri utenti collegano i propri account tramite Unipile, pagate invece Unipile per account collegato: consultate i prezzi dell'API.

Documentazione

Dove trovare la documentazione dell'API Facebook

Tutta la documentazione ufficiale si trova su Meta for Developers. Meta sta spostando le sue pagine su developers.facebook.com/documentation/ e diversi vecchi link /docs/ ora vi reindirizzano. Queste sei pagine rispondono alla maggior parte delle domande sull'integrazione; per Instagram, WhatsApp, Threads, inserzioni e IA, consultate la nostra guida all'API Meta.

Con Unipile

Un altro modello: collegare gli account Facebook dei propri utenti

CRM, helpdesk, agenti IA e inbox multicanale hanno bisogno delle conversazioni e dei post dei propri utenti. Con Unipile, ogni utente collega il proprio account Facebook tramite una pagina di autenticazione ospitata e la vostra app chiama un'unica REST API per suo conto, senza app Meta né App Review da parte vostra.

La tua app Sincronizzato
Account collegati
FacebookAnna LeeAccount personale
FacebookNorthwind BakeryPagina
Collega account
Inbox 2PaginaPersonale
Leo MartinIl negozio è aperto oggi?Pagina
Sara KimFoto inviataPersonale
Club del libroTom: Ci vediamo alle 7Gruppo
Omar HaddadVistoPagina
Pubblicato come Pagina
Northwind BakeryAdesso

Il nostro menu autunnale parte lunedì.

24 reazioni2 commenti
Julia NashIl pane alla zucca è tornato!
Ben TorresAccettate preordini?
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
AmbitoCosa copre l'API Unipile per Facebook
ConnessioneHosted Auth o Custom Auth, con le credenziali dell'utente e l'autenticazione a due fattori, i cookie del browser o l'estensione UniLogin
MessaggisticaElenco di chat e messaggi, avvio di una chat, invio di messaggi e allegati, modifica, eliminazione, inoltro, reazioni, conferme di lettura, chat di gruppo
Post e commentiLettura, creazione, modifica ed eliminazione dei post; elenco, aggiunta, risposta, modifica ed eliminazione dei commenti; reazioni a post e commenti
Utenti e relazioniProfili, follower e account seguiti, richieste di amicizia (invio, accettazione, rifiuto, annullamento)
WebhookMessaggi nuovi, aggiornati ed eliminati, conferme di lettura e di consegna, nuove reazioni, aggiornamenti delle chat
Pagine FacebookLettura e risposta ai messaggi di una Pagina gestita dall'utente e pubblicazione di post come Pagina. Una Pagina non può avviare una conversazione né eliminare i propri messaggi
Non supportatoStorie, messaggi fissati, blocco degli utenti
Connessione
Hosted Auth o Custom Auth, con le credenziali dell'utente e l'autenticazione a due fattori, i cookie del browser o l'estensione UniLogin
Messaggistica
Elenco di chat e messaggi, avvio di una chat, invio di messaggi e allegati, modifica, eliminazione, inoltro, reazioni, conferme di lettura, chat di gruppo
Post e commenti
Lettura, creazione, modifica ed eliminazione dei post; elenco, aggiunta, risposta, modifica ed eliminazione dei commenti; reazioni a post e commenti
Utenti e relazioni
Profili, follower e account seguiti, richieste di amicizia (invio, accettazione, rifiuto, annullamento)
Webhook
Messaggi nuovi, aggiornati ed eliminati, conferme di lettura e di consegna, nuove reazioni, aggiornamenti delle chat
Pagine Facebook
Lettura e risposta ai messaggi di una Pagina gestita dall'utente e pubblicazione di post come Pagina. Una Pagina non può avviare una conversazione né eliminare i propri messaggi
Non supportato
Storie, messaggi fissati, blocco degli utenti

Gli utenti possono collegare un account Facebook personale e le Pagine che gestiscono diventano disponibili tramite gli stessi endpoint. La stessa API copre anche LinkedIn, WhatsApp, Instagram, Telegram, email e calendari. Elenco completo nella tabella delle funzionalità per provider.

Elencare le chat e inviare un messaggio

Una volta che l'utente ha collegato il proprio account, si ottiene un account_id. Ogni chiamata usa la vostra chiave API Unipile nell'header X-API-KEY. La seconda scheda mostra, per confronto, una prima chiamata alla Graph API di Meta: la lettura degli ultimi post di una Pagina con un Page access token.

# 1. List the Facebook chats of a connected account
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. Reply in one of those chats
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": "Thanks for your message, your order ships today." }'
# Read the 3 latest posts of a Page (Graph API v27.0)
# Needs a Page access token with pages_read_engagement and pages_read_user_content
curl "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?fields=id,message,created_time&limit=3&access_token={PAGE_ACCESS_TOKEN}"

# Response (abridged)
{ "data": [ {
    "id": "{PAGE_ID}_{POST_ID}",
    "message": "Our autumn menu starts Monday.",
    "created_time": "2026-11-16T09:30:00+0000"
  } ],
  "paging": {
    "cursors": { "before": "{CURSOR}", "after": "{CURSOR}" },
    "next": "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?..."
  } }
200 OK · messaggio inviato dall'account dell'utente
200 OK · post di una Pagina, un token di Pagina per ogni Pagina

Configurazione passo passo nel quickstart Facebook. Richiesta Graph API verificata sul riferimento del feed di Pagina di Meta il 17 novembre 2026.

Conformità

Ogni utente collega il proprio account

Unipile è un'azienda indipendente, non un'app ufficiale Meta né un Meta Partner. Agisce per conto di utenti autenticati, e i vostri utenti restano vincolati ai termini di Meta. Usatela per scenari legittimi come assistenza clienti, CRM e conversazioni dirette.

Riferimento API

Endpoint dell'API Facebook con Unipile

In breve

Unipile espone Facebook tramite un'unica API REST. I suoi endpoint V2 coprono conversazioni e messaggi Messenger, post, commenti, reazioni, profili, richieste di amicizia, Pagine Facebook e webhook. Ogni chiamata punta a un account collegato tramite il suo account_id: una sola integrazione serve così un account personale e le Pagine che gestisce, senza alcuna app Meta da parte vostra.

AzioneMetodo e percorsoPersonale / PaginaGuida
Messaggistica
Elencare le conversazioniGET/v2/{account_id}/chatsPersonaleMessenger per account personali
Elencare i messaggi di una conversazioneGET/v2/{account_id}/chats/{chat_id}/messagesPersonale + Pagina
Scaricare un allegatoGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Personale + Pagina
Avviare una nuova conversazionePOST/v2/{account_id}/chats/sendPersonaleCome inviare un messaggio Messenger
Inviare un messaggio, testo o allegatiPOST/v2/{account_id}/chats/{chat_id}/messages/sendPersonale + Pagina
Elencare, aggiungere o rimuovere le reazioni a un messaggioGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsPersonale
Segnare un messaggio come lettoPOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readPersonale
Post
Elencare i post di un utente o di una PaginaGET/v2/{account_id}/users/{user_id}/postsPersonale + PaginaGuida alla Facebook Post API
Recuperare un postGET/v2/{account_id}/posts/{post_id}Personale + Pagina
Creare un postPOST/v2/{account_id}/postsPersonale + Pagina
Modificare o eliminare un postPATCHDELETE/v2/{account_id}/posts/{post_id}Personale + Pagina
Commenti
Elencare i commenti di un postGET/v2/{account_id}/posts/{post_id}/commentsPersonaleLeggere e rispondere ai commenti
Elencare le risposte a un commentoGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesPersonale
Aggiungere un commentoPOST/v2/{account_id}/posts/{post_id}/commentsPersonale
Rispondere a un commentoPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Personale
Modificare o eliminare un commentoPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Personale
Reazioni
Elencare, aggiungere o rimuovere le reazioni a un postGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsPersonaleLe reazioni nella guida ai commenti
Elencare, aggiungere o rimuovere le reazioni a un commentoGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsPersonale
Profili e relazioni
Recuperare un profiloGET/v2/{account_id}/users/{user_id}PersonaleSincronizzare i contatti nel CRM
Elencare gli amiciGET/v2/{account_id}/users/me/relationsPersonale
Elencare follower o account seguitiGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingPersonale
Inviare o elencare le richieste di amiciziaPOSTGET/v2/{account_id}/users/me/relation-requestsPersonale
Accettare, rifiutare o annullare una richiestaPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelPersonale
Pagine Facebook
Trovare le Pagine dell'accountGET/v2/{account_id}/inboxesPaginaGuida pratica alla Facebook Page API
Elencare le conversazioni di una PaginaGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsPagina
Rispondere come PaginaPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendPagina
Pubblicare un post come PaginaPOST/v2/{account_id}/posts con post_asPagina
Webhook
Registrare un endpoint webhookPOST/v2/webhooks/endpointsPersonale + PaginaSincronizzazione CRM in tempo reale con i webhook
Eventi dei messaggimessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newPersonale + Pagina
Eventi delle conversazionichat.update, chat.deletePersonale
Messaggistica
Elencare le conversazioniGET/v2/{account_id}/chatsPersonale
Elencare i messaggi di una conversazioneGET/v2/{account_id}/chats/{chat_id}/messagesPersonale + Pagina
Scaricare un allegatoGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Personale + Pagina
Avviare una nuova conversazionePOST/v2/{account_id}/chats/sendPersonale
Inviare un messaggio, testo o allegatiPOST/v2/{account_id}/chats/{chat_id}/messages/sendPersonale + Pagina
Elencare, aggiungere o rimuovere le reazioni a un messaggioGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsPersonale
Segnare un messaggio come lettoPOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readPersonale
Post
Elencare i post di un utente o di una PaginaGET/v2/{account_id}/users/{user_id}/postsPersonale + Pagina
Recuperare un postGET/v2/{account_id}/posts/{post_id}Personale + Pagina
Creare un postPOST/v2/{account_id}/postsPersonale + Pagina
Modificare o eliminare un postPATCHDELETE/v2/{account_id}/posts/{post_id}Personale + Pagina
Commenti
Elencare i commenti di un postGET/v2/{account_id}/posts/{post_id}/commentsPersonale
Elencare le risposte a un commentoGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesPersonale
Aggiungere un commentoPOST/v2/{account_id}/posts/{post_id}/commentsPersonale
Rispondere a un commentoPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Personale
Modificare o eliminare un commentoPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Personale
Reazioni
Elencare, aggiungere o rimuovere le reazioni a un postGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsPersonale
Elencare, aggiungere o rimuovere le reazioni a un commentoGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsPersonale
Profili e relazioni
Recuperare un profiloGET/v2/{account_id}/users/{user_id}Personale
Elencare gli amiciGET/v2/{account_id}/users/me/relationsPersonale
Elencare follower o account seguitiGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingPersonale
Inviare o elencare le richieste di amiciziaPOSTGET/v2/{account_id}/users/me/relation-requestsPersonale
Accettare, rifiutare o annullare una richiestaPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelPersonale
Pagine Facebook
Trovare le Pagine dell'accountGET/v2/{account_id}/inboxesPagina
Elencare le conversazioni di una PaginaGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsPagina
Rispondere come PaginaPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendPagina
Pubblicare un post come PaginaPOST/v2/{account_id}/posts con post_asPagina
Webhook
Registrare un endpoint webhookPOST/v2/webhooks/endpointsPersonale + Pagina
Eventi dei messaggimessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newPersonale + Pagina
Eventi delle conversazionichat.update, chat.deletePersonale

Autenticazione. Ogni richiesta porta la vostra chiave API Unipile nell'header X-API-KEY. I vostri utenti collegano il proprio account Facebook tramite Hosted Auth: non dovete mai creare un'app Meta, superare l'App Review né conservare un token di Pagina. Confrontate questo approccio con un access token dell'API Facebook e consultate il dettaglio dei prezzi dell'API Messenger per i costi.

Endpoint tratti dalla documentazione Facebook V2 di Unipile e dalla sua tabella delle funzionalità per provider. Ultima verifica: 17 novembre 2026.

Casi d'uso

L'API Facebook per caso d'uso

La maggior parte delle integrazioni Facebook rientra in una di queste famiglie. Ecco come si presenta ciascuna all'interno di un prodotto.

Il tuo CRM
ContattiTrattative
ContattoFase
Julia ChenLa demo è confermata?QualificatoFacebook
Lucas MeyerMi mandi il preventivoPropostaFacebook
Sofia RiveraFirmato, grazie!VintoFacebook
Daniel MoreauSentiamoci lunedìNuovoFacebook

Integrazione CRM di Facebook Messenger

Sincronizzare le conversazioni con le schede dei contatti, così i team vendite e supporto rispondono dal CRM. Scopri l'integrazione CRM di Facebook Messenger.

Ogni conversazione salvata sul contatto giusto, senza copia e incolla.

Il tuo helpdesk
TicketClienti
RichiestaStato
Mia OwensDov'è il mio ordine? #4521ApertoFacebook
Elena GarciaRimborso ricevuto #4498RisoltoFacebook
Gabriel LopezFoto allegata #4530In attesaFacebook
Anna RossiNon riesco ad accedere #4476ApertoFacebook

Chat Facebook e Messenger

Rispondere a chi scrive a una Pagina tramite la Messenger Platform, o ai contatti di un account collegato. Scoprite come inviare un messaggio.

Le richieste da Facebook gestite nel solito strumento di assistenza.

Il tuo strumento social
Pubblica comeFacebookNorthwind BakeryFacebookAnna Lee
Pane a lievito madre fresco ogni mattina dalle 7.
Pubblica
Il nostro menu autunnale parte lunedìPagina · OggiPubblicato
Grazie per 10 anni fantastici!Pagina · 2 ottModificato

API per i post Facebook

Creare, modificare e leggere post. L'API ufficiale pubblica solo sulle Pagine, mentre un account collegato può pubblicare come il suo utente. Leggete la guida all'API per i post Facebook.

Post scritti, pubblicati e modificati dal vostro prodotto.

Il tuo strumento community
Commenti al post di Anna Lee Il nostro menu autunnale parte lunedì
CommentoArgomento
Ben TorresAccettate preordini?DomandaFacebook
Julia NashIl pane alla zucca è tornato!FeedbackFacebook
Kai OkaforÈ senza glutine?DomandaFacebook
Priya RaoPossiamo prenotare per 20 persone?VenditeFacebook

API per i commenti Facebook

Elencare i commenti a un post, poi rispondere, modificarli o eliminarli dall'account collegato dall'utente stesso. I commenti partono sempre da quell'account, mai da una Pagina: per commentare come Pagina si passa dalla Pages API di Meta. Leggi la guida all'API dei commenti Facebook.

Le domande sotto un post individuate e inoltrate al team giusto.

API per le Pagine Facebook

Pubblicare e moderare i contenuti di una Pagina Facebook, con un Page access token e i task della Pagina adeguati. Leggete la guida all'API per le Pagine Facebook.

Prezzi dell'API Facebook Messenger

Meta descrive la Messenger Platform come gratuita, mentre i messaggi di marketing vengono fatturati tramite le inserzioni. Il vero costo è il tempo di integrazione e di revisione. Consultate l'analisi completa.

Costruite un'unica inbox per più reti? Scoprite come funziona un'API di messaggistica unificata e leggete la nostra guida all'API Instagram per l'altra rete di Meta.

Scegliete l'API giusta per il vostro prodotto

La Graph API di Meta è lo strumento giusto quando la vostra app gestisce le proprie Pagine o inserzioni. Quando il prodotto ha bisogno delle conversazioni e dei post dell'account di ogni utente, collegateli tramite Unipile e usate un'unica API per Facebook e gli altri canali.

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

Ogni utente collega il proprio account, senza archiviazione dei profili. Unipile non è un Meta Partner. Il nostro approccio al Digital Markets Act

FAQ sull'API Facebook

Risposte rapide su chiavi, versioni, livelli di accesso, partnership con Meta, conformità e Gruppi.

Gli sviluppatori la usano per gestire le Pagine Facebook (post, commenti, insight), rispondere alle conversazioni delle Pagine tramite la Messenger Platform, gestire e misurare le inserzioni e far accedere le persone con Facebook Login. Ogni uso si basa su un prodotto della Graph API con autorizzazioni proprie.

Non esiste un'unica chiave. Si crea un'app Meta su Meta for Developers per ottenere App ID e App Secret, poi si ottengono gli access token: token utente tramite Facebook Login, token di Pagina da /me/accounts. Le autorizzazioni usate dal pubblico richiedono l'Advanced Access dopo l'App Review.

La Graph API è l'API HTTP di base per gli oggetti Facebook come utenti, Pagine, post e commenti. La Marketing API è un insieme di endpoint della Graph API per account pubblicitari, campagne, pubblici e report, con autorizzazioni e requisiti aziendali propri.

Non con l'API ufficiale di Meta: le app hanno perso l'autorizzazione publish_actions il 1° agosto 2018 e possono pubblicare solo sulle Pagine. Con Unipile, un utente che collega il proprio account Facebook può creare post da quell'account tramite gli endpoint Posts, nel rispetto dei termini di Meta.

No. Meta ha deprecato la Groups API con la Graph API v19.0 nel gennaio 2024, inclusa l'autorizzazione publish_to_groups. Nemmeno Unipile copre i Gruppi Facebook.

A novembre 2026, il changelog di Meta indicava la v27.0 come ultima versione della Graph API. Meta pubblica diverse versioni l'anno e mantiene ciascuna disponibile per almeno due anni: controllate il changelog della Graph API prima di fissarne una.

No. Unipile è un'azienda indipendente che lavora accanto alla Graph API di Meta, non per Meta. Non è un Meta Partner né un'app ufficiale di Meta, e non è sostenuta, sponsorizzata né approvata da Meta. Facebook e Messenger sono marchi di Meta Platforms, Inc.

No. I passaggi di app Meta, Facebook Login e App Review descritti in questa guida riguardano l'API ufficiale di Meta. Con Unipile, ogni utente collega il proprio account Facebook, e le Pagine che gestisce, tramite una pagina di autenticazione ospitata, quindi da parte vostra questi passaggi non servono.

È progettata nello spirito del Digital Markets Act: invece di un'unica app che legge molti account, ogni utente collega il proprio account e Unipile agisce per suo conto, senza memorizzare i profili utente. Dettagli nella nostra pagina sul Digital Markets Act.

Sì. Che chiamiate la Graph API o Unipile, gli account Facebook restano soggetti alle Condizioni d'uso di Meta. Limitatevi a usi legittimi come assistenza clienti, CRM e conversazioni che le persone si aspettano; spam e automazioni non autorizzate possono portare alla limitazione di un account.

La vostra app è ancora limitata alle persone che hanno un ruolo su di essa. Con lo Standard Access, le autorizzazioni possono essere richieste solo ad amministratori, sviluppatori e tester dell'app. Per servire le Pagine di altre persone, ogni autorizzazione richiede l'Advanced Access, approvato tramite App Review, e Meta richiede per questo la Business Verification.

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

Parla con un esperto