betool

Documentazione

Meta Lead Ads

Ricezione istantanea dei lead Facebook / Instagram in una pipeline betool.

Il canale Meta Lead Ads collega le tue Pagine Facebook a betool, consentendo l'elaborazione in tempo reale dei lead inviati tramite i tuoi moduli Lead Ads (Facebook, Instagram).

Perché questo canale

I lead Meta vengono tradizionalmente elaborati in batch — esportati in CSV, importati in un CRM, poi qualificati manualmente. Il risultato: un ritardo da 30 minuti a diverse ore tra l'invio del modulo e il primo contatto.

Collegando Meta Lead Ads direttamente a una pipeline betool, riduci questo ritardo a pochi secondi — e il primo contatto (email, WhatsApp, chiamata telefonica) può essere automatizzato.

Due modalità di collegamento

  • Modalità gestita (consigliata) — colleghi la tua Pagina Facebook tramite l'app Meta di betool, già configurata lato piattaforma. betool conserva il token della Pagina e la iscrive automaticamente ai lead (leadgen): nient'altro da configurare.
  • Modalità app personale (avanzata) — usi la tua applicazione Meta: inserisci nel ricevitore il tuo verify_token, il tuo app_secret (verifica della firma X-Hub-Signature-256) e un page_access_token di lunga durata, poi dichiari l'URL di callback fornito da betool nei Webhooks della tua app Meta (oggetto page, campo leadgen).

Configurazione (modalità gestita)

  1. Impostazioni → Servizi → Facebook, scheda Account — clicca su Connetti una Pagina Facebook, autorizza l'app nella finestra di Facebook, poi scegli la Pagina di cui vuoi ricevere i lead.
  2. Nell'editor del modello, configura il nodo Start con un ricevitore Facebook Lead Ads e seleziona la Pagina collegata.
  3. Ogni lead inviato su un modulo di questa Pagina innesca la pipeline.

Cosa riceve la pipeline

Per ogni lead inviato, betool recupera il lead completo tramite l'API Graph, poi crea un exchange con:

  • lead.fields — campi standard normalizzati: full_name, first_name, last_name, email, phone, company, job_title, city, country, state, zip_code
  • lead.custom — le altre domande del modulo, con le relative risposte
  • lead.metadata — leadgen_id, form_id, page_id, created_time (timestamp Meta)
  • lead.raw — la risposta grezza dell'API Graph

Meta riceve subito la sua conferma di ricezione; la pipeline viene poi eseguita da una coda durevole (con nuovi tentativi), il che evita di superare il tempo di risposta imposto da Meta.

Caso d'uso tipico

[Start · Facebook Lead Ads]──▶[agent: qualificare]──▶[filter: lead caldo?]
                                                   ├─▶[connettore CRM: creare la scheda]
                                                   └─▶[invio: follow-up immediato]

L'agent qualifica il lead a partire da lead.fields e lead.custom; filtri deterministici instradano poi i lead qualificati verso il CRM e i lead caldi verso un follow-up email / WhatsApp immediato.

Limitazioni

  • Rate limit di Meta — l'API Graph ha un rate limit. Per volumi elevati, prevedi un buffer.
  • Permessi (modalità app personale) — la tua app deve disporre del permesso leads_retrieval, che Meta può revocare se l'app non è validata. Segui il processo App Review di Meta.
  • Nessun recupero retroattivo — betool non recupera i lead inviati prima della configurazione del webhook. Per questo, esportali e caricali tramite uno script una tantum.