# 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](api-access.md) 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](../get-started/list-and-contact-management.md). --- ## Ü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):** ```json { "firstName": "{{first_name}}", "lastName": "{{last_name}}", "phone": "{{phone_number}}", "email": "{{email}}" } ``` Ersetzen Sie `{{placeholders}}` durch die tatsächlichen Feldzuordnungen aus Ihrem Trigger-Schritt. ::: warning **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):** ```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](#finding-your-list-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](../get-started/list-and-contact-management.md) 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 ```json POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY { "firstName": "Jane", "lastName": "Smith", "phone": "+15551234567", "email": "jane@example.com" } ``` ### Kontakt erstellen - Antwort ```json { "success": true, "data": { "message": "Successfully created new contact", "contactId": "abc123xyz", "listsAdded": [] } } ``` ### Kontakt zur Liste hinzufügen - Anfrage ```json POST https://api.youraiconnector.com/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 - [Umstieg von Kampagnen auf Broadcasts & Agents](../moving-from-campaigns.md) — richten Sie etwas ein, um neue Leads automatisch anzuschreiben. - [API-Zugriff](api-access.md) — vollständige API-Dokumentation für fortgeschrittene Integrationen. - [Webhooks](webhooks.md) — lassen Sie sich benachrichtigen, wenn Kontakte erstellt oder mit Tags versehen werden.