Facebook- und Instagram-Leads an einen WhatsApp-Posteingang senden

Verbinde eine Facebook-Seite, die Lead Ads schaltet, mit einer WhatsApp-Inbox in Deskwoot. Jedes ausgefüllte Formular auf Facebook oder Instagram landet als neue Konversation in deinem Dashboard, mit allen Daten aus dem Lead-Formular. Sobald Meta den Webhook liefert, geht eine vorab genehmigte WhatsApp-Vorlage an den Lead, und das 24-Stunden-Antwortfenster öffnet sich sofort.

Was du vor dem Verbinden brauchst

• Eine Facebook-Seite, der die Lead Ads gehören.
• Eine Meta-App, bei der der Lead-Ads-Webhook auf App-Ebene abonniert ist.
• Einen Page Access Token mit diesen Berechtigungen: pages_show_list, pages_read_engagement, pages_manage_metadata, leads_retrieval. Hol dir einen langlebigen Token (60 Tage), damit du ihn nicht jede Woche erneuern musst.
• Das App Secret deiner Meta-App (Settings, Basic, App Secret).
• Eine WhatsApp-Cloud-API-Inbox, die schon in Deskwoot eingerichtet ist.
• Mindestens eine genehmigte WhatsApp-Nachrichtenvorlage im Meta Business Manager. Vorlagen können Variablen enthalten (die Platzhalter {{1}}, {{2}}, ...), und in Deskwoot ordnest du diese Variablen dem Vornamen des Leads, deinem Kontonamen, einem festen Text oder einem beliebigen Feld des Lead-Formulars zu.

Die Seite verbinden

Die Einrichtungsseite für Meta Lead Ads gibt es nur auf Englisch, deshalb stehen die Bezeichnungen hier so, wie du sie dort siehst.

1. Öffne in Deskwoot Einstellungen > Integrationen > Meta Lead Ads.
2. Trag Facebook Page ID, den langlebigen Page Access Token und das App Secret ein.
3. Wähle unter Target WhatsApp inbox die WhatsApp-Cloud-API-Inbox, in der die Konversationen landen sollen.
4. Gib den Namen deiner genehmigten Willkommensvorlage und den Sprachcode ein (z. B. lead_welcome und en_US).
5. Klicke auf Connect Page.

Deskwoot prüft deinen Page Access Token über die Graph API, um sicherzugehen, dass die Seite existiert, und ruft dann bei Meta POST /<page_id>/subscribed_apps?subscribed_fields=leadgen auf. Erst dann liefert die Seite wirklich leadgen-Webhooks. Ohne diese Freigabe pro Seite kommt über das Abonnement auf App-Ebene allein nichts an. Das übernimmt Deskwoot für dich.

Den Webhook in deiner Meta-App einrichten

Klicke nach dem Verbinden auf der Karte der verbundenen Seite auf Configure. Dort stehen zwei Werte:

• Callback URL, etwa https://deskwoot.com/api/webhooks/meta-leadgen/<your-slug>
• Verify token, eine zufällige Zeichenkette pro Seite

Trag beide in deinem Meta App Dashboard unter Webhooks, Page, Edit Subscription ein. Jede verbundene Seite bekommt ihren eigenen Slug und Verify Token. Gelangt der Token einer Seite in falsche Hände, öffnet er also keinen Webhook für eine andere Seite.

Felder des Lead-Formulars abrufen

Klicke im Konfigurationsbereich auf Discover fields. Deskwoot ruft über die Graph API /<page_id>/leadgen_forms?fields=questions ab und holt die Schlüssel aller Fragen aus allen aktiven Formularen dieser Seite. Diese Schlüssel stehen dann in den Auswahllisten für die Feldzuordnung und die Vorlagenvariablen weiter unten.

Feldzuordnung

Unter Field mapping legst du fest, welche Frage des Meta-Lead-Formulars zu welchem Kontaktfeld in Deskwoot gehört. Die Standardwerte passen meistens:

• email, EMAIL oder wie dein Formular das Feld nennt, gehört zu Email. Die E-Mail bestimmt, welcher Kontakt es ist: Deskwoot sucht oder erstellt den Kontakt zuerst anhand der E-Mail und nimmt sonst die Telefonnummer.
• full_name gehört zu Full name.
• phone_number gehört zu Phone und wird auf reine Ziffern gekürzt, bevor Deskwoot sie als WhatsApp-ID speichert.

Hat dein Formular solche Fragen, kannst du eigene Zuordnungen für Company oder Job title hinzufügen.

Vorlagenvariablen

WhatsApp-Vorlagen nutzen im Text die Platzhalter {{1}}, {{2}}, .... Jeden Platzhalter füllst du mit einer dieser Quellen:

• Lead first name: der Vorname des Leads, abgeleitet aus der Zuordnung von full_name
• Account name: der Anzeigename deines Deskwoot-Kontos
• Static text: ein fester Text
• Lead form field: ein beliebiges Feld, das du oben abgerufen hast

Leg so viele Variablenzeilen an, wie deine Vorlage erwartet, in der richtigen Reihenfolge. Für Vorlagen ohne Variablen brauchst du keine Zeile.

Was passiert, wenn ein Lead das Formular ausfüllt

1. Meta liefert einen leadgen-Webhook an die URL mit deinem Slug, signiert per HMAC x-hub-signature-256.
2. Deskwoot prüft die Signatur mit deinem App Secret und überspringt den Lead ohne Meldung, wenn sie nicht passt.
3. Deskwoot legt den Lead in einer MetaLeadAdLead-Zeile mit UNIQUE(accountId, leadgenId) an. Doppelte Webhook-Lieferungen (Meta wiederholt bis zu 7-mal über 5 Tage) scheitern an dieser Stelle und erzeugen nie eine doppelte Konversation.
4. Deskwoot ruft den vollständigen Lead über die Graph API mit GET /<leadgen_id> ab.
5. Deskwoot sucht oder erstellt den Kontakt und übernimmt die Formularfelder gemäß deiner Zuordnung.
6. Deskwoot öffnet eine neue Konversation in deiner WhatsApp-Inbox und speichert die vollständigen Formulardaten unter customAttributes.metaLeadAd.
7. Deskwoot sendet die Willkommensvorlage über die WhatsApp Cloud API. Die Nachricht landet auf dem Smartphone des Leads, öffnet das 24-Stunden-Antwortfenster, und dein Agent (oder Fynn, falls er zuständig ist) übernimmt ab hier.

Trennen

Klicke auf der Karte der Seite auf Disconnect. Deskwoot ruft bei Meta DELETE /<page_id>/subscribed_apps auf, damit keine Webhooks mehr kommen, und löscht dann die Verbindung in Deskwoot. Auch wenn Meta einen Fehler meldet (Token abgelaufen, Seite gelöscht), wird die Verbindung gelöscht, damit du nie mit einer Konfiguration festsitzt, die du nicht entfernen kannst.

Häufige Fragen