IT
Guida all'integrazione CRM

Integrazione CRM con Facebook Messenger: come integrarla nel vostro prodotto

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.

Il tuo CRM · Messenger Sincronizzato
Leo MartinSpedite la giacca di lino a Lione?Associato · LeadCoveton Apparel
Sara KimGrazie Anna, firmo domani.Associato · DealPersonale
Omar HaddadTu: Il tuo ordine è partito dal magazzino.Associato · ClienteCoveton Apparel
Webhook message.new message.receipt.read
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
Risposta breve

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.

Con Unipile

Realizzatela con Unipile in tre passaggi

  1. 1

    Collegate l'account Facebook e le Pagine di ogni utente tramite Hosted Auth. Nessuna app Meta, nessuna App Review.

  2. 2

    Recuperate lo storico delle chat con GET /v2/{account_id}/chats, inviando il vostro header X-API-KEY.

  3. 3

    Ricevete nuovi messaggi, modifiche e reazioni tramite webhook, a partire da message.new.

Definizione

Che cos'è un'integrazione CRM con Facebook Messenger?

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.

Il tuo CRM · Contatto Live
Leo MartinLead · Lione
ResponsabileAnna Rossi
CanaleMessenger · Pagina Coveton Apparel
ID Facebook{FACEBOOK_USER_ID}
AttivitàEmailMessenger 2Deal
FacebookInbox della PaginaCoveton Apparel
Ciao, spedite la giacca di lino a Lione?10:40
Sì, la consegna richiede 3 giorni. Che taglia ti serve?Coveton Apparel · 10:41
01

Leggere

Storico e nuovi messaggi, per ogni utente.

02

Associare

Ogni conversazione a un solo contatto.

03

Rispondere

Dalla scheda, come utente o come Pagina.

04

Restare live

Webhook, non polling.

Approcci

Come collegare Facebook Messenger a un CRM: tre approcci

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.

DomandaConnettore no-codeMessenger Platform di MetaConnessione per utente (Unipile)
AccountDi solito una sola Pagina FacebookSolo Pagine Facebook (Pagine aziendali)Account personali e le Pagine che gestiscono
DirezioneQuasi sempre unidirezionale: dal messaggio al leadBidirezionale, entro la finestra di 24 oreSincronizzazione bidirezionale: leggere, rispondere, reagire
Tempo realeSpesso polling, ogni 15 minuti su alcuni pianiWebhook di MetaWebhook come message.new
Cosa gestiteUn workflow per configurazioneApp Meta, App Review, un token per PaginaUn link Hosted Auth, un account_id per utente
StoricoVaria a seconda del connettoreConversazioni della PaginaChat personali e inbox di ogni Pagina
Altri canaliUn connettore per ciascunoUn'integrazione per ogni prodotto MetaStessa API per LinkedIn, WhatsApp, Instagram, email
Account
No-codeDi solito una sola Pagina Facebook
MetaSolo Pagine Facebook
UnipileAccount personali e le Pagine che gestiscono
Direzione
No-codeQuasi sempre unidirezionale: dal messaggio al lead
MetaBidirezionale, entro la finestra di 24 ore
UnipileSincronizzazione bidirezionale: leggere, rispondere, reagire
Tempo reale
No-codeSpesso polling, ogni 15 minuti su alcuni piani
MetaWebhook di Meta
UnipileWebhook come message.new
Cosa gestite
No-codeUn workflow per configurazione
MetaApp Meta, App Review, un token per Pagina
UnipileUn link Hosted Auth, un account_id per utente
Storico
No-codeVaria a seconda del connettore
MetaConversazioni della Pagina
UnipileChat personali e inbox di ogni Pagina
Altri canali
No-codeUn connettore per ciascuno
MetaUn'integrazione per ogni prodotto Meta
UnipileStessa API per LinkedIn, WhatsApp, Instagram, email

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

Connessione

Collegare l'account Facebook e le Pagine di ogni utente

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.

1

Aprire un link Hosted Auth

Il vostro backend lo richiede, l'utente lo apre.

Hosted Auth
2

Accedere e sbloccare lo storico

Credenziali, 2FA, poi sblocco facoltativo dello storico.

ENCRYPTED_HISTORY
3

Salvare l'account_id

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

Sincronizzazione

Sincronizzare lo storico delle conversazioni e i nuovi messaggi in tempo reale

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.

FacebookOrigineAccount personale + PagineUno per utente del CRM
ConnessioneUnipileUn solo account_id
Dati in ingressoStorico, poi webhookGET /chats una volta, poi message.new
Il vostro codiceServizio di syncInstrada, associa, deduplica
I vostri datiDatabase del CRMContatti e messaggi

Recuperare lo storico delle chat personali e delle inbox delle Pagine

L'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.

URL di base https://api.unipile.com · header X-API-KEY
GET/v2/{account_id}/chatsChat personali dell'account collegato
GET/v2/{account_id}/inboxes/{inbox_id}/chatsChat dell'inbox di una Pagina
GET/v2/{account_id}/chats/{chat_id}/messagesMessaggi di una chat, dal più recente

Chat crittografate e storico

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

Webhook

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:

message.new message.update message.delete message.receipt.read message.receipt.delivery message.reaction.new chat.update chat.delete

Fonti: documentazione Unipile recupero di chat e messaggi, chat crittografate, funzionalità per provider e configurazione di un webhook. Ultima verifica: 17 novembre 2026.

Provatelo

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.

Crea ora
Modello dati

Associare le conversazioni Messenger ai contatti del CRM

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.

IdentificativoDove salvarloAttenzione
ID Facebook dell'interlocutoreSul contatto: la vostra chiave di associazioneMai associare tramite il nome visualizzato
account_idSull'utente del CRM che ha collegato FacebookCopre l'account personale e le Pagine
Chat ID personaleSulla conversazioneNon è una chiave di contatto
Chat ID di una Pagina PAGE_<page_id>_<thread_key>Sulla conversazione e sulla sua PaginaIl prefisso fa agire Unipile come Pagina
ID della Pagina e ID del profilo della PaginaL'ID della Pagina, su inbox e statoGli autori di una Pagina usano l'ID del profilo: non confrontate mai i due
ID Facebook dell'interlocutore
Dove salvarloSul contatto: la vostra chiave di associazione
AttenzioneMai associare tramite il nome visualizzato
account_id
Dove salvarloSull'utente del CRM che ha collegato Facebook
AttenzioneCopre l'account personale e le Pagine
Chat ID personale
Dove salvarloSulla conversazione
Chat ID di una Pagina
Dove salvarloSulla conversazione e sulla sua Pagina (PAGE_<page_id>_<thread_key>)
AttenzioneIl prefisso fa agire Unipile come Pagina
ID della Pagina e ID del profilo della Pagina
Dove salvarloL'ID della Pagina, su inbox e stato
AttenzioneGli autori di una Pagina usano l'ID del profilo: non confrontate mai i due

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.

Un handler message.new che scrive sulla scheda contatto

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
200 OK · un contatto per ID Facebook, una riga per message ID
200 OK · un contatto per ID Facebook, una riga per message ID

Formati dei chat ID tratti dalla documentazione Facebook Pages, ricerca delle chat da recupero di chat e messaggi.

Risposta

Rispondere dalla scheda contatto, come utente o come Pagina

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.

Il tuo CRM · Leo Martin Conversazione Pagina
Taglia M, per favore. Può arrivare entro venerdì?10:42
Sì, se ordini entro le 14 di oggi.Coveton Apparel · 10:44
Perfetto, ordino subito.10:46
Rispondi comeAnna RossiFacebookPagina Coveton Apparel
Grazie Leo, il tuo ordine è confermato. Il link di tracciamento arriverà a breve.
Nuova conversazioneInvia

Una Pagina risponde solo a chi le ha scritto.

POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Da una chat di Pagina
  • Le risposte partono come Pagina
  • Nessuna nuova conversazione: 501 api/not_implemented
  • Nessuna eliminazione dei suoi messaggi: stesso errore
Da una chat personale
  • Le risposte partono dall'account dell'utente
  • Può avviare una conversazione quando Facebook lo consente

Disattivate «Nuova conversazione» per una Pagina. Corpo della richiesta, allegati ed errori: vedete come inviare un messaggio Messenger tramite API.

Operatività

Gestirla per ogni cliente: stato, autorizzazioni e regole di Meta

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.

Admin · Account collegati Parziale
ConnessioneStato
FacebookAnna RossiMessaggistica · account personalerunning
Pagina Coveton Apparelpage_<page_id>running
Pagina Coveton OutletRuolo admin rimossodisconnectedRicollega
STATUS 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.

Decidere chi vede quali conversazioni

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.

Conformità

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.

App Meta o App Review?Non servono: gli utenti si collegano tramite Hosted Auth.
Partner ufficiale Meta?No. Unipile non è né un'app ufficiale Meta né un Meta Partner.
Termini di Meta?Ogni utente resta vincolato ai termini di Meta.
Digital Markets Act?Nessuna archiviazione dei profili. Consultate la nostra pagina sul Digital Markets Act.

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.

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

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.

FAQ sull'integrazione CRM con Facebook Messenger

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