Your AI Connector Docs

Facebook-Lead-Formulare

Schalten Sie Facebook-Anzeigen, um Leads zu gewinnen? Diese Integration sendet diese Leads automatisch an Your AI Connector, damit Sie sie per WhatsApp, SMS oder über einen anderen verbundenen Kanal kontaktieren können – ganz ohne manuellen Aufwand.

Dies funktioniert, indem Facebook Lead Ads über eine Automatisierungsplattform (wie Pabbly, Zapier oder Make) mit Your AI Connector verbunden werden. Diese Plattformen fungieren als Brücke zwischen Facebook und Your AI Connector und übertragen Lead-Informationen mithilfe der API (einer Methode, mit der verschiedene Softwareanwendungen automatisch Daten austauschen) von einem zum anderen.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

  • Facebook Ads Manager-Zugriff mit Berechtigung zum Erstellen von Lead Ads.
  • Ein Konto mit einem aktiven API-Schlüssel (generieren Sie einen unter Einstellungen → Integrationen → API-Schlüssel – siehe API-Zugriff für die genauen Schritte).
  • Ein Konto bei einer Automatisierungsplattform – Pabbly Connect, Zapier oder Make (Integromat). Diese Anleitung verwendet Pabbly als Beispiel, aber die Schritte sind auf jeder Plattform ähnlich.
  • Eine Kontaktliste in Your AI Connector, in der neue Leads hinzugefügt werden – siehe Listen & Kontakte organisieren.

Übersicht

Die Integration funktioniert in drei Phasen:

  1. Ein Interessent füllt Ihr Facebook-Lead-Formular aus.
  2. Ihre Automatisierungsplattform erkennt den neuen Lead und sendet die Informationen automatisch an Your AI Connector (unter Verwendung von zwei API-Aufrufen).
  3. Your AI Connector erstellt den Kontakt und fügt ihn der von Ihnen angegebenen Liste hinzu.

Von dort aus übernimmt ein Broadcast, eine Kampagne oder ein von Ihnen zugewiesener KI-Agent den Rest – sei es eine KI-gestützte Willkommensnachricht, eine Drip-Sequenz oder eine manuelle Nachverfolgung.

Schritt 1: Erstellen Sie Ihr Facebook-Lead-Formular

  1. Öffnen Sie den Facebook Ads Manager.
  2. Erstellen Sie eine neue Kampagne mit dem Ziel Leads.
  3. Wählen Sie auf Anzeigenebene Instant-Formular als Lead-Methode aus.
  4. Erstellen Sie Ihr Formular mit den benötigten Feldern. Fügen Sie mindestens Folgendes hinzu:
    • Vorname
    • Telefonnummer (mit Ländervorwahl)
    • Optional: Nachname, E-Mail
  5. Veröffentlichen Sie die Anzeige oder speichern Sie das Formular als Entwurf zum Testen.

Schritt 2: Testen Sie das Lead-Formular

Bevor Sie die Automatisierung verbinden, senden Sie einen Test-Lead ab:

  1. Gehen Sie im Ads Manager zu Ihrem Lead-Formular.
  2. Klicken Sie auf Vorschau und füllen Sie das Formular mit Testdaten aus.
  3. Bestätigen Sie, dass der Test-Lead in Ihrem Facebook Lead Center erscheint (unter Veröffentlichungstools auf Ihrer Facebook-Seite oder im Ads Manager unter „Leads“).

Dieser Testeintrag wird verwendet, um die Feldzuordnung in Ihrer Automatisierungsplattform einzurichten.

Schritt 3: Richten Sie die Automatisierung ein

Facebook Lead Ads als Trigger verbinden

  1. Melden Sie sich bei Ihrer Automatisierungsplattform an (Pabbly, Zapier oder Make).
  2. Erstellen Sie einen neuen Workflow / ein neues Szenario / einen neuen Zap.
  3. Setzen Sie den Trigger auf “Facebook Lead Ads - New Lead”.
  4. Verbinden Sie Ihr Facebook-Konto und wählen Sie die Seite sowie das Lead-Formular aus.
  5. Rufen Sie den Test-Lead ab, um die Verbindung zu bestätigen und die Felder zuzuordnen.

API-Aufruf 1 konfigurieren: Kontakt erstellen

Fügen Sie einen Aktionsschritt mit einer HTTP- / Webhook- / API-Anfrage hinzu:

  • Methode: POST
  • URL: https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
  • Header:
    Content-Type: application/json
  • Body (JSON):
    {
  "firstName": "{{first_name}}",
  "lastName": "{{last_name}}",
  "phone": "{{phone_number}}",
  "email": "{{email}}"
}

Ersetzen Sie {{placeholders}} durch die tatsächlichen Feldzuordnungen aus Ihrem Trigger-Schritt.

Wichtig: Die Telefonnummer muss die Landesvorwahl enthalten (zum Beispiel +1 für die USA oder +31 für die Niederlande). Wenn Ihr Lead-Formular die Telefonnummer ohne Landesvorwahl erfasst, fügen Sie in Ihrer Automatisierung einen Formatierungsschritt hinzu, um diese voranzustellen.

Die API-Antwort gibt die ID des neuen Kontakts unter data.contactId zurück. Speichern Sie diesen Wert – Sie benötigen ihn für den nächsten Schritt.

Sie können den zweiten Aufruf überspringen. POST /v1/contacts akzeptiert im Erstellungskörper auch listId (eine Liste) oder listIds (mehrere), wodurch der neue Kontakt in derselben Anfrage zu diesen Listen hinzugefügt wird. Verwenden Sie die unten stehende zweistufige Version nur, wenn Ihre Automatisierungsplattform erfordert, dass der Kontakt bereits existiert, bevor entschieden wird, welche Liste verwendet werden soll.

API-Aufruf 2 konfigurieren: Kontakt zur Liste hinzufügen

Fügen Sie einen zweiten Aktionsschritt hinzu:

  • Methode: POST
  • URL: https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
  • Header:
    Content-Type: application/json
  • Body (JSON):
    {
  "contactId": "{{contact_id_from_previous_step}}",
  "listId": "YOUR_LIST_ID"
}

Ersetzen Sie YOUR_LIST_ID durch die tatsächliche ID Ihrer Kontaktliste (siehe Finden Ihrer Listen-ID unten) und ordnen Sie contactId der data.contactId zu, die vom ersten API-Aufruf zurückgegeben wurde.

Ihre Listen-ID finden

  1. Klicken Sie in Your AI Connector auf Kontakte und dann auf den Reiter Listen.
  2. Öffnen Sie das Zeilenmenü (“⋯”) neben der gewünschten Liste und klicken Sie auf Listen-ID kopieren.

Siehe Listen & Kontakte organisieren für die vollständige Anleitung zur Listen-Seite.

Schritt 4: Testen des vollständigen Workflows

  1. Senden Sie einen weiteren Test-Lead über Ihr Facebook-Formular (oder wiederholen Sie den bestehenden Test-Lead in Ihrer Automatisierungsplattform).
  2. Überprüfen Sie Your AI Connector, um Folgendes zu bestätigen:
    • Der Kontakt wurde mit dem korrekten Namen, der Telefonnummer und der E-Mail-Adresse erstellt.
    • Der Kontakt wurde der richtigen Liste hinzugefügt.
  3. Wenn Sie einen Broadcast, eine Kampagne oder einen KI-Agenten so eingestellt haben, dass diese Liste automatisch angeschrieben wird, bestätigen Sie, dass dies wie erwartet ausgelöst wird.

Datenreferenz

Nachfolgend finden Sie Beispiele für die Daten, die während der Integration gesendet und empfangen werden.

Kontakt erstellen - Anfrage 

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts?apiKey=YOUR_API_KEY

{
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "+15551234567",
  "email": "jane@example.com"
}

Kontakt erstellen - Antwort 

{
  "success": true,
  "data": {
    "message": "Successfully created new contact",
    "contactId": "abc123xyz",
    "listsAdded": []
  }
}

Kontakt zur Liste hinzufügen - Anfrage 

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts/lists?apiKey=YOUR_API_KEY

{
  "contactId": "abc123xyz",
  "listId": "LIST_ID"
}

Tipps

  • Umgang mit Duplikaten: Wenn bereits ein Kontakt mit derselben Telefonnummer existiert, gibt der Erstellungsaufruf {"success": false, "error_code": 409} zurück und liefert nicht den bestehenden Kontakt. Verzweigen Sie bei error_code (der HTTP-Status ist 200) und suchen Sie den Kontakt mit GET /v1/contacts?phoneNumber=..., bevor der Aufruf zum Hinzufügen zur Liste erfolgt.
  • Mehrere Formulare: Erstellen Sie separate Automatisierungsworkflows für verschiedene Lead-Formulare, die jeweils auf eine andere Liste und eine andere Aussendung, Kampagne oder einen anderen KI-Agenten abzielen.
  • Fehlerbenachrichtigungen: Konfigurieren Sie Ihre Automatisierungsplattform so, dass Sie benachrichtigt werden, wenn ein API-Aufruf fehlschlägt, damit Ihnen keine Leads verloren gehen.

Nächste Schritte