
Guide all'integrazione
Guida all'API di LinkedIn
Guida all'API email
Guida all'API di WhatsApp
Contatta le vendite
Cercate un'API Facebook Messenger per un account personale? La Messenger Platform di Meta serve solo le Pagine Facebook. Ecco perché, e come i vostri utenti possono collegare il proprio account alla vostra app.
api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
L'API ufficiale di Facebook Messenger non supporta gli account personali. La Messenger Platform di Meta permette a una Pagina Facebook o a un account professionale Instagram di rispondere alle persone, mai a un profilo personale. Per lavorare con un account Facebook personale, il titolare lo collega alla vostra app tramite un'API di terze parti come Unipile.
I progetti open source che pilotano messenger.com da un browser non sono ufficiali, per lo più non vengono mantenuti e smettono di funzionare a ogni modifica dell'interfaccia. Un account collegato passa invece da un'API mantenuta, con webhook.
Per il quadro completo delle API di Meta, vedete come si combinano le API di Facebook.
Messaggi da un account Facebook personale in tre passaggi
Collegate. L'utente collega il proprio account Facebook tramite Hosted Auth. Nessuna app Meta, nessuna App Review.
Inviate. Chiamate l'API V2 con il vostro header X-API-KEY:POST/v2/
Ricevete. I messaggi in arrivo raggiungono il vostro webhook come eventi message.new.
Dettagli nel flusso di connessione e negli esempi di codice qui sotto, o nel quickstart Facebook.
Iniziate la prova gratuita di 7 giorniQuella ufficiale no. Meta ha creato la Messenger Platform per le aziende: permette a una Pagina Facebook o a un account professionale Instagram di rispondere alle persone che le scrivono. Un account Facebook personale può arrivare alla vostra app solo se il titolare lo collega, tramite un'API di terze parti che agisce per suo conto.
Fonte: la panoramica della Messenger Platform di Meta. Ultima verifica: novembre 2026.
La Messenger Platform è costruita attorno a una Pagina, non a una persona. Ogni chiamata agisce per conto di una Pagina Facebook, con un Page access token e il permesso pages_messaging: non esiste quindi alcun token che rappresenti una inbox personale.
Registrate un'app su Meta for Developers con il caso d'uso Messenger.
Un amministratore della Pagina concede permessi come pages_messaging.
La vostra app chiama la Send API solo per conto di quella Pagina.
La Pagina riceve i messaggi e risponde entro la finestra di messaggistica standard.
I permessi si richiedono tramite Facebook Login for Business, e business_management è una dipendenza di pages_messaging. L'App Review non è necessaria se inviate e ricevete messaggi solo per la vostra Pagina; serve invece per gestire le Pagine di altre aziende. La maggior parte delle risposte va inviata entro 24 ore dall'ultimo messaggio della persona; il tag HUMAN_AGENT estende le risposte manuali a 7 giorni, dopo l'App Review. Nessuno di questi passaggi della Graph API può puntare a un profilo personale: per questo gli strumenti basati sull'API ufficiale collegano solo Pagine. Quanto costa questa configurazione è spiegato nella nostra guida ai prezzi dell'API Facebook Messenger.
Fonti: la panoramica della Messenger Platform e il riferimento della Send API di Meta. Ultima verifica: novembre 2026.
Meta ha chiuso la vecchia Facebook Chat API (XMPP, chat.facebook.com) nel 2015, con la fine della Graph API v1.0 e del permesso xmpp_login. Non esiste un'API ufficiale per la casella di un account Facebook personale: la Messenger Platform che l'ha sostituita per la messaggistica aziendale agisce solo per le Pagine. Le librerie non ufficiali pubblicate su npm da allora accedono a messenger.com con la sessione dell'utente stesso. Non sono supportate da Meta, e il progetto open source originale si dichiara in modalità di manutenzione.
Per scrivere da una Pagina che gestite, usate la Messenger Platform e inviate un messaggio Messenger tramite API. Per l'account dell'utente stesso, usate un'API mantenuta: l'utente si collega tramite Hosted Auth, quindi la vostra app non gestisce mai la sua password, e ottenete un account_id, i webhook e un team di supporto (vedi come si collega un account personale). I termini di Meta restano validi per quell'account.
È il titolare a collegarlo. La vostra app apre una pagina Hosted Auth di Unipile (o una vostra schermata con Custom Auth), l'utente accede a Facebook e convalida l'autenticazione a due fattori, e la vostra app riceve un account_id con cui chiamare l'API.
L'utente clicca su "Collega Facebook" e arriva su Hosted Auth.
Nome utente, email o telefono con password, cookie del browser o estensione UniLogin, poi 2FA via SMS, app di autenticazione, WhatsApp, approvazione in app o codice monouso.
L'account collegato compare nella vostra dashboard e ogni chiamata usa il suo account_id.
In questo flusso non c'è alcuna schermata OAuth di Meta né alcun codice QR, e non dovete creare un'app Meta né affrontare l'App Review. I metodi per ciascun provider sono elencati nella tabella delle funzionalità per provider, e la panoramica del prodotto si trova nella pagina API Facebook Messenger.
Ogni utente collega il proprio account
Unipile non è un prodotto Meta. Non è un Meta Partner e non è approvata da Meta. Ogni utente collega il proprio account, Unipile agisce per conto di quell'utente autenticato e l'utente resta vincolato ai termini di Meta.
In pratica, un'integrazione dell'API Facebook Messenger con un account personale espone la inbox Messenger dell'utente tramite l'API Unipile: chat, messaggi, allegati, reazioni e conferme, più webhook in tempo reale, messi a confronto qui sotto con il modello ufficiale basato sulle Pagine.
| Aspetto | Pagina tramite Messenger Platform | Account personale tramite Unipile |
|---|---|---|
| Account | Una Pagina Facebook o un account professionale Instagram | L'account Facebook personale dell'utente |
| Chi collega | Un amministratore della Pagina, tramite Facebook Login for Business | Il titolare dell'account, tramite Hosted Auth o Custom Auth |
| Cosa conserva la vostra app | Un Page access token | La vostra chiave API Unipile e l'account_id dell'utente |
| App Meta e App Review | Un'app Meta, più l'App Review per servire Pagine che non sono vostre | Nessuna app Meta e nessuna App Review da parte vostra |
| Chi scrive per primo | La persona scrive alla Pagina | L'utente può rispondere o avviare una nuova conversazione |
| Eventi in tempo reale | Webhook Messenger sulla vostra app Meta | Messaggi nuovi, modificati ed eliminati, conferme di lettura e di consegna, reazioni, aggiornamenti delle chat |
account_id dell'utenteLo stesso account collegato espone anche i suoi post, commenti e reazioni. Questi endpoint sono riassunti nella guida all'API Facebook.
Due chiamate coprono il ciclo di base: elencare le chat dell'account collegato, poi inviare un messaggio in una di esse. Le richieste vanno a https://api.unipile.com con la vostra chiave API nell'header X-API-KEY.
# 1. List the chats of the connected personal account
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
--header "X-API-KEY: {YOUR_API_KEY}"
# 2. Send a message 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": "Thursday 10am works for me." }'
const base = "https://api.unipile.com/v2/{ACCOUNT_ID}";
const headers = { "X-API-KEY": process.env.UNIPILE_API_KEY };
// 1. List the chats of the connected personal account
const chats = await (await fetch(`${base}/chats`, { headers })).json();
// 2. Send a message in one of those chats
await fetch(`${base}/chats/{CHAT_ID}/messages/send`, {
method: "POST",
headers: { ...headers, "content-type": "application/json" },
body: JSON.stringify({ text: "Thursday 10am works for me." }),
});
import os, requests
base = "https://api.unipile.com/v2/{ACCOUNT_ID}"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}
# 1. List the chats of the connected personal account
chats = requests.get(f"{base}/chats", headers=headers).json()
# 2. Send a message in one of those chats
requests.post(
f"{base}/chats/{{CHAT_ID}}/messages/send",
headers=headers,
json={"text": "Thursday 10am works for me."},
)
I messaggi in arrivo raggiungono il vostro webhook come eventi message.new, quindi non serve il polling. L'SDK Node.js incapsula le stesse chiamate come getChatsList e sendMessage. Configurazione completa nel quickstart Facebook. Altri linguaggi, allegati e risposte da una Pagina in inviare un messaggio con l'API Facebook Messenger.
Un account personale collegato è adatto ai prodotti in cui un professionista parla con i propri contatti dal proprio account: CRM, helpdesk, assistenti IA che preparano risposte approvate dall'utente e strumenti per consulenti. Non è pensato per il cold outreach né per bot completamente automatizzati.
Un commerciale ritrova le proprie conversazioni Messenger nella scheda del contatto giusto, accanto a email e chiamate. Scopri l'integrazione CRM.
Messenger si trova nella stessa inbox di LinkedIn, WhatsApp, Instagram e Telegram, con un unico modello di dati.
Un agente prepara una risposta a partire dallo storico della conversazione e l'utente la rivede prima dell'invio.
Un consulente o un agente tiene traccia dei clienti con cui parla già su Messenger.
Un account collegato resta vincolato ai Termini di servizio di Meta. Progettate per conversazioni che l'utente avrebbe comunque: i messaggi non richiesti e l'automazione non autorizzata possono portare Meta a limitare l'account.
State costruendo un'unica inbox per più reti? Scoprite come funziona un'API di messaggistica unificata.
Un'integrazione dell'API Facebook con un account personale tramite la Graph API di Meta è limitata. Può identificare la persona e leggere alcuni campi del profilo, ma non può aprire la sua casella Messenger né pubblicare per suo conto.
L'identità funziona ancora. Con Facebook Login, la persona concede alla vostra app un user access token. Il permesso public_profile legge i campi pubblici predefiniti del profilo e email legge il suo indirizzo email principale. Gli altri permessi utente, come user_posts per i post pubblicati dall'utente sul proprio diario, sono limitati da Meta a un breve elenco di usi approvati. Nessun permesso utente dà accesso alle conversazioni Messenger della persona. Il modo in cui vengono emessi questi token è spiegato nella nostra guida al token di accesso API Facebook.
La pubblicazione su un profilo è finita nel 2018. Meta ha rimosso il permesso publish_actions il 24 aprile 2018, e le app già approvate hanno potuto continuare a usarlo fino al 1° agosto 2018. Da allora, le app basate sulla Graph API pubblicano solo sulle Pagine, ed è per questo che gli strumenti di programmazione dei post hanno smesso di supportare i profili personali.
Un account collegato copre entrambi i lati. Quando il titolare collega il proprio account personale tramite Unipile, la vostra app legge e invia i suoi messaggi Messenger, e crea, modifica ed elimina i suoi post, commenti e reazioni. La parte di pubblicazione è descritta nella nostra guida all'API post Facebook.
| Azione | Graph API con un user access token | Account personale collegato tramite Unipile |
|---|---|---|
| Leggere i messaggi Messenger dell'utente | No, nessun permesso utente copre la casella | Sì, chat, messaggi e allegati |
| Pubblicare sul profilo dell'utente | No, publish_actions è stato rimosso nel 2018 | Sì, creare, modificare ed eliminare post |
| Rispondere ai messaggi | No, la Messenger Platform serve le Pagine | Sì, rispondere o avviare una conversazione |
publish_actions è stato rimosso nel 2018Fonti: il riferimento dei permessi e il changelog della Graph API del 24 aprile 2018 di Meta. Ultima verifica: 17 novembre 2026.
Collegate gli account Facebook personali al vostro prodotto
La Messenger Platform di Meta resta lo strumento giusto per un'azienda che risponde alle persone sulla propria Pagina. Quando il vostro prodotto ha bisogno di un'API Facebook Messenger che includa l'account personale, lasciate che i vostri utenti colleghino il proprio account Facebook e usate un'unica API per Facebook e gli altri canali.
Ogni utente collega il proprio account, senza archiviazione dei profili. Unipile non è un Meta Partner. Leggete la nostra pagina sul Digital Markets Act
Tutti gli endpoint dell'API Facebook in un unico posto
I messaggi sono solo una parte del quadro. Sfogliate tutti gli endpoint Facebook disponibili con Unipile, dalle chat ai post, oppure leggete la guida completa all'API Facebook per confrontare le API ufficiali di Meta con gli account collegati.
Risposte rapide su profili, storico dei messaggi, primo messaggio, reazioni, Pagine, chatbot, Graph API e librerie non ufficiali.
La Messenger Platform di Meta no: serve le Pagine Facebook e gli account professionali Instagram. Un profilo personale si può usare quando il titolare lo collega alla vostra app tramite l'autenticazione ospitata di Unipile, e il titolare resta vincolato ai termini di Meta.
Sì, una volta collegato l'account. L'API elenca le chat e i messaggi dell'account personale collegato, comprese le conversazioni di gruppo e gli allegati, e i webhook inviano alla vostra app i messaggi nuovi, modificati ed eliminati.
Sì. Un account personale collegato può avviare una nuova conversazione oltre a rispondere. Limitatevi alle persone che l'utente conosce o con cui lavora: i messaggi non richiesti violano i termini di Meta e possono far limitare l'account.
Sì. Potete elencare, aggiungere e rimuovere reazioni sui messaggi, e le nuove reazioni arrivano alla vostra app tramite l'evento webhook message.reaction.new.
Sì, per le Pagine gestite dall'utente collegato. La vostra app può leggere e rispondere ai messaggi della Pagina e pubblicare come Pagina. Una Pagina non può avviare una conversazione né eliminare i propri messaggi, quindi le conversazioni di una Pagina iniziano sempre con la persona che scrive per prima.
La Messenger Platform di Meta, e i costruttori di chatbot che si basano su di essa, funzionano solo con le Pagine. Con un account personale collegato, mantenete una persona nel processo: un'IA prepara una risposta e l'utente la approva. Messaggi completamente automatizzati o non richiesti possono far limitare l'account.
In parte. La Graph API di Meta accetta ancora un profilo personale per Facebook Login e per alcuni permessi di lettura, ma non può aprire la casella Messenger della persona e non pubblica più sui profili da quando publish_actions è stato rimosso nel 2018. Per un'integrazione dell'API Facebook con un account personale che copra messaggi e post, il titolare collega l'account tramite Unipile e la vostra app lavora con un'unica API REST.
Sì. Esistono librerie open source che accedono a messenger.com con la sessione dell'utente stesso, ma non sono ufficiali e non sono supportate da Meta. Possono smettere di funzionare quando Facebook cambia la sua interfaccia, e l'account che le usa può essere limitato in base ai termini di Meta. Per un'app in produzione, usate la Messenger Platform per le Pagine che gestite, oppure un'API mantenuta in cui l'utente collega il proprio account e resta vincolato ai termini di Meta.
Non tramite le loro integrazioni Facebook Messenger: queste si basano sulla Messenger Platform di Meta, che serve solo le Pagine. Con un account personale collegato tramite Unipile, il messaggio parte dal vostro workflow, ad esempio da uno step HTTP che chiama l'endpoint di invio messaggi per quell'account.
No. Unipile è un'azienda indipendente: non è un Meta Partner e non è sostenuta, sponsorizzata né approvata da Meta. Collegare un account Messenger personale tramite Unipile non è un'integrazione ufficiale della Messenger Platform. Facebook e Messenger sono marchi di Meta Platforms, Inc.
No. Il titolare dell'account accede tramite l'autenticazione ospitata di Unipile, quindi da parte vostra non dovete registrare un'app Meta, richiedere pages_messaging né passare l'App Review. Lo stesso vale per le Pagine gestite da quell'utente.
Unipile è progettata nello spirito del Digital Markets Act. Ogni persona collega il proprio account Facebook, i messaggi vengono letti e inviati per suo conto e Unipile non memorizza i profili utente. Dettagli nella nostra pagina sul Digital Markets Act.
Sì. Un account personale collegato resta un account Facebook soggetto ai Termini di Meta. Limitatevi a usi legittimi come rispondere ai clienti, sincronizzare le conversazioni in un CRM o aiutare un utente a gestire la propria casella; i messaggi in massa o non richiesti possono portare alla limitazione dell'account.
Avete ancora domande? Il nostro team è qui per aiutarvi.
Parla con un esperto