Quelqu'un clique sur votre publicité Click-to-WhatsApp dans Meta et vous écrit. Whatsable ne crée pas la publicité. Le premier message entrant contient le clic et la publicité, c'est-à-dire le referral, pour que vous puissiez les enregistrer. Cette page sert de carte : où arrive ce referral, à quoi correspond chaque champ et pourquoi conserver vous-même ctwa_clid et source_id avant que les messages suivants du même chat ne les perdent.
Non. Une publicité Click-to-WhatsApp se diffuse dans Meta Ads. Whatsable ne crée pas la publicité.
Whatsable transmet le referral du premier message entrant, au premier niveau sur n8n, Zapier, Make et un webhook que vous avez créé. Vous conservez vous-même ctwa_clid et source_id, car les messages suivants du même chat les omettent généralement. Whatsable ne les conserve pas pour vous.
Les publicités Status peuvent aussi envoyer un referral ; ctwa_clid peut être absent.
Voici le déroulé, du début à la fin :
Whatsable
incoming: true à la création.referral à cette URL par POST.C'est la même boucle pour toutes les destinations. Les détails de l'endroit où vous le dirigez varient légèrement selon l'outil :
Dans le tableau de bord Whatsable, ouvrez Développeur, ajoutez une URL d'endpoint et activez les messages entrants. Le premier message entrant Click-to-WhatsApp envoie le referral à cette URL par POST. Voir https://whatsable.app/integrations/webhook
n8n reçoit le même referral du premier message entrant. Mappez le referral de premier niveau sur ce message, conservez ctwa_clid et source_id, et écrivez-les dans une feuille de calcul ou un CRM. Documentation de configuration : https://whatsable.app/integrations/n8n
Zapier reçoit le même referral du premier message entrant. Mappez le referral de premier niveau et conservez vous-même ctwa_clid et source_id. Documentation : https://whatsable.app/integrations/zapier
Make reçoit le même referral du premier message entrant. Mappez le referral de premier niveau et conservez vous-même ctwa_clid et source_id. Documentation : https://whatsable.app/integrations/make
Une Agent Skill Whatsable n'est pas un événement distinct. Elle voit le même payload de webhook, referral compris, seulement si elle s'appuie sur un webhook que vous avez créé. Installer une Skill seule ne transmet pas le referral. Voir https://whatsable.app/vibe-code
Oui sur le premier message entrant. Généralement absent ensuite.
| Quand | Présent / absent |
|---|---|
| Premier message entrant après un clic sur une publicité/un post CTWA | Oui en général |
| Messages suivants, même chat | Généralement absent. Conservez immédiatement |
| Chat ordinaire | Absent |
| Publicités WhatsApp Status | Referral parfois présent ; ctwa_clid parfois absent |
referral de premier niveau dans le payload Whatsable (ou messages[].referral de la Cloud API si c'est l'enveloppe que vous recevez).
| Champ | Signification en clair | Présent / absent |
|---|---|---|
referral | Conteneur pour l'attribution CTWA/post. | Premier message entrant CTWA/post ; absent des chats ordinaires et de la plupart des relances |
referral.source_type | ad ou post. | Avec referral |
referral.source_id | ID de la publicité ou du post Meta. | Avec referral. Conservez |
referral.source_url | URL de la publicité ou du post. | Avec referral |
referral.headline | Titre de la publicité ou du post. | Avec referral |
referral.body | Texte du corps de la publicité ou du post. | Avec referral |
referral.media_type | image ou video. | Avec referral |
referral.image_url | URL du visuel image. | Quand media_type vaut image (les URL peuvent expirer) |
referral.video_url | URL du visuel vidéo. | Quand media_type vaut video |
referral.thumbnail_url | URL de la miniature vidéo. | Visuels vidéo |
referral.ctwa_clid | ID de clic pour Meta CAPI. | Généralement avec le referral de la publicité ; parfois absent pour Status. Conservez |
referral.welcome_message | Objet facultatif. Message de bienvenue quand Meta l'inclut. | Facultatif. Inclus uniquement quand Meta l'envoie avec le clic sur la publicité. |
ctwa_clid et source_id ?C'est à vous de le faire. Whatsable transmet le referral du premier message entrant. Vous conservez vous-même ctwa_clid et source_id, car les messages suivants du même chat les omettent généralement. Whatsable ne les conserve pas pour le client.
Les publicités Status peuvent aussi envoyer un referral ; ctwa_clid peut être absent. Cela reste un referral.
Écrivez ces champs dans une feuille de calcul ou un CRM, puis identifiez quel visuel et quelle plateforme ont généré le prospect WhatsApp.
Le premier message entrant arrive dans n8n, Zapier, Make ou un webhook que vous avez créé. Vous conservez vous-même source_id sur le contact : la prochaine personne qui ouvre le chat voit quelle publicité Meta l'a lancé.
Le même premier message entrant ajoute ctwa_clid et source_id. Vous les conservez vous-même, puis vous regroupez la semaine par publicité.
Ads Manager a vu le clic. WhatsApp a vu le chat. Le referral du premier message entrant fait le lien, à condition de l'avoir conservé.