betool betool

Dokumentation

Meta Lead Ads

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

Meta Lead Ads

Der Kanal Meta Lead Ads verbindet Ihre Facebook-Business-App 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 vollständig automatisiert werden.

Voraussetzungen

  • Eine Meta-Anwendung (Facebook for Developers) mit der Berechtigung leads_retrieval.
  • Eine für Lead Ads freigegebene Facebook-Seite.
  • Mindestens ein aktives Lead-Ad-Formular.

Einrichtung

  1. Administration → Meta → Anwendungen — verbinden Sie Ihre Meta-App mit ihrer App ID und ihrem App Secret.
  2. Fügen Sie auf Meta-Developers-Seite den von betool bereitgestellten Webhook am page-Objekt mit dem Feld leadgen hinzu.
  3. Wählen Sie die relevante(n) Seite(n) aus und autorisieren Sie die App.
  4. Ordnen Sie auf betool-Seite jedes Formular einer Ziel-Pipeline zu.

Was die Pipeline erhält

Für jeden eingereichten Lead wird ein exchange erstellt mit:

  • lead.full_name, lead.email, lead.phone — Standardfelder (normalisiert)
  • lead.form_fields — alle Formularfragen mit ihren Antworten
  • lead.form_id, lead.ad_id, lead.campaign_id — zur Attribution
  • lead.created_time — Meta-Zeitstempel (UTC)

Typischer Anwendungsfall

[facebook_leads]──▶[agent: anreichern]──▶[condition: Qualität]
                                           ├─▶[operator: CRM anlegen]
                                           └─▶[agent: sofortige Nachverfolgung]

Der Anreicherungs-Agent ruft ein Werkzeug zur E-Mail-Verifizierung + einen HTTP-Operator auf, um Ihre Verlaufsdatenbank abzufragen. Die Bedingung leitet qualifizierte Leads an das CRM und heiße Leads an eine sofortige WhatsApp-/E-Mail-Antwort weiter.

Einschränkungen

  • Meta-Rate-Limits — die API hat Rate-Limits. Planen Sie für hohe Volumina einen Puffer ein.
  • Berechtigungen — Meta kann die Berechtigung leads_retrieval widerrufen, wenn Ihre 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.