Savoir quelle publicité Facebook ou Instagram a lancé un chat WhatsApp

Dans Deskwoot, savoir quelle publicité Facebook ou Instagram a lancé un chat WhatsApp se fait automatiquement : chaque publicité Click-to-WhatsApp envoie les données de provenance de Meta dans votre boîte de réception avec le premier message, et Deskwoot enregistre tout le contexte de la publicité sur la conversation, sur le contact et via l'API.

Les données enregistrées

Chaque fois qu'un visiteur clique sur une publicité Click-to-WhatsApp et envoie son premier message, Meta ajoute un objet referral au webhook entrant. Nous enregistrons l'objet complet sur la conversation :

• Type de source. Soit ad, soit post, selon que le clic vient d'une publicité payante ou d'un bouton « Envoyer un message » sur une publication Facebook ou Instagram.
• ID de la publicité ou de la publication. L'objet Meta à l'origine du clic, pratique pour regrouper les conversations par publicité dans vos rapports.
• ID du clic (ctwa_clid). L'identifiant propre à chaque clic, que vous pouvez rapprocher de vos rapports Meta Ads et renvoyer à l'API Conversions.
• Titre et texte. Le texte exact de la publicité que le visiteur a vu au moment du clic.
• URL source. Un lien direct vers la publicité ou la publication sur Facebook.
• Type de média et URL de l'image ou de la vidéo. Le visuel que le visiteur regardait au moment du clic.

Où le trouver dans Deskwoot

Ouvrez n'importe quelle conversation WhatsApp. Le panneau d'informations à droite affiche une carte verte Provient d'une publicité WhatsApp dès que la conversation a commencé par une publicité Click-to-WhatsApp. Si la même personne clique sur une autre publicité alors que sa conversation est encore ouverte, la nouvelle attribution remplace la carte affichée et la précédente est conservée dans conversation.customAttributes.whatsappReferralHistory.

La provenance la plus récente est aussi copiée sur le contact, dans customAttributes.lastWhatsappReferral, pour que l'attribution reste disponible pour toute future conversation de la même personne.

Récupérer les données par l'API

Les données sont disponibles sur les endpoints habituels des conversations et des contacts, dans customAttributes. Pour les lire par l'API, il faut un jeton d'API, que seul le forfait Enterprise peut créer :

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"
    }
  }
}

Envoyer les données vers votre CRM ou votre plateforme publicitaire

Les webhooks sortants de Deskwoot (Paramètres > Webhooks) n'incluent pas les données de la publicité. Les événements comme Conversation mise à jour ou Conversation résolue contiennent l'ID de la conversation. Utilisez cet ID pour lire la conversation par l'API comme ci-dessus, puis envoyez customAttributes.whatsappReferral (ID du clic et ID de la publicité) vers HubSpot, Pipedrive, Notion, Google Sheets ou de nouveau vers l'API Conversions de Meta pour optimiser vos campagnes en boucle fermée.

Limites à connaître

• Meta n'ajoute l'objet referral qu'au tout premier message d'une session lancée par une publicité. Nous le récupérons sur le premier message et le conservons. Les messages suivants de la même conversation ne le contiennent pas.
• Les conversations qui n'ont pas commencé par une publicité (chats organiques, réponses manuelles, clics sur des liens qui ne viennent pas d'une publicité) n'affichent pas la carte. C'est normal, car il n'y a rien à attribuer.
• La fonctionnalité nécessite le canal WhatsApp Cloud API. WhatsApp via Twilio ne fournit pas les mêmes données.
• La carte de la publicité dans les détails de la conversation est incluse à partir du forfait Business. Pour lire les données par l'API, il faut le forfait Enterprise.

Questions fréquentes