Lead-Quellen — Einrichtungsanleitung
LeadHub kann Leads aus 19 verschiedenen Quellen empfangen. Die meisten Quellen funktionieren über einen Webhook — Sie fügen eine von LeadHub generierte URL in die externe Plattform ein und Leads fließen automatisch ein.
Wie jede Webhook-basierte Quelle funktioniert
- Gehen Sie zu Integrationen → Lead-Quellen und erstellen Sie eine neue Verbindung.
- Wählen Sie den Quellentyp und konfigurieren Sie Feldzuordnungen.
- Kopieren Sie die generierte Eingehende Webhook-URL.
- Fügen Sie die URL in die externe Plattform ein.
- Testen Sie durch Einreichen eines Test-Leads — er erscheint innerhalb von Sekunden in Ihrem Workspace.
Facebook Lead Ads (Meta)
Mit Facebook Lead Ads können Nutzer ein Formular direkt in Facebook/Instagram absenden, ohne die App zu verlassen.
Meta bietet unter CRM-Integration auf Lead-Formularen die Option Andere nicht mehr an, sodass eine Webhook-URL nicht mehr auf Formularebene eingefügt werden kann. Verbinden Sie stattdessen über OAuth und einen Webhook auf App-Ebene, wie unten beschrieben.
Schritt 1 — Meta App konfigurieren
Erstellen (oder öffnen) Sie eine App vom Typ Business auf developers.facebook.com:
-
Fügen Sie das Produkt Facebook Login hinzu.
-
App Settings → Basic → App Domains: Fügen Sie Ihre LeadHub-Domain hinzu (z. B.
crm.example.com). -
Facebook Login → Settings → Valid OAuth Redirect URIs: Fügen Sie Folgendes hinzu:
https://YOUR-DOMAIN/oauth/meta/callbackDies muss exakt mit der
APP_URLIhrer Installation übereinstimmen, einschließlichhttps.
Das Hinzufügen der Domain und der Redirect-URI behebt auch den Fehler "Can't load URL. The domain of this URL isn't included in the app's domains."
Schritt 2 — In LeadHub verbinden
- Gehen Sie zu Lead-Quellen-Verbindungen und fügen Sie eine Meta-Verbindung hinzu.
- Geben Sie Ihre App ID und Ihr App Secret ein.
- Klicken Sie auf Über OAuth verbinden, genehmigen Sie die angeforderten Berechtigungen und wählen Sie Ihre Seite aus.
- LeadHub speichert den Page Access Token automatisch in der Verbindung.
Schritt 3 — Leadgen-Webhook einrichten (Meta-App-Ebene)
Dies ersetzt die entfernte Option Andere auf Formularebene:
- Wählen Sie im App Dashboard → Webhooks das Objekt Page aus.
- Abonnieren Sie das Feld
leadgen. - Callback URL und Verify Token: Kopieren Sie beides aus dem Meta-Verbindungsbildschirm in LeadHub.
- Abonnieren Sie Ihre Seite.
Neue Leads fließen nun automatisch ein — Meta sendet jeden Lead per POST an den Webhook, und LeadHub ruft die vollständigen Lead-Details über die Graph API mit Ihrem Page Access Token ab.
Berechtigungen & App Review
Die OAuth-Verbindung fordert folgende Scopes an: leads_retrieval, pages_show_list, pages_read_engagement, pages_manage_ads.
Diese Berechtigungen erfordern Meta App Review + Business-Verifizierung, bevor sie für andere Konten als die Admins, Entwickler oder Tester der App selbst funktionieren.
Um vor der Genehmigung zu testen, haben Sie zwei Möglichkeiten:
- Fügen Sie sich selbst als Admin / Entwickler / Tester in der Meta App hinzu, oder
- Fügen Sie einen Page Access Token (generiert im Graph API Explorer von Meta mit
leads_retrieval) in das Feld Page Access Token der Verbindung ein — LeadHub liest Leads damit direkt aus.
Beispiel für Feldzuordnung
| Facebook-Feld | LeadHub-Feld |
|---|---|
full_name | first_name |
email | email |
phone_number | phone |
Alternativ können Sie Zapier oder n8n als Brücke verwenden, wenn Sie mehr Kontrolle über die Nutzlast benötigen.
Instagram Leads
Teilt dieselbe Meta Ads-Infrastruktur wie Facebook Lead Ads. Führen Sie dieselben Schritte durch.
TikTok Lead Generation
- Verbindung erstellen: Typ → TikTok Lead Generation → URL kopieren.
- TikTok Ads Manager → Assets → Lead Generation → Webhook → Webhook erstellen → URL einfügen.
LinkedIn Lead Gen Forms
- Verbindung erstellen: Typ → LinkedIn Lead Gen Forms → URL kopieren.
- LinkedIn Campaign Manager → Konto-Assets → Lead Gen Forms → Integrationen → Webhook-URL einfügen.
WhatsApp Business
- Verbindung erstellen: Typ → WhatsApp Business → URL kopieren.
- Meta Business → WhatsApp → Konfiguration → Webhooks → Callback-URL setzen.
Telegram
- Telegram-Bot über @BotFather erstellen → Bot-Token kopieren.
- Verbindung erstellen: Typ → Telegram → Bot-Token eingeben.
- LeadHub registriert den Webhook automatisch.
Viber
- Viber Business Account bei partners.viber.com erstellen → Bot-Token holen.
- Verbindung erstellen: Typ → Viber → Bot-Token eingeben.
Twitter / X
Über Zapier: Trigger → Twitter → Neue Direktnachricht → Action → Webhooks by Zapier → POST an Ihre LeadHub-Webhook-URL.
Snapchat Lead Ads
- Verbindung erstellen: Typ → Snapchat Lead Ads → URL kopieren.
- Snapchat Ads Manager → Snap Pixel & APIs → Lead Webhook → URL einfügen.
Google Ads Lead Form Extensions
- Verbindung erstellen: Typ → Google Ads Lead Forms → URL kopieren.
- Google Ads → Lead Form Extension → Bearbeiten → Webhook-Integration → URL einfügen.
Typeform
- Verbindung erstellen: Typ → Typeform → URL kopieren.
- Typeform → Ihr Formular → Verbinden → Webhooks → Webhook hinzufügen → URL einfügen.
JotForm
- Verbindung erstellen: Typ → JotForm → URL kopieren.
- JotForm → Ihr Formular → Einstellungen → Integrationen → Webhooks → URL einfügen.
Calendly
- Verbindung erstellen: Typ → Calendly → URL kopieren.
- Calendly → Integrationen → Webhooks → Neuer Webhook → URL einfügen → invitee.created-Ereignis auswählen.
E-Mail (IMAP)
- Dedizierte E-Mail-Adresse für Lead-Erfassung erstellen.
- Verbindung erstellen: Typ → E-Mail (IMAP) → IMAP-Zugangsdaten eingeben.
- LeadHub fragt den Posteingang alle 5 Minuten ab.
Manuelle Eingabe
Leads direkt in LeadHub erstellen: Leads → Alle Leads → Neuer Lead.
Generischer Webhook (Beliebige Plattform)
Für jede nicht aufgelistete Plattform Generischer Webhook-Verbindungstyp verwenden. Akzeptiert jede JSON-Nutzlast mit Feldzuordnungskonfiguration.
curl -X POST https://yourdomain.com/inbound/YOURTOKEN \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]","first_name":"Test","last_name":"Lead"}'