Setup

Lead Ads (Meta und LinkedIn)

Jedes Formular, das über Ihre Facebook/Instagram-Anzeigen (Meta Lead Ads) oder LinkedIn-Anzeigen (Lead Gen Forms) ausgefüllt wird, wird zu einem Lead im CRM, unter Verwendung Ihrer eigenen App (BYO-Modell).

Die Integration Lead Ads nutzt IHRE App und IHR Konto/Ihre Werbeseite (dies ist das BYO-Modell, "bring your own app"). Wenn jemand ein Lead-Formular in einer Facebook/Instagram- (Meta) oder LinkedIn-Anzeige ausfüllt, erstellt das CRM automatisch einen Lead und weist per Round-Robin einen Besitzer zu, genau wie bei der öffentlichen Formularerfassung. Die Daten kommen direkt aus Ihrem Werbekonto, ohne Vermittlung unsererseits.

Die Integration startet inaktiv: Nichts geschieht, bis Sie die Zugangsdaten eintragen und einschalten. Das App Secret und die Zugriffstoken werden verschlüsselt im CRM gespeichert und nie wieder angezeigt.

Voraussetzungen

Meta: eine App auf developers.facebook.com, eine Facebook-Seite, die die Anzeigen betreibt, sowie die Berechtigungen leads_retrieval und pages_manage_metadata; Sie benötigen das App Secret und ein langlebiges Seiten-Zugriffstoken.
LinkedIn: eine App auf linkedin.com/developers mit Zugriff auf die Lead Sync / Advertising API und ein OAuth-Zugriffstoken mit dem Scope r_marketing_leadgen_automation.
Bereits erstellte Lead-Formulare (Meta Lead Ads / LinkedIn Lead Gen Forms) in Ihren Kampagnen.
In Sellio Administratorzugriff, um die Zugangsdaten zu speichern und die Integration unter Einstellungen → Integrationen zu aktivieren.

Wie Meta funktioniert (Facebook/Instagram)

Der Meta-Webhook sendet die Formulardaten NICHT. Er sendet nur einen Identifikator (leadgen_id). Beim Empfang prüft das CRM die Ereignissignatur (HMAC-SHA256 des Bodys mit Ihrem App Secret) und HOLT dann den Lead über die Meta Graph API mit Ihrem Seiten-Zugriffstoken ab, wobei die übermittelten Felder (field_data) abgerufen werden. Diese Felder werden den Lead-Feldern zugeordnet, und der Lead wird erstellt.

Meta konfigurieren: im Meta-Dashboard

Erstellen (oder verwenden) Sie eine App auf developers.facebook.com. Kopieren Sie unter Settings → Basic das App Secret.
Fügen Sie das Produkt "Webhooks" sowie das Leadgen-Objekt/Produkt (Leads Access) hinzu. Beantragen Sie die Berechtigungen leads_retrieval und pages_manage_metadata für Ihre Seite.
Generieren Sie ein langlebiges Seiten-Zugriffstoken für die Seite, die die Anzeigen betreibt (Graph API Explorer oder Business Manager).
Halten Sie alles bereit: Sie werden das App Secret, das Seiten-Token und einen "Verifizierungstoken" (eine von Ihnen gewählte Zeichenfolge) in das CRM einfügen.

Meta konfigurieren: im CRM

Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte "Meta Lead Ads (Facebook/Instagram)".
Verify Token: Wählen Sie eine beliebige Zeichenfolge und geben Sie sie ein. Sie werden DENSELBEN Wert im Meta-Dashboard verwenden.
App Secret und Page Access Token: Fügen Sie beide ein (sie werden gemeinsam verschlüsselt gespeichert) und klicken Sie auf "Zugangsdaten speichern".
Kopieren Sie die angezeigte "Webhook-URL (Meta)".
Fügen Sie im Meta-Dashboard → Webhooks diese URL als Callback-URL und Ihr Verify Token als Verify Token ein. Meta führt einen Handshake (GET) durch, und das CRM beantwortet die Challenge, wenn der Verify Token übereinstimmt.
Abonnieren Sie das Feld "leadgen" Ihrer Seite. Kehren Sie dann zum CRM zurück und klicken Sie auf "Aktivieren".

LinkedIn konfigurieren

Erstellen Sie bei LinkedIn (Lead Gen Forms) eine App auf linkedin.com/developers, beantragen Sie die Produkte Lead Sync / Advertising API und generieren Sie ein OAuth-Zugriffstoken mit dem Lead-Gen-Scope (r_marketing_leadgen_automation). Fügen Sie im CRM auf der Karte "LinkedIn Lead Gen Forms" das Zugriffstoken (und optional die Organization URN) ein, speichern Sie und aktivieren Sie. Lassen Sie Ihre Automatisierung (oder den Abruf der Formularantworten) auf die "Eingangs-URL (LinkedIn)" zeigen und ein JSON mit den Formularfeldern senden.

Feldzuordnung

Jede Zuordnungszeile verknüpft den NAMEN eines Feldes aus dem Anzeigenformular (links) mit einem Lead-Feld (rechts, nach api_name: email, name, phone, company, title …). Sinnvolle Standardwerte sind enthalten: full_name → name, email → email, phone_number → phone, company_name → company. Fügen Sie nur Zeilen für benutzerdefinierte Felder in Ihrem Formular hinzu. Wenn das Formular first_name und last_name getrennt sendet (bei LinkedIn üblich), werden sie zum name zusammengeführt.

Example: Angenommen, Sie haben ein Meta-Formular mit full_name, email, phone_number und einem benutzerdefinierten Feld "budget". Ordnen Sie budget einem Lead-Feld zu (zum Beispiel segment). Der Rest ist bereits durch die Standardwerte zugeordnet.

💡 Die Erstellung ist idempotent: Derselbe Lead wird nicht dupliziert. Das CRM entdupliziert nach leadgen_id (Webhook-Neuzustellung) und nach E-Mail. Enthält das Formular keine E-Mail, wird der Lead ignoriert, da die E-Mail das einzige Pflichtfeld des Leads ist. Ist das Feld "company" ausgefüllt, findet oder erstellt das CRM die passende Firma und verknüpft sie.

Behandeln Sie die Webhook-URL, das App Secret und die Token als Geheimnisse. Ungültige Signaturen werden abgelehnt (401). Ohne das Page Access Token kann das CRM die Lead-Daten nicht über die Graph API abrufen, weshalb Sie das Token zusammen mit dem App Secret einfügen. Eine Einschränkung: Der native LinkedIn-Pull (Abonnieren von leadNotifications und anschließendes Abrufen der Antworten über die API) ist hier dokumentiert und kann eingebunden werden; heute empfängt die Route bereits eine normalisierte Formularantwort-Payload.

So testen Sie

Meta: Im Meta-Dashboard → Webhooks validiert der Handshake (GET) bereits den Verify Token, wenn Sie die Callback-URL speichern. Verwenden Sie dann das "Lead Ads Testing Tool" von Meta (developers.facebook.com/tools/lead-ads-testing), um einen Test-Lead über Ihr Formular zu senden.
Prüfen Sie im CRM: Ein neuer Lead sollte mit den zugeordneten Feldern erscheinen; kam eine Firma mit, wird die Firma gefunden/erstellt und verknüpft.
LinkedIn: Lösen Sie eine Formularantwort-Payload aus (oder senden Sie sie manuell) an die "Eingangs-URL (LinkedIn)" und prüfen Sie den erstellten Lead.

Fehlerbehebung

Der Meta-Handshake schlägt fehl: Der im CRM eingegebene Verify Token muss IDENTISCH mit dem Verify Token im Meta-Dashboard sein. Gleichen Sie beide an und speichern Sie.
Sie empfangen den Webhook, aber es wird kein Lead erstellt: Ohne das Page Access Token ruft das CRM die field_data nicht über die Graph API ab. Fügen Sie das Seiten-Token ZUSAMMEN mit dem App Secret ein. Bestätigen Sie die Berechtigungen leads_retrieval/pages_manage_metadata und dass Sie das Feld "leadgen" der Seite abonniert haben.
Ungültige Signatur (401): Das App Secret im CRM weicht von der Meta-App ab (die Signatur ist HMAC-SHA256 des Bodys mit dem App Secret). Fügen Sie das korrekte App Secret erneut ein.
Ein Lead ohne E-Mail wird ignoriert: Die E-Mail ist das einzige Pflichtfeld des Leads. Stellen Sie sicher, dass das Anzeigenformular ein E-Mail-Feld hat.
Felder werden nicht ausgefüllt: Überprüfen Sie die Zuordnung (Formularfeldname zu Lead-api_name). Bei LinkedIn werden first_name + last_name automatisch zum name zusammengeführt.

Open this article inside the system →