betool betool

Documentazione

Meta Lead Ads

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

Meta Lead Ads

Il canale Meta Lead Ads collega la tua app Facebook Business 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 completamente automatizzato.

Prerequisiti

  • Un'applicazione Meta (Facebook for Developers) con il permesso leads_retrieval.
  • Una pagina Facebook approvata per i Lead Ads.
  • Almeno un modulo Lead Ad attivo.

Configurazione

  1. Amministrazione → Meta → Applicazioni — collega la tua app Meta con il suo App ID e App Secret.
  2. Lato Meta Developers, aggiungi il webhook fornito da betool sull'oggetto page con il campo leadgen.
  3. Seleziona le pagine pertinenti e autorizza l'app.
  4. Lato betool, associa ogni modulo a una pipeline di destinazione.

Cosa riceve la pipeline

Per ogni lead inviato, viene creato un exchange con:

  • lead.full_name, lead.email, lead.phone — campi standard (normalizzati)
  • lead.form_fields — tutte le domande del modulo con le loro risposte
  • lead.form_id, lead.ad_id, lead.campaign_id — per l'attribuzione
  • lead.created_time — timestamp Meta (UTC)

Caso d'uso tipico

[facebook_leads]──▶[agent: enrich]──▶[condition: quality]
                                        ├─▶[operator: create CRM]
                                        └─▶[agent: immediate follow-up]

L'agent di arricchimento chiama uno strumento di verifica email + un operatore HTTP per interrogare il tuo database storico. La condizione instrada i lead qualificati verso il CRM e i lead caldi verso una risposta WhatsApp / email immediata.

Limitazioni

  • Rate limit di Meta — l'API ha rate limit. Per volumi elevati, prevedi un buffer.
  • Permessi — Meta può revocare il permesso leads_retrieval se la tua 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.