Integrazione CRM delle Facebook lead ads: come portare i lead nel tuo CRM

I lead degli Instant Form escono da Meta in sei modi: download manuale, integrazione CRM nativa, middleware come Zapier, collegamento con Google Sheets o Excel, webhook con la Graph API, oppure bulk read della Graph API. Una vera integrazione CRM delle Facebook lead ads è uno degli ultimi cinque: gira da sola, e questo conta, perché Meta tiene i lead scaricabili per 90 giorni.

Qualunque strada scegli, salva due ID su ogni lead: il lead ID di Meta, perché il tuo CRM possa rimandare le fasi a Meta, e l’ad ID, per calcolare il CPL per annuncio.

Come scaricare i lead di Facebook a mano

Meta permette di scaricare i lead in un file CSV o XLS da tre posti:

• Ads Manager: apri la scheda Inserzioni, clicca il link On-Facebook leads (in italiano Contatti su Facebook) nella colonna Risultati, filtra per annuncio, località, lingua e intervallo di date, e scarica. Puoi estrarre i lead di più campagne in una volta.
• La sezione Instant forms di Meta Business Suite: All tools, Instant forms, poi Download accanto al modulo. Download new leads esporta solo quello che è arrivato dall’ultimo download.
• Il Leads Center di Meta Business Suite (in italiano Centro contatti): l’icona di download esporta il filtro attuale, ma i campi si limitano a data, nome, email, telefono, fase, fonte e assegnatario, e un file contiene fino a 10.000 lead.

I file di Ads Manager e di Business Suite hanno le colonne utili: il lead ID (id), l’orario di creazione, ID e nomi di annuncio, ad set e campagna, ID e nome del modulo, is_organic e platform, poi una colonna per ogni domanda (Informazioni incluse quando scarichi i dati dei lead). Meta dice che per vederle tutte servono sia i permessi di amministratore della Pagina Facebook sia un ruolo sull’account pubblicitario. I campi dell’annuncio restano vuoti per i lead organici, per gli invii da anteprima dell’annuncio e per chi non ha privilegi da inserzionista sull’account pubblicitario.

La stessa guida per sviluppatori di Meta definisce il download manuale “non consigliato”, accettabile come soluzione temporanea quando un’integrazione ha problemi (Collegare il CRM per scaricare i lead). Il motivo è l’orologio: Meta tiene i lead disponibili per il download fino a 90 giorni dall’invio, per ragioni di sicurezza e di archiviazione, e consiglia di scaricarli spesso o di usare un CRM (Informazioni sui lead scaduti).

Quando il download non coincide con Ads Manager

Esempio: un ad set con Instant Form mostra 300 lead nella colonna Risultati per marzo.

Le righe dei lead organici e di test vengono dalle note di Meta sui lead organici: esistono solo se l’impostazione di condivisione del modulo è Open (Restricted è il default), si scaricano da Business Suite ma non da Ads Manager, e né loro né i lead di test vengono contati nei Risultati. L’ultima riga è la regola dei 90 giorni: Risultati continua a contare lead che non puoi più scaricare.

Integrazioni CRM native per le Facebook lead ads

Meta tiene un elenco consultabile dei sistemi CRM con un’integrazione per le lead ads. Per collegarne uno (Collegare il sistema CRM a Meta Business Suite):

1. In Meta Business Suite, apri All tools, poi Instant forms.
2. Seleziona la scheda CRM setup e cerca il tuo CRM.
3. Clicca Connect from website e completa i passaggi dal lato del CRM. Le voci indicate “through Zapier” si collegano invece tramite Zapier.

L’articolo di Meta sui vantaggi dell’integrazione CRM dice che da quel momento i nuovi lead arrivano al CRM in automatico e in tempo reale. Solo gli amministratori della Pagina Facebook con il permesso di accesso ai lead possono collegare un CRM, e se qualcuno con il controllo completo del portafoglio business ha personalizzato l’accesso ai lead, il CRM va assegnato lì prima che arrivi qualunque lead (Assegnare o rimuovere i permessi di accesso ai lead). Un’integrazione configurata dal sito del CRM non si può modificare né scollegare da Business Suite; la gestisci dal lato del CRM.

Prima di decidere, verifica una cosa: l’integrazione salva il lead ID di Meta? La guida di Meta per trovare il lead ID indica dove finisce:

Senza il lead ID, quando vorrai rimandare le fasi a Meta ti mancherà la chiave di corrispondenza migliore.

Due impostazioni del modulo rendono più pulita qualunque integrazione. Conviene impostarle quando crei il modulo, perché i moduli pubblicati potrebbero dover essere duplicati e modificati (Informazioni sui parametri di tracciamento):

• Nomi dei campi. In Settings, Field names, rinomina le colonne in modo che corrispondano agli ID dei campi del tuo CRM, così i lead di Meta finiscono negli stessi campi dei lead degli altri canali (Modificare i nomi dei campi).
• Parametri di tracciamento. In Settings, Tracking parameters, aggiungi coppie nome e valore come utm_source = Facebook. Le persone non li vedono; sono inclusi nei download, passati ai CRM integrati e disponibili per le integrazioni via webhook e API. Nomi e valori non possono essere vuoti né riusare il nome di un campo del modulo (Configurare i parametri di tracciamento).

Il resto della configurazione del modulo è nelle best practice delle Facebook lead ads.

Middleware: Zapier, LeadsBridge e Make

Se il tuo CRM non ha un’integrazione nativa, Meta indica strumenti di terze parti come Zapier e LeadsBridge come l’opzione facile e senza codice. La procedura di Meta per Zapier parte dalla stessa scheda CRM setup: collega il tuo account Zapier, scegli la Pagina Facebook e l’Instant Form, testa il trigger, scegli l’azione nel tuo CRM (di solito Create contact) e mappa i campi del modulo sui campi del CRM.

Mappa tre ID dal primo giorno: lead ID, ad ID e ID del modulo. Sul primo la procedura di Meta è netta: salvare il lead ID è obbligatorio se vuoi configurare un’integrazione Conversions API per CRM. E siccome la procedura ti fa scegliere un Instant Form specifico, controlla che i nuovi moduli siano coperti quando li lanci.

Google Sheets o Excel: un foglio di calcolo a due vie

Per un team piccolo senza CRM, Meta può scrivere i lead direttamente in un foglio di calcolo. Collega Google Sheets o Microsoft Excel dalla sezione Instant forms di Meta Business Suite, scegli il foglio e il modulo, e i nuovi lead compaiono come righe. Un’opzione crea in automatico un nuovo foglio di lavoro per ogni nuovo modulo. Se invece avvii la configurazione di Sheets da Ads Manager, il foglio di calcolo deve essere vuoto.

La parte utile va nell’altra direzione. Ogni riga riceve un Lead ID e una colonna lead_status con fasi come Intake, Qualified, Converted, Lost e Not qualified. Ogni volta che aggiorni lead_status, Meta legge la modifica e ne crea un evento Conversions API. E se lavori i lead nel Leads Center, Meta dice che i lead degli Instant Form vengono inviati in automatico, senza bisogno di configurazione (Collegare il CRM con la Conversions API per CRM).

Un foglio di calcolo non assegna i lead, non ricorda a nessuno di chiamare e non impedisce a due persone di chiamare lo stesso contatto. Passa a un CRM quando a lavorare i lead sono più persone.

DropCPL non sincronizza i lead degli Instant Form: gestisce i lead raccolti dalle tue landing page, e inoltra ognuno via webhook con il suo annuncio e la sua landing page attaccati. Il click viene registrato sul dominio stesso della landing page e l’evento Lead va a Meta tramite la Conversions API, quindi quei lead arrivano al tuo CRM con un ad ID da collegare alla spesa. Inizia gratis →

Inviare i lead di Facebook al CRM con webhook e Graph API

È la strada per le agenzie con molte Pagine Facebook, regole di instradamento su misura o un CRM con cui nessuno si integra. La guida di Meta al recupero dei lead descrive due metodi: i webhook, che ti avvisano di ogni nuovo lead, e il bulk read, che chiami tu quando vuoi.

Cosa serve prima

• Un’app Meta che abbia superato l’App Review per leads_retrieval e pages_manage_ads, seguita dalla Business Verification. Un’app in modalità sviluppo non può recuperare lead, tranne quelli inviati da persone con un ruolo nell’app (panoramica delle Lead Ads).
• Un token dalla persona giusta: un token di accesso della Pagina o dell’utente, richiesto da qualcuno che può fare pubblicità sia sull’account pubblicitario sia sulla Pagina Facebook. Preferisci un token della Pagina: Meta avverte che i token utente hanno un limite di chiamate legato agli utenti attivi dell’app, di solito uno per un’integrazione delle lead ads. Meta suggerisce anche un token della Pagina di lunga durata, così l’integrazione non si ferma alla scadenza di un token.
• Questi permessi per leggere tutti i dati dei lead e quelli a livello di annuncio: ads_management, leads_retrieval, pages_show_list, pages_read_engagement e pages_manage_ads, più pages_manage_metadata per i webhook.
• L’accesso ai lead per la persona dietro il token. Se l’azienda ha personalizzato l’accesso ai lead e quella persona non è assegnata, il recupero fallisce.

Il flusso del webhook

1. Iscrivi la tua app al campo leadgen dell’oggetto Page, poi installala sulla Pagina Facebook con una POST a /{page-id}/subscribed_apps?subscribed_fields=leadgen (Webhook per le lead ads).
2. Per ogni nuovo lead, Meta invia una notifica al tuo endpoint. Meta dice che queste notifiche in tempo reale possono arrivare con un ritardo fino a qualche minuto.
3. Recupera il lead tramite il suo leadgen_id.
4. Salvalo, poi instradalo.

La notifica contiene ID, non risposte. Questo è l’esempio di Meta:

{
  "object": "page",
  "entry": [
    {
      "id": 153125381133,
      "time": 1438292065,
      "changes": [
        {
          "field": "leadgen",
          "value": {
            "leadgen_id": 123123123123,
            "page_id": 123123123,
            "form_id": 12312312312,
            "adgroup_id": 12312312312,
            "ad_id": 12312312312,
            "created_time": 1440120384
          }
        }
      ]
    }
  ]
}

Poi recupera il lead vero e proprio:

GET https://graph.facebook.com/{API_VERSION}/{LEADGEN_ID}?fields=created_time,ad_id,campaign_id,form_id,field_data&access_token={PAGE_ACCESS_TOKEN}

field_data contiene le risposte come coppie di nome e valori. Le risposte alle caselle facoltative del custom disclaimer non ci sono; richiedi custom_disclaimer_responses a parte.

Il bulk read come rete di sicurezza

Il bulk read estrae i lead da un annuncio o da un modulo, con GET /{AD_ID}/leads o GET /{FORM_ID}/leads e un parametro filtering su time_created per prendere solo i nuovi. Un modulo può servire molti annunci, quindi spesso contiene più lead di qualunque singolo annuncio che lo usa. La panoramica di Meta suggerisce il bulk read se recuperi i lead qualche volta al giorno, e i webhook per qualunque frequenza maggiore.

Il limite di chiamate è 200 × 24 × il numero di lead creati dalla Pagina Facebook negli ultimi 90 giorni, ogni 24 ore. Esempio: una Pagina Facebook con 500 lead negli ultimi 90 giorni permette 2.400.000 chiamate al giorno.

Il mio setup: webhook per la velocità, più un bulk read al giorno che confronta i lead ID con quelli già salvati. Un lead che il webhook ha perso salta fuori la mattina dopo; con una finestra di 90 giorni, un lead che nessuno nota prima o poi diventa un lead perso.

Testa prima del lancio

Il Lead Ads Testing Tool di Meta crea un lead di test per un modulo e mostra se il tuo webhook l’ha ricevuto, con il payload. Puoi avere un solo lead di test per modulo alla volta (cancellalo per crearne un altro), lo strumento non funziona in modalità sviluppo, e i suoi lead sono organici e non legati a nessun annuncio, quindi non aspettarti un ad_id.

Cosa deve portare ogni lead nel tuo CRM

Salva gli ID come testo e collega sempre sull’ID, mai sul nome: la guida su come tracciare l’ID annuncio Facebook nel CRM spiega perché, e come trasformarli in CPL per annuncio. Se usi anche le landing page, il lead routing di DropCPL invia annuncio, campagna e landing page con ogni lead della landing page, così entrambe le fonti si collegano alla spesa nello stesso modo.

Rimandare le fasi del CRM con la Conversions API per CRM

Portare fuori i lead è metà del giro. L’altra metà rimanda a Meta l’avanzamento di ogni lead, e da aprile 2026 Meta lo richiede per l’obiettivo di prestazioni dei lead qualificati sulle nuove campagne, mentre le campagne esistenti sono interessate da agosto 2026 (Informazioni sugli obiettivi di prestazioni per le lead ads).

La guida per sviluppatori di Meta la chiama integrazione Conversions API per CRM e sottolinea che è separata da una configurazione Conversions API per il sito: i parametri richiesti sono diversi, e i dati arrivano dal tuo CRM invece che dal tuo web server. Ogni cambio di fase diventa un evento, come mostra la specifica del payload:

{
  "data": [
    {
      "event_name": "Marketing Qualified Lead",
      "event_time": 1793787302,
      "action_source": "system_generated",
      "user_data": {
        "lead_id": 1234567890123456
      },
      "custom_data": {
        "lead_event_source": "HubSpot",
        "event_source": "crm"
      }
    }
  ]
}

event_name è il nome della tua fase, lead_event_source il nome del tuo CRM, e lead_id il lead ID di Meta; in sua assenza, Meta accetta un’email o un numero di telefono con hash, oppure un click ID.

Le regole su cui si inciampa, dall’implementazione per sviluppatori e dalle FAQ di Meta:

• Invia ogni fase, lead grezzo compreso. L’esempio di Meta: 100 lead che diventano 70 marketing qualified lead, 30 opportunità e 15 vendite fanno 215 eventi.
• Attenzione agli orari. event_time deve essere successivo alla creazione del lead, e non più vecchio di 7 giorni rispetto all’invio.
• Batch con prudenza. Un batch contiene fino a 1.000 eventi, e un solo errore scarta l’intero batch, quindi tieni i batch piccoli e prevedi i tentativi.
• Carica almeno una volta al giorno. Se lavori a batch, invia ogni cambio di stato, non una fotografia dell’ultimo.
• Non cambiare Pixel in seguito. Meta dice che cambiarlo avvia una nuova integrazione e fa ripartire l’addestramento.

La validazione richiede almeno sette giorni di dati e almeno due fasi del funnel, tre se possibile.

Non serve uno sviluppatore. L’elenco di Meta dei partner della Conversions API per CRM include HubSpot, LeadsBridge, Make, Salesforce, Stape, Zapier e Zoho, e i collegamenti con Google Sheets ed Excel lo fanno da una colonna. Le stime di Meta danno meno di un giorno per un partner o per Zapier e 3-4 settimane per un’implementazione con sviluppatore, seguite da 2-4 settimane di addestramento. Un dettaglio su HubSpot: siccome Lead Sync non salva il lead ID, Meta suggerisce un’integrazione via webhook o tramite partner, oppure il Lifecycle Stage Sync di HubSpot sui piani Professional ed Enterprise.

Un confine: Meta dice che questo payload è solo per le lead ads di Meta, non per i lead del sito. I lead delle landing page tornano a Meta come normale evento Lead del sito, come spiega la guida su come configurare la Conversions API. Le soglie di Meta per l’obiettivo sono in Qualità dei lead Facebook e nella voce conversion leads.

Quale integrazione CRM per le Facebook lead ads scegliere?

• Nessun CRM, una o due persone che chiamano: il collegamento con Google Sheets o Excel, oppure il Leads Center. Sheets trasforma gli aggiornamenti di lead_status in eventi Conversions API, e Meta dice che il Leads Center non richiede configurazione per i lead degli Instant Form.
• Un CRM con un’integrazione nativa che salva il lead ID: usala, poi imposta nomi dei campi e parametri di tracciamento su ogni modulo.
• Un CRM la cui integrazione perde il lead ID: un middleware con id mappato, oppure i webhook.
• Un’agenzia con molti clienti e Pagine Facebook: webhook più un bulk read al giorno, con un responsabile chiaro del token, perché l’integrazione si rompe il giorno in cui quella persona perde l’accesso all’account pubblicitario o ai lead.
• Download manuale: una riserva per quando qualcosa si rompe, come dice Meta stessa.

Qualunque cosa scegli, invia un lead di test prima del lancio, e ricontrolla il conteggio rispetto alla colonna Risultati dopo la prima settimana.