Conversions API pour WhatsApp : envoyer vos ventes à Meta
Guide pratique de la Conversions API pour les ventes WhatsApp : événement Purchase, ctwa_clid, dataset, déduplication, tests, erreurs fréquentes.
Par l'équipe WaslaMis à jour le 6 min de lecture
À retenir
- La Conversions API dit à Meta qu'une conversation WhatsApp née d'une publicité a donné un achat, avec son montant.
- Pour la messagerie, l'événement utilise action_source « business_messaging » et messaging_channel « whatsapp », avec le ctwa_clid du clic.
- Un identifiant d'événement stable (event_id) évite de compter deux fois la même vente quand l'envoi est retenté.
- Testez avec le code de test du Gestionnaire d'événements avant d'envoyer de vraies ventes.
Vous lancez des publicités Click-to-WhatsApp, vos commerciaux concluent des ventes dans les conversations, et pourtant Meta n'en sait rien. Pour l'algorithme, une conversation qui finit en commande de 5 000 DH et une conversation abandonnée après « merci » se valent. Il optimise donc pour obtenir des conversations, pas des clients.
La Conversions API, souvent abrégée CAPI, corrige cela. Elle permet à votre système d'envoyer directement à Meta, de serveur à serveur, les événements qui comptent pour vous : un prospect qualifié, un achat, avec son montant. Ce guide explique comment cela fonctionne pour WhatsApp, sans jargon inutile.
Ce que fait la Conversions API, en une phrase
Elle relie un événement qui se passe chez vous, ici une vente conclue sur WhatsApp, au clic publicitaire qui l'a provoqué. Côté Meta, la vente apparaît dans le Gestionnaire d'événements et dans les rapports de vos campagnes, et elle sert de signal pour optimiser la diffusion.
Contrairement au pixel installé sur un site web, la Conversions API ne dépend ni du navigateur ni des cookies. C'est la seule façon de remonter un achat qui a lieu dans une conversation, puisqu'il n'existe aucune page de confirmation à mesurer.
Les ingrédients d'un événement d'achat WhatsApp
Pour une vente conclue dans WhatsApp, l'événement envoyé contient les champs suivants :
| Champ | Valeur | Rôle |
|---|---|---|
| event_name | Purchase | Le type d'événement : un achat |
| event_time | Horodatage Unix | Le moment de la vente |
| event_id | Identifiant unique | Évite les doublons en cas de nouvel envoi |
| action_source | business_messaging | L'événement vient d'une messagerie |
| messaging_channel | Le canal concerné | |
| user_data.ctwa_clid | Identifiant du clic | Relie la vente à la publicité cliquée |
| user_data.whatsapp_business_account_id | Identifiant du compte | Identifie votre compte WhatsApp Business |
| custom_data.value et currency | 1200 et MAD | Le montant et la devise |
Le ctwa_clid est la pièce maîtresse. Il arrive dans le premier message du client, à l'intérieur de l'objet referral, quand celui-ci a cliqué sur une publicité. S'il n'est pas enregistré à ce moment-là, la vente ne pourra plus jamais être reliée à la publicité.
Le dataset : là où arrivent les événements
Les événements sont envoyés à un dataset, l'équivalent d'un pixel pour les données hors site. Pour WhatsApp, Meta permet de récupérer ou de créer le dataset associé à votre compte WhatsApp Business. Cela se fait une seule fois, pendant la configuration.
Étape par étape : de « Vendu » jusqu'à Meta
- Le client clique sur votre publicité et écrit. Le referral et le ctwa_clid sont enregistrés sur la conversation.
- La discussion avance. Votre commercial conclut la vente et clique « Vendu » avec le montant encaissé.
- Votre système crée un événement Purchase avec un identifiant unique et le place dans une file d'envoi.
- Un envoi automatique transmet l'événement à Meta. En cas d'erreur temporaire, il réessaie plus tard, avec un délai croissant.
- Meta rattache l'achat au clic. Il apparaît dans vos rapports et nourrit l'optimisation de vos campagnes.
La file d'envoi compte beaucoup : les serveurs de Meta, comme tous les serveurs, refusent parfois une requête. Sans file ni nouvel essai, des ventes disparaissent en silence et vos chiffres deviennent faux sans que personne ne s'en aperçoive.
Éviter les doublons et les erreurs de montant
Une vente ne doit être comptée qu'une fois. Si l'envoi échoue puis repart, Meta reconnaît l'événement grâce à son event_id et ne le compte pas deux fois. Utilisez toujours un identifiant stable, par exemple l'identifiant de la vente dans votre base, jamais un nombre aléatoire généré à chaque essai.
Pour le montant, envoyez la valeur réellement encaissée, dans la devise de votre compte publicitaire. Si vous vendez en euros à des clients européens alors que votre compte est en dirhams, convertissez au taux du jour de la vente et figez ce taux : vos rapports restent cohérents même si le taux bouge ensuite.
Aller plus loin que l'achat
L'achat est le signal le plus fort, mais il arrive tard. Vous pouvez aussi envoyer des étapes intermédiaires :
- LeadSubmitted, quand un client venu d'une publicité envoie son premier message ;
- QualifiedLead, quand la conversation passe en négociation : le client a un vrai projet ;
- Purchase, quand la vente est conclue.
Ces événements intermédiaires donnent à Meta plus de signaux, plus tôt. Ils aident surtout les campagnes à petit budget, qui ne génèrent que quelques ventes par semaine.
Tester avant de passer en réel
Le Gestionnaire d'événements fournit un code de test. Tant que ce code accompagne les envois, les événements apparaissent dans l'onglet de test et ne comptent pas dans vos rapports. Faites une vente fictive, vérifiez que l'événement arrive avec le bon montant et la bonne devise, puis retirez le code.
Surveillez aussi la part d'achats sans ctwa_clid. Si elle est élevée, soit les clients ne viennent pas de vos publicités, soit le referral n'est pas enregistré au premier message.
Ce que Wasla fait pour vous
Dans Wasla, tout ce circuit est automatique. Le referral et le ctwa_clid sont enregistrés dès le premier message, le bouton « Vendu » crée l'événement Purchase avec un identifiant unique, une file d'envoi réessaie en cas d'erreur, et les échecs définitifs s'affichent dans vos réglages. Les ventes sans publicité d'origine ne sont pas envoyées, pour ne pas brouiller vos signaux.
Questions fréquentes
Faut-il un site web pour utiliser la Conversions API ?
Non. Pour les ventes WhatsApp, l'événement part de serveur à serveur avec le ctwa_clid. Aucun pixel ni site n'est nécessaire.
Combien de temps après la vente faut-il envoyer l'événement ?
Le plus tôt possible. Meta accepte des événements envoyés quelques jours après, mais un signal rapide est bien plus utile à l'optimisation.
Et si le client n'est pas venu d'une publicité ?
Sans ctwa_clid, Meta ne peut pas relier la vente à un clic. Mieux vaut ne pas l'envoyer comme achat publicitaire : elle reste dans votre chiffre d'affaires, pas dans le ROI des campagnes.
La Conversions API respecte-t-elle la vie privée des clients ?
Pour WhatsApp, l'événement transporte un identifiant de clic et l'identifiant de votre compte, pas le nom ni les messages du client. Mentionnez quand même ce partage dans votre politique de confidentialité.