Verfolgen, welche Facebook- oder Instagram-Anzeige einen WhatsApp-Chat ausgelöst hat

Welche Facebook- oder Instagram-Anzeige einen WhatsApp-Chat ausgelöst hat, erfasst Deskwoot automatisch: Jede Click-to-WhatsApp-Anzeige schickt die Referral-Daten von Meta mit der ersten Nachricht in deine Inbox, und Deskwoot speichert den vollständigen Anzeigenkontext an der Konversation und am Kontakt. Über die API kannst du die Daten abrufen.

Was erfasst wird

Jedes Mal, wenn jemand auf eine Click-to-WhatsApp-Anzeige klickt und die erste Nachricht schickt, hängt Meta ein referral-Objekt an den eingehenden Webhook. Deskwoot speichert alles davon an der Konversation:

• Quelltyp. Entweder ad oder post, je nachdem, ob der Klick von einer bezahlten Anzeige oder vom Button „Nachricht senden“ in einem Facebook- oder Instagram-Beitrag kam.
• Anzeigen- oder Beitrags-ID. Das Meta-Objekt, das den Klick ausgelöst hat. Damit kannst du Konversationen in deinen Auswertungen nach Anzeige gruppieren.
• Klick-ID (ctwa_clid). Die Kennung des einzelnen Klicks, die du mit deinen Meta-Ads-Berichten abgleichen und an die Conversions API zurückgeben kannst.
• Überschrift und Text. Der genaue Anzeigentext, den die Person beim Klick gesehen hat.
• Quell-URL. Ein direkter Link zur Anzeige oder zum Beitrag auf Facebook.
• Medientyp mit Bild- oder Video-URL. Das Motiv, das die Person beim Klicken gesehen hat.

Wo du die Daten in Deskwoot findest

Öffne eine WhatsApp-Konversation. Rechts in den Details erscheint eine grüne Karte Kam von WhatsApp-Ad, wenn die Konversation mit einer Click-to-WhatsApp-Anzeige begonnen hat. Klickt dieselbe Person auf eine weitere Anzeige, während ihre Konversation noch offen ist, ersetzt die neue Zuordnung die sichtbare Karte. Die vorherige bleibt unter conversation.customAttributes.whatsappReferralHistory gespeichert.

Das jüngste Referral wird außerdem am Kontakt unter customAttributes.lastWhatsappReferral gespeichert, damit die Zuordnung auch für spätere Konversationen derselben Person erhalten bleibt.

Abruf über die API

Die Daten stehen an den normalen Endpunkten für Konversationen und Kontakte unter customAttributes. Für den Abruf über die API brauchst du einen API-Token, und den kannst du nur im Enterprise-Tarif erstellen:

GET /api/v1/conversations/<id>
{
  "id": "...",
  "customAttributes": {
    "whatsappReferral": {
      "sourceUrl": "https://fb.me/2abc123def",
      "sourceId": "120203456789012345",
      "sourceType": "ad",
      "headline": "Patch Video Ad",
      "body": "Get our new patch with 30% off this week",
      "ctwaClid": "AAabcdEFGHijklMNOPqrstUVWxyz1234567890",
      "capturedAt": "2026-05-01T19:39:41Z"
    }
  }
}

Die Daten an dein CRM oder deine Anzeigenplattform senden

Die ausgehenden Webhooks von Deskwoot (Einstellungen > Webhooks) enthalten die Anzeigendaten nicht. Ereignisse wie Konversation aktualisiert oder Konversation gelöst liefern die ID der Konversation. Mit dieser ID liest du die Konversation wie oben gezeigt über die API und gibst customAttributes.whatsappReferral (Klick-ID und Anzeigen-ID) an HubSpot, Pipedrive, Notion, Google Sheets oder zurück an die Conversions API von Meta weiter, damit Meta deine Anzeigen anhand echter Ergebnisse optimieren kann.

Grenzen, die du kennen solltest

• Meta hängt das referral-Objekt nur an die allererste Nachricht einer Sitzung, die von einer Anzeige ausging. Deskwoot liest es bei der ersten Nachricht aus und speichert es dauerhaft. Spätere Nachrichten in derselben Konversation tragen es nicht.
• Konversationen, die nicht über eine Anzeige begonnen haben (organische Chats, eigene Nachrichten, Link-Klicks ohne Bezug zu einer Anzeige), zeigen die Karte nicht. Das ist richtig so, denn es gibt nichts zuzuordnen.
• Die Funktion braucht den Kanal WhatsApp Cloud API. WhatsApp über Twilio liefert diese Daten nicht.
• Die Anzeigenkarte in den Details der Konversation gibt es ab dem Business-Tarif. Für den Abruf über die API brauchst du den Enterprise-Tarif.

Häufige Fragen