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

Zu verfolgen, welche Facebook- oder Instagram-Anzeige einen WhatsApp-Chat ausgelöst hat, läuft in Deskwoot automatisch: Jede Click-to-WhatsApp-Anzeige sendet die Referral-Daten von Meta mit der ersten Nachricht in dein Postfach, und Deskwoot speichert den vollständigen Anzeigenkontext am Gespräch, am Kontakt und über die API.

Was erfasst wird

Jedes Mal, wenn ein Besucher auf eine Click-to-WhatsApp-Anzeige klickt und seine erste Nachricht sendet, hängt Meta ein referral-Objekt an den eingehenden Webhook an. Wir speichern das Ganze am Gespräch:

Quelltyp. Entweder ad oder post, je nachdem, ob der Klick von einer bezahlten Anzeige oder einem "Nachricht senden"-CTA auf einem Facebook- oder Instagram-Beitrag kam.
Anzeigen- oder Beitrags-ID. Das Meta-Objekt, das den Klick ausgelöst hat, nützlich, um Gespräche in deinen Berichten nach Anzeige zu gruppieren.
Klick-ID (ctwa_clid). Die Kennung pro Klick, die du mit deinen Meta-Ads-Berichten abgleichen und in die Conversions API zurückspeisen kannst.
Überschrift und Text. Der genaue Anzeigentext, den der Besucher im Moment des Klicks gesehen hat.
Quell-URL. Ein direkter Link zurück zur Anzeige oder zum Beitrag auf Facebook.
Medientyp plus Bild- oder Video-URL. Das Creative, das sich der Besucher beim Klicken angesehen hat.

Wo du es in Deskwoot findest

Öffne ein beliebiges WhatsApp-Gespräch. Das Infofenster auf der rechten Seite zeigt eine grüne Karte Kam von WhatsApp-Anzeige, wann immer das Gespräch von einer Click-to-WhatsApp-Anzeige ausging. Wenn dieselbe Person auf eine weitere Anzeige klickt, während ihr Gespräch noch offen ist, ersetzt die neue Attribution die sichtbare Karte, und die vorherige wird unter conversation.customAttributes.whatsappReferralHistory aufbewahrt.

Das jüngste Referral wird außerdem am Kontakt unter customAttributes.lastWhatsappReferral gespiegelt, sodass die Attribution für jedes künftige Gespräch derselben Person erhalten bleibt.

Abruf über die API

Die Daten werden an den Standard-Endpunkten für Gespräch und Kontakt unter customAttributes bereitgestellt:

GET /api/v1/accounts/<accountId>/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

Richte unter Einstellungen, Webhooks, Neu ein Webhook-Abonnement ein und wähle das Ereignis conversation.created. Jede Nutzlast trägt nun dieselbe Struktur customAttributes.whatsappReferral, sodass du die Klick-ID und die Anzeigen-ID in HubSpot, Pipedrive, Notion, Google Sheets oder zurück in die Conversions API von Meta für eine geschlossene Optimierung leiten kannst.

Grenzen, die du kennen solltest

Meta hängt das referral-Objekt nur an die allererste Nachricht einer Sitzung an, die von einer Anzeige ausging. Wir greifen es bei der ersten Nachricht ab und speichern es dauerhaft. Spätere Nachrichten im selben Gespräch tragen es nicht.
Gespräche, die nicht von einer Anzeige ausgingen (organische Chats, manuelle Antworten, Link-Klicks ohne Bezug zu einer Anzeige), zeigen die Karte nicht. Das ist korrektes Verhalten, da es nichts zuzuordnen gibt.
Die Funktion erfordert den Kanal WhatsApp Cloud API. WhatsApp über Twilio stellt dieselbe Nutzlast nicht bereit.