betool

Dokumentation

Meta Lead Ads

Sofortiger Empfang von Facebook-/Instagram-Leads in einer betool-Pipeline.

Der Kanal Meta Lead Ads verbindet Ihre Facebook-Seiten mit betool und ermöglicht die Echtzeitverarbeitung von Leads, die über Ihre Lead-Ads-Formulare (Facebook, Instagram) eingereicht werden.

Warum dieser Kanal

Meta-Leads werden traditionell im Batch verarbeitet — als CSV exportiert, in ein CRM importiert und anschließend manuell qualifiziert. Das Ergebnis: eine Verzögerung von 30 Minuten bis mehreren Stunden zwischen Formularabsendung und Erstkontakt.

Indem Sie Meta Lead Ads direkt mit einer betool-Pipeline verbinden, reduzieren Sie diese Verzögerung auf wenige Sekunden — und der Erstkontakt (E-Mail, WhatsApp, Anruf) kann automatisiert werden.

Zwei Anbindungsmodi

  • Verwalteter Modus (empfohlen) — Sie verbinden Ihre Facebook-Seite über die Meta-App von betool, die plattformseitig bereits konfiguriert ist. betool bewahrt das Token der Seite auf und abonniert die Leads (leadgen) automatisch: sonst ist nichts zu konfigurieren.
  • Modus eigene App (fortgeschritten) — Sie verwenden Ihre eigene Meta-Anwendung: Sie hinterlegen im Empfänger Ihr verify_token, Ihr app_secret (Prüfung der Signatur X-Hub-Signature-256) und ein langlebiges page_access_token und tragen dann die von betool bereitgestellte Callback-URL in den Webhooks Ihrer Meta-App ein (Objekt page, Feld leadgen).

Einrichtung (verwalteter Modus)

  1. Einstellungen → Services → Facebook, Reiter Konten — klicken Sie auf Facebook-Seite verbinden, autorisieren Sie die App im Facebook-Fenster und wählen Sie dann die Seite, deren Leads Sie empfangen möchten.
  2. Konfigurieren Sie im Editor des Modells den Knoten Start mit einem Empfänger Facebook Lead Ads und wählen Sie die verbundene Seite aus.
  3. Jeder auf einem Formular dieser Seite eingereichte Lead löst die Pipeline aus.

Was die Pipeline erhält

Für jeden eingereichten Lead ruft betool den vollständigen Lead über die Graph API ab und erstellt dann einen exchange mit:

  • lead.fields — normalisierte Standardfelder: full_name, first_name, last_name, email, phone, company, job_title, city, country, state, zip_code
  • lead.custom — die übrigen Fragen des Formulars mit ihren Antworten
  • lead.metadata — leadgen_id, form_id, page_id, created_time (Meta-Zeitstempel)
  • lead.raw — die Rohantwort der Graph API

Meta erhält seine Empfangsbestätigung sofort; die Pipeline wird anschließend aus einer dauerhaften Warteschlange ausgeführt (mit Wiederholungen), wodurch die von Meta vorgegebene Antwortfrist nicht überschritten wird.

Typischer Anwendungsfall

[Start · Facebook Lead Ads]──▶[agent: qualifizieren]──▶[filter: heißer Lead?]
                                                    ├─▶[CRM-Konnektor: Datensatz anlegen]
                                                    └─▶[Versand: sofortige Nachverfolgung]

Der Agent qualifiziert den Lead anhand von lead.fields und lead.custom; deterministische Filter leiten dann qualifizierte Leads an das CRM und heiße Leads an eine sofortige Nachverfolgung per E-Mail / WhatsApp weiter.

Einschränkungen

  • Meta-Rate-Limits — die Graph API hat Rate-Limits. Planen Sie für hohe Volumina einen Puffer ein.
  • Berechtigungen (Modus eigene App) — Ihre App muss über die Berechtigung leads_retrieval verfügen, die Meta widerrufen kann, wenn die App nicht validiert ist. Folgen Sie dem App-Review-Prozess von Meta.
  • Kein rückwirkender Abruf — betool ruft keine Leads ab, die vor der Einrichtung des Webhooks eingereicht wurden. Exportieren und laden Sie diese dafür über ein einmaliges Skript.