IT
Account personali

API Facebook Messenger e account personale: cosa consente Meta e come collegarne uno

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.

Il tuo CRM Collegato
Tom ReyesFacebookAnna Lee, account personale
Ciao Anna, possiamo spostare la call a giovedì?09:12
Webhook: message.new
Certo, giovedì alle 10 va bene. Ti mando l'invito.09:14 · Visualizzato
POST api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Risposta breve

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.

Con Unipile

Messaggi da un account Facebook personale in tre passaggi

  1. 1

    Collegate. L'utente collega il proprio account Facebook tramite Hosted Auth. Nessuna app Meta, nessuna App Review.

  2. 2

    Inviate. Chiamate l'API V2 con il vostro header X-API-KEY:POST/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send

  3. 3

    Ricevete. I messaggi in arrivo raggiungono il vostro webhook come eventi message.new.

La risposta

L'API Facebook Messenger funziona con un account personale?

Quella 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.

Messenger Platform di Meta
Facebook

Pagina Facebook

  • La vostra app Meta agisce per una Pagina con un Page access token.
  • La Pagina risponde alle persone che le scrivono per prime.
  • Finestra di messaggistica standard di 24 ore dall'ultimo messaggio della persona.
  • App Review prima di servire Pagine che non sono vostre.
Account collegato con Unipile
Facebook

Account Facebook personale

  • Ogni utente collega il proprio account tramite autenticazione ospitata.
  • La vostra app legge e invia messaggi da quell'account.
  • Un'unica REST API e un unico formato di webhook per tutti i canali.
  • L'utente resta vincolato ai termini di Meta.

Fonte: la panoramica della Messenger Platform di Meta. Ultima verifica: novembre 2026.

Modello ufficiale

Perché la Messenger Platform di Meta si ferma alle Pagine Facebook

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.

1

App Meta

Registrate un'app su Meta for Developers con il caso d'uso Messenger.

2

Facebook Login for Business

Un amministratore della Pagina concede permessi come pages_messaging.

3

Page access token

La vostra app chiama la Send API solo per conto di quella Pagina.

4

Webhook e finestra di 24 ore

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.

Che fine ha fatto la Facebook Chat API?

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.

  • Nessun calendario di rilascio. Smettono di funzionare quando Facebook cambia la sua interfaccia.
  • Credenziali nella vostra app. La vostra app conserva e riutilizza la sessione o la password dell'utente.
  • Rischio per l'account. Facebook può limitare un account il cui utilizzo viola i suoi Termini, e questo rischio ricade sull'utente finale.

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.

Connessione

Come un account Facebook personale si collega alla vostra app

È 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.

1La tua app

Aprire Hosted Auth

L'utente clicca su "Collega Facebook" e arriva su Hosted Auth.

2L'utente

Accedere e confermare

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.

3Unipile

Ottenere un account_id

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.

Conformità

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.

Perimetro

API per account Facebook personale: cosa può fare un account collegato

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.

AspettoPagina tramite Messenger PlatformAccount personale tramite Unipile
AccountUna Pagina Facebook o un account professionale InstagramL'account Facebook personale dell'utente
Chi collegaUn amministratore della Pagina, tramite Facebook Login for BusinessIl titolare dell'account, tramite Hosted Auth o Custom Auth
Cosa conserva la vostra appUn Page access tokenLa vostra chiave API Unipile e l'account_id dell'utente
App Meta e App ReviewUn'app Meta, più l'App Review per servire Pagine che non sono vostreNessuna app Meta e nessuna App Review da parte vostra
Chi scrive per primoLa persona scrive alla PaginaL'utente può rispondere o avviare una nuova conversazione
Eventi in tempo realeWebhook Messenger sulla vostra app MetaMessaggi nuovi, modificati ed eliminati, conferme di lettura e di consegna, reazioni, aggiornamenti delle chat
Account
PaginaUna Pagina Facebook o un account professionale Instagram
Account personaleL'account Facebook personale dell'utente
Chi collega
PaginaUn amministratore della Pagina, tramite Facebook Login for Business
Account personaleIl titolare dell'account, tramite Hosted Auth o Custom Auth
Cosa conserva la vostra app
PaginaUn Page access token
Account personaleLa vostra chiave API Unipile e l'account_id dell'utente
App Meta e App Review
PaginaUn'app Meta, più l'App Review per servire Pagine che non sono vostre
Account personaleNessuna app Meta e nessuna App Review da parte vostra
Chi scrive per primo
PaginaLa persona scrive alla Pagina
Account personaleL'utente può rispondere o avviare una nuova conversazione
Eventi in tempo reale
PaginaWebhook Messenger sulla vostra app Meta
Account personaleMessaggi nuovi, modificati ed eliminati, conferme di lettura e di consegna, reazioni, aggiornamenti delle chat

Endpoint di messaggistica

  • Elencare chat e messaggi, comprese le conversazioni di gruppo
  • Avviare una conversazione, inviare messaggi e allegati
  • Modificare, eliminare e inoltrare messaggi
  • Aggiungere e rimuovere reazioni, segnare come letto, conferme di lettura
  • Silenziare e archiviare le chat

Non supportato

  • Fissare un messaggio
  • Storie

Lo stesso account collegato espone anche i suoi post, commenti e reazioni. Questi endpoint sono riassunti nella guida all'API Facebook.

Codice

Leggere le chat e inviare un messaggio da un account personale

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."},
)
200 OK · messaggio inviato dall'account dell'utente

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.

Come appaiono le due chiamate nella vostra app

1Elencare le chatGET/chats
La tua app Collegato
FacebookAnna Lee, account personale
Tom ReyesCiao Anna, possiamo spostare la call a giovedì?
Maya ChenCi vediamo al mercato sabato
Sam PatelGrazie per le foto
Chat selezionata
chat_id
{CHAT_ID}
name
Tom Reyes
last message
Ciao Anna, possiamo spostare…
timestamp
09:12
2Inviare la rispostaPOST/messages/send
La tua app Collegato
Tom ReyesFacebookAnna Lee, account personale
Ciao Anna, possiamo spostare la call a giovedì?09:12
Giovedì alle 10 per me va bene.09:14 · Visualizzato
Richiesta
chat_id
{CHAT_ID}
text
Giovedì alle 10 per me…
response
200 OK
Casi d'uso

Casi d'uso legittimi e regole di Meta che i vostri utenti continuano a rispettare

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.

CRM

Un commerciale ritrova le proprie conversazioni Messenger nella scheda del contatto giusto, accanto a email e chiamate. Scopri l'integrazione CRM.

Helpdesk e inbox multicanale

Messenger si trova nella stessa inbox di LinkedIn, WhatsApp, Instagram e Telegram, con un unico modello di dati.

Assistente IA

Un agente prepara una risposta a partire dallo storico della conversazione e l'utente la rivede prima dell'invio.

Follow-up dei consulenti

Un consulente o un agente tiene traccia dei clienti con cui parla già su Messenger.

I termini di Meta restano validi

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.

Graph API

API Facebook per account personali: cosa consente ancora la Graph API

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.

AzioneGraph API con un user access tokenAccount personale collegato tramite Unipile
Leggere i messaggi Messenger dell'utenteNo, nessun permesso utente copre la casellaSì, chat, messaggi e allegati
Pubblicare sul profilo dell'utenteNo, publish_actions è stato rimosso nel 2018Sì, creare, modificare ed eliminare post
Rispondere ai messaggiNo, la Messenger Platform serve le PagineSì, rispondere o avviare una conversazione
Leggere i messaggi Messenger dell'utente
Graph APINo, nessun permesso utente copre la casella
Account collegatoSì, chat, messaggi e allegati
Pubblicare sul profilo dell'utente
Graph APINo, publish_actions è stato rimosso nel 2018
Account collegatoSì, creare, modificare ed eliminare post
Rispondere ai messaggi
Graph APINo, la Messenger Platform serve le Pagine
Account collegatoSì, rispondere o avviare una conversazione

Fonti: 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.

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

Ogni utente collega il proprio account, senza archiviazione dei profili. Unipile non è un Meta Partner. Leggete la nostra pagina sul Digital Markets Act

Riferimento endpoint

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.

FAQ sull'API per account Facebook personale

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