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

Verbinde eine Facebook-Seite, die Lead Ads schaltet, mit einem WhatsApp-Posteingang in Deskwoot. Jede ausgefuellte Form auf Facebook oder Instagram landet als neue Konversation in deinem Dashboard, mit den vollstaendigen Daten des Lead-Formulars im Anhang, und eine vorab genehmigte WhatsApp-Vorlagennachricht geht in dem Moment raus, in dem Meta den Webhook liefert. So oeffnet sich das 24-Stunden-Antwortfenster des Kunden sofort.

Was du vor dem Verbinden brauchst

• Eine Facebook-Seite, der die Lead Ads gehoeren.
• Eine Meta-App, bei der der Lead-Ads-Webhook auf App-Ebene abonniert ist.
• Ein Page Access Token mit diesen Berechtigungen: pages_show_list, pages_read_engagement, pages_manage_metadata, leads_retrieval. Hole dir einen langlebigen Token (60 Tage), damit du ihn nicht woechentlich erneuern musst.
• Das Meta App Secret (Settings, Basic, App Secret in deiner Meta-App).
• Einen WhatsApp-Cloud-API-Posteingang, der bereits in Deskwoot eingerichtet ist.
• Mindestens eine genehmigte WhatsApp-Nachrichtenvorlage im Meta Business Manager. Vorlagen koennen Variablen enthalten (die Platzhalter {{1}}, {{2}}, ...), und unsere Einstellungsoberflaeche laesst dich diese Variablen dem Vornamen des Leads, deinem Kontonamen, einem festen Text oder einem beliebigen Feld des Lead-Formulars zuordnen.

Die Seite verbinden

1. Gehe in Deskwoot zu Einstellungen, Integrationen, Meta Lead Ads.
2. Fuege die Page ID, den langlebigen Page Access Token und das App Secret ein.
3. Waehle den WhatsApp-Cloud-API-Posteingang, in dem die Konversationen landen sollen.
4. Gib den Namen deiner genehmigten Willkommensvorlage und den Sprachcode ein (z. B. lead_welcome + en_US).
5. Klicke auf Seite verbinden.

Wir pruefen deinen Page Access Token gegen die Graph API, um zu bestaetigen, dass die Seite existiert, und rufen dann auf Metas Seite POST /<page_id>/subscribed_apps?subscribed_fields=leadgen auf, damit die Seite tatsaechlich beginnt, leadgen-Webhooks zu liefern. Ohne diese Freigabe pro Seite liefert das Abonnement auf App-Ebene allein nichts. Das uebernehmen wir fuer dich.

Den Webhook in deiner Meta-App konfigurieren

Klicke nach dem Verbinden auf der Karte der verbundenen Seite auf Konfigurieren. Es erscheinen zwei Werte:

• Callback-URL wie https://deskwoot.com/api/webhooks/meta-leadgen/<your-slug>
• Verify-Token, eine zufaellige Zeichenkette pro Seite

Fuege beides in dein Meta App Dashboard ein, unter Webhooks, Page, Edit Subscription. Jede verbundene Seite erhaelt ihren eigenen Slug und Verify-Token, sodass ein Leck bei einer Seite niemals einen Webhook fuer eine andere Seite autorisiert.

Felder des Lead-Formulars ermitteln

Klicke im Konfigurationsbereich auf Felder ermitteln. Wir rufen Graph /<page_id>/leadgen_forms?fields=questions auf und ziehen jeden Frage-Schluessel aus jedem aktiven Formular dieser Seite. Diese Schluessel werden zu den Auswahloptionen in den Auswahlmenues fuer die Feldzuordnung und die Vorlagenvariablen weiter unten.

Feldzuordnung

Sag uns, welche Frage des Meta-Lead-Formulars welchem Deskwoot-Kontaktfeld entspricht. Die Standardwerte sind sinnvoll gewaehlt:

• email, EMAIL oder wie auch immer dein Formular es nennt, wird der E-Mail zugeordnet. Die E-Mail bestimmt die Kontaktidentitaet (wir suchen oder erstellen zuerst anhand der E-Mail und greifen ansonsten auf die Telefonnummer zurueck).
• full_name wird dem vollstaendigen Namen zugeordnet
• phone_number wird dem Telefon zugeordnet, normalisiert auf reine Ziffern, bevor es als WhatsApp-ID gespeichert wird.

Du kannst eigene Zuordnungen fuer Unternehmen oder Position hinzufuegen, falls dein Formular diese Fragen enthaelt.

Vorlagenvariablen

WhatsApp-Vorlagen verwenden im Text die Platzhalter {{1}}, {{2}}, .... Die Variablenauswahl laesst dich jeden Platzhalter fuellen mit:

• Vorname des Leads, abgeleitet aus der Zuordnung von full_name
• Kontoname, dem Anzeigenamen deines Deskwoot-Kontos
• Festem Text, einer woertlichen Zeichenkette
• Feld des Lead-Formulars, einem beliebigen Feldschluessel, den wir oben ermittelt haben

Fuege so viele Variablenzeilen hinzu, wie deine Vorlage erwartet, in der richtigen Reihenfolge. Null Zeilen sind fuer Vorlagen ohne Variablen gueltig.

Was passiert, wenn ein Lead das Formular ausfuellt

1. Meta liefert einen leadgen-Webhook an deine slug-spezifische URL, mit HMAC x-hub-signature-256.
2. Wir pruefen die Signatur gegen dein App Secret und ueberspringen den Lead stillschweigend, wenn sie nicht passt.
3. Wir beanspruchen den Lead in einer MetaLeadAdLead-Zeile mit UNIQUE(accountId, leadgenId). Doppelte Webhook-Lieferungen (Meta wiederholt bis zu 7-mal ueber 5 Tage) verlieren hier das Rennen und erzeugen niemals eine doppelte Konversation.
4. Wir rufen den vollstaendigen Lead ueber Graph GET /<leadgen_id> ab.
5. Wir suchen oder erstellen den Kontakt und ordnen die Formularfelder gemaess deiner Konfiguration zu.
6. Wir oeffnen eine neue Konversation in deinem WhatsApp-Posteingang mit den vollstaendigen Formulardaten unter customAttributes.metaLeadAd.
7. Wir senden die Willkommensvorlage ueber die WhatsApp Cloud API. Die Nachricht landet auf dem Telefon des Leads, oeffnet das 24-Stunden-Antwortfenster, und dein Agent (oder Fynn, falls er der Zustaendige ist) uebernimmt ab da.

Trennen

Klicke auf der Karte der Seite auf Trennen. Wir rufen bei Meta DELETE /<page_id>/subscribed_apps auf, um weitere Webhook-Lieferungen zu stoppen, und entfernen dann die lokale Zeile. Selbst wenn Meta einen Fehler zurueckgibt (Token abgelaufen, Seite geloescht), entfernen wir die lokale Zeile trotzdem, damit du nie mit einer Konfiguration festsitzt, die du nicht entfernen kannst.