
Guide all'integrazione
Guida all'API di LinkedIn
Guida all'API email
Guida all'API di WhatsApp
Contatta le vendite
Per i team che sviluppano un CRM o un SaaS: collegare l'account Facebook e le Pagine di ogni utente, sincronizzare le conversazioni, associare i contatti, rispondere dalla scheda.
api.unipile.com/v2/{ACCOUNT_ID}/chats
200 OK
Un'integrazione CRM con Facebook Messenger sincronizza le conversazioni Messenger di ogni utente sulle schede contatto del CRM e permette di rispondere direttamente dal CRM. Questa guida si rivolge ai team che integrano questa funzione nel proprio CRM o prodotto SaaS, non alle aziende che stanno scegliendo un CRM.
Servono quattro elementi: una connessione per utente, storico e sincronizzazione in tempo reale, associazione dei contatti e risposte con l'identità corretta.
Realizzatela con Unipile in tre passaggi
Collegate l'account Facebook e le Pagine di ogni utente tramite Hosted Auth. Nessuna app Meta, nessuna App Review.
Recuperate lo storico delle chat con GET /v2/{account_id}/chats, inviando il vostro header X-API-KEY.
Ricevete nuovi messaggi, modifiche e reazioni tramite webhook, a partire da message.new.
Un'integrazione CRM con Facebook Messenger collega le conversazioni Messenger a un CRM: ogni messaggio finisce sulla scheda contatto giusta e gli utenti rispondono senza uscire dal CRM. Per un'azienda è un connettore da attivare. Per un team di prodotto è una funzionalità da integrare nel proprio CRM o SaaS: questa guida tratta questo secondo caso.
In entrambi i casi: leggere, associare a un contatto, rispondere dal CRM, in tempo reale, per ogni utente. La nostra panoramica su come si combinano le API di Facebook descrive le piattaforme di Meta.
{FACEBOOK_USER_ID}Storico e nuovi messaggi, per ogni utente.
Ogni conversazione a un solo contatto.
Dalla scheda, come utente o come Pagina.
Webhook, non polling.
Un connettore no-code è rapido ma quasi sempre unidirezionale. La Messenger Platform di Meta è bidirezionale ma solo per le Pagine, dietro App Review. Un'API di connessione per utente copre account personali e Pagine, senza app Meta.
| Domanda | Connettore no-code | Messenger Platform di Meta | Connessione per utente (Unipile) |
|---|---|---|---|
| Account | Di solito una sola Pagina Facebook | Solo Pagine Facebook (Pagine aziendali) | Account personali e le Pagine che gestiscono |
| Direzione | Quasi sempre unidirezionale: dal messaggio al lead | Bidirezionale, entro la finestra di 24 ore | Sincronizzazione bidirezionale: leggere, rispondere, reagire |
| Tempo reale | Spesso polling, ogni 15 minuti su alcuni piani | Webhook di Meta | Webhook come message.new |
| Cosa gestite | Un workflow per configurazione | App Meta, App Review, un token per Pagina | Un link Hosted Auth, un account_id per utente |
| Storico | Varia a seconda del connettore | Conversazioni della Pagina | Chat personali e inbox di ogni Pagina |
| Altri canali | Un connettore per ciascuno | Un'integrazione per ogni prodotto Meta | Stessa API per LinkedIn, WhatsApp, Instagram, email |
message.newaccount_id per utenteZapier o Make vanno bene per una sola azienda e una sola Pagina, e Meta Business Suite offre a quell'azienda una inbox per la propria Pagina. Un prodotto con molti clienti ha bisogno dell'integrazione nel proprio codice.
Con l'approccio di Meta, ogni Pagina cliente richiede un Page access token e autorizzazioni verificate da Meta, come mostra la nostra guida alla Facebook Page API. Le risposte seguono la finestra di 24 ore e i message tag, molti dei quali Meta ha ritirato nel 2026. E non raggiunge mai gli account personali che commerciali e consulenti usano con i clienti.
Fonti: invio di messaggi con la Messenger Platform di Meta, funzionalità per provider di Unipile. Ultima verifica: 17 novembre 2026.
Ogni utente del CRM apre un link Hosted Auth e accede a Facebook, autenticazione a due fattori inclusa. Il vostro CRM riceve un unico account_id che copre il suo account personale e tutte le Pagine che amministra, attivate per impostazione predefinita.
Il vostro backend lo richiede, l'utente lo apre.
Hosted AuthCredenziali, 2FA, poi sblocco facoltativo dello storico.
ENCRYPTED_HISTORYSalvatelo sull'utente del CRM. Le sue Pagine sono incluse.
{ACCOUNT_ID}Le Pagine si attivano tramite il prodotto page al collegamento o alla riconnessione; una Pagina non attivata restituisce 403 api/insufficient_permissions. L'accesso è descritto nella nostra guida all'API Facebook Messenger per account personali.
Fonte: documentazione Facebook Pages di Unipile. Ultima verifica: 17 novembre 2026.
Prima recuperate lo storico tramite l'API: chat personali, poi l'inbox di ogni Pagina. Poi passate ai webhook, così ogni nuovo messaggio, modifica, conferma o reazione arriva al vostro CRM in tempo reale, come indicato nella nostra pagina API Facebook Messenger.
account_idGET /chats una volta, poi message.newL'elenco delle chat dell'account contiene solo le conversazioni personali; ogni Pagina ha la propria inbox, PAGE_<page_id>_INBOX. Gli elenchi restituiscono fino a 100 elementi per pagina, dai messaggi più recenti: scorrete all'indietro fin dove serve al vostro CRM.
https://api.unipile.com · header X-API-KEYLe chat personali 1:1 e di gruppo sono crittografate end-to-end; le conversazioni delle Pagine no. I messaggi personali passati si trovano in un backup crittografato che l'utente sblocca con il codice di recupero o il PIN di Messenger, in un passaggio che Hosted Auth mostra al collegamento. Senza questo passaggio, sono disponibili solo i messaggi successivi al collegamento.
Un solo URL webhook serve tutti gli account collegati. Gli eventi delle Pagine riportano il chat ID relativo alla Pagina, quindi instradateli in base al prefisso PAGE_<page_id>_. Eventi disponibili per Facebook:
Fonti: documentazione Unipile recupero di chat e messaggi, chat crittografate, funzionalità per provider e configurazione di un webhook. Ultima verifica: 17 novembre 2026.
Collegate un account Facebook nel vostro workspace di prova
Collegate un account, elencate le sue chat e puntate un webhook verso il vostro servizio. Prova gratuita di 7 giorni, senza carta di credito.
Associate ogni conversazione a un contatto tramite l'ID Facebook dell'interlocutore, mai tramite il nome visualizzato. Instradate le conversazioni delle Pagine e quelle personali in base al prefisso PAGE_<page_id>_ del chat ID.
| Identificativo | Dove salvarlo | Attenzione |
|---|---|---|
| ID Facebook dell'interlocutore | Sul contatto: la vostra chiave di associazione | Mai associare tramite il nome visualizzato |
account_id | Sull'utente del CRM che ha collegato Facebook | Copre l'account personale e le Pagine |
| Chat ID personale | Sulla conversazione | Non è una chiave di contatto |
Chat ID di una Pagina PAGE_<page_id>_<thread_key> | Sulla conversazione e sulla sua Pagina | Il prefisso fa agire Unipile come Pagina |
| ID della Pagina e ID del profilo della Pagina | L'ID della Pagina, su inbox e stato | Gli autori di una Pagina usano l'ID del profilo: non confrontate mai i due |
PAGE_<page_id>_<thread_key>)Una trappola: per la stessa conversazione, il chat ID restituito dall'API può essere diverso da quello di un evento webhook. Salvateli entrambi sulla conversazione e riconciliateli lato CRM, partendo dall'ID Facebook del contatto. «Find Chats by User» restituisce le chat esistenti di un contatto, oppure un elenco vuoto.
readUnipileEvent rappresenta la vostra mappatura del payload.
// One URL for every connected account
app.post("/webhooks/unipile", express.json(), async (req, res) => {
res.sendStatus(200); // acknowledge first, process after
// Your mapping of the payload documented in the webhook reference
const evt = readUnipileEvent(req.body);
if (evt.type !== "message.new") return;
// 1. Route: a PAGE_<page_id>_ prefix means a Page conversation
const page = evt.chatId.match(/^PAGE_([^_]+)_/);
const inbox = page ? { kind: "page", pageId: page[1] } : { kind: "personal" };
// 2. Owner: the CRM user who connected this account_id
const owner = await crm.users.findByAccountId(evt.accountId);
// 3. Contact: the other person's Facebook ID, never the name
const contact =
(await crm.contacts.findByFacebookId(owner.tenantId, evt.counterpartId)) ??
(await crm.contacts.createForReview({ facebookId: evt.counterpartId, owner }));
// 4. Keep the webhook chat ID next to the one from the backfill
await crm.conversations.addChatId(contact.id, inbox, evt.chatId, "webhook");
// 5. Write the message once, keyed by its message ID
await crm.messages.upsert({
contactId: contact.id, inbox, messageId: evt.messageId,
direction: evt.fromOwner ? "out" : "in", text: evt.text,
});
});
import re
from flask import request
PAGE_PREFIX = re.compile(r"^PAGE_([^_]+)_")
# One URL for every connected account
@app.post("/webhooks/unipile")
def unipile_webhook():
# Your mapping of the payload documented in the webhook reference
evt = read_unipile_event(request.get_json())
if evt.type != "message.new":
return "", 200
# 1. Route: a PAGE_<page_id>_ prefix means a Page conversation
page = PAGE_PREFIX.match(evt.chat_id)
inbox = {"kind": "page", "page_id": page.group(1)} if page else {"kind": "personal"}
# 2. Owner: the CRM user who connected this account_id
owner = crm.users.find_by_account_id(evt.account_id)
# 3. Contact: the other person's Facebook ID, never the name
contact = crm.contacts.find_by_facebook_id(owner.tenant_id, evt.counterpart_id) \
or crm.contacts.create_for_review(facebook_id=evt.counterpart_id, owner=owner)
# 4. Keep the webhook chat ID next to the one from the backfill
crm.conversations.add_chat_id(contact.id, inbox, evt.chat_id, source="webhook")
# 5. Write the message once, keyed by its message ID
crm.messages.upsert(
contact_id=contact.id, inbox=inbox, message_id=evt.message_id,
direction="out" if evt.from_owner else "in", text=evt.text,
)
return "", 200
Formati dei chat ID tratti dalla documentazione Facebook Pages, ricerca delle chat da recupero di chat e messaggi.
Inviate la risposta nel chat ID della conversazione. Un chat ID di una Pagina risponde come Pagina; un chat ID personale invia dall'account dell'utente. L'editor mostra quale identità si applica.
Una Pagina risponde solo a chi le ha scritto.
/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
501 api/not_implementedDisattivate «Nuova conversazione» per una Pagina. Corpo della richiesta, allegati ed errori: vedete come inviare un messaggio Messenger tramite API.
Mostrate lo stato di ogni connessione. Ogni Pagina riporta il proprio stato, quindi una Pagina in errore non blocca i messaggi personali né le altre Pagine.
metadata.products_connection_status
per Pagina
Ogni Pagina ha la propria chiave in metadata.products_connection_status, chiamata page_<page_id>. Quando una Pagina smette di funzionare, l'account passa a partial o degraded. Una Pagina che ha perso il ruolo di amministratore resta disconnected fino alla riconnessione: mostratelo e proponete di ricollegarla.
Mostrate le conversazioni personali al loro titolare e ai responsabili scelti, quelle delle Pagine al team della Pagina, in una inbox unificata con assegnazione e tag. È lo stesso modello di una API di messaggistica per software CRM che copre LinkedIn, WhatsApp ed email, ed è il motivo per cui un'API di messaggistica unificata permette di aggiungere Messenger senza un nuovo connettore.
Ogni utente collega il proprio account
Per CRM, assistenza clienti, consulenti o un agente IA le cui bozze vengono approvate da una persona. Nessun invio massivo.
Iniziate a sviluppare la vostra integrazione Messenger
Un'integrazione CRM con Facebook Messenger significa una connessione per utente, un recupero dello storico seguito dai webhook, contatti associati tramite ID Facebook e risposte con l'identità corretta. Lo stesso codice serve 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. Unipile e il DMA
Tutti gli endpoint dell'API Facebook in un unico posto
Messenger è solo una parte del quadro. Consultate tutti gli endpoint Facebook disponibili con Unipile, dai post ai commenti fino ai profili, oppure partite dalla nostra guida completa all'API Facebook.
Messaggistica CRM, risposte automatizzate e più Pagine.
Perché le conversazioni non restino più sul telefono di una sola persona. Ogni messaggio finisce sulla scheda contatto, il team vede lo storico completo e follow-up, assegnazione e reporting funzionano su Messenger come sull'email.
Inviare e ricevere messaggi su Messenger, WhatsApp, LinkedIn o email dall'interno di un CRM, con ogni conversazione associata a un contatto. Un'integrazione CRM con Facebook Messenger copre un solo canale; un'API di messaggistica unificata porta gli altri con lo stesso modello dati.
Mantenete una persona nel processo: un agente IA prepara una bozza di risposta a partire dallo storico del contatto e un utente la approva prima dell'invio. Gli utenti restano vincolati ai termini di Meta: niente messaggi non richiesti o massivi.
Sì. Ogni Pagina amministrata dall'utente è attivata per impostazione predefinita sullo stesso account_id, ciascuna con la propria inbox (PAGE_<page_id>_INBOX) e il proprio stato. Mostrate ogni Pagina come una inbox separata nel vostro CRM.
Avete ancora domande? Il nostro team è qui per aiutarvi.
Parla con un esperto