> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Suivi UTM de WhatsApp vers HubSpot
> Attribuez les conversations WhatsApp à la campagne d'origine grâce aux paramètres UTM sur les publicités Click-to-WhatsApp, liens click-to-chat et CTWA.
Lorsqu'un client vous rejoint via WhatsApp, l'élément de contexte le plus précieux est **l'endroit d'où il vient** : quelle annonce Click-to-WhatsApp (CTWA) il a consulté, quel lien de site web, quelle campagne d'emailing. Sans cette attribution, votre rapport se résume à "WhatsApp" en tant que source unique. Grâce à elle, vous pouvez comparer les campagnes, calculer le ROAS des publicités et introduire l'attribution appropriée dans les transactions HubSpot.
Cette page présente les trois modèles supportés par Flowella pour transférer l'attribution d'une campagne de WhatsApp à HubSpot.
## Schéma 1 : Cliquez sur les annonces WhatsApp (`ctwa_clid`)
Les publicités CTWA de Facebook et Instagram attachent un identifiant de clic (`ctwa_clid`) à chaque conversation dont elles sont à l'origine. Meta transmet cet identifiant dans le contexte de la conversation lorsque l'utilisateur clique sur la publicité et démarre le chat, et Flowella le transmet à HubSpot dans la fiche de contact.
Flux :
1. Le client voit une publicité CTWA sur Facebook ou Instagram.
2. Le client appuie sur le bouton **Envoyer un message** de la publicité. WhatsApp s'ouvre avec un message pré-rempli et Meta enregistre le `ctwa_clid`.
3. Le client envoie le message. Flowella reçoit le message entrant avec `ctwa_clid` dans les métadonnées.
4. Flowella crée ou met à jour le contact HubSpot avec la valeur `ctwa_clid` sur une propriété dédiée.
5. Flowella stocke également la valeur `ctwa_clid` dans la conversation afin que les analystes puissent remonter jusqu'aux dépenses publicitaires.
L'intégration de l'API Conversions de Meta pour renvoyer les événements de conversion vers Facebook Ads Manager utilise le même `ctwa_clid`. Voir [CTWA Ads](/fr/campaigns/click-to-whatsapp-ads) pour le paramétrage afin d'optimiser les dépenses publicitaires sur les conversions réelles, et pas seulement sur les clics.
## Modèle 2 : Liens Click-to-chat à partir de vos propres pages
Lorsque vous placez un bouton **Chat sur WhatsApp** sur votre site web ou dans votre e-mail, vous utilisez un lien `wa.me`. Ce lien prend en charge un paramètre `text` qui pré-remplit le premier message de l'utilisateur :
```text theme={null}
https://wa.me/441234567890?text=Hi%20I%27m%20interested%20in%20%5BSPRING_LAUNCH%5D
```
Flowella peut analyser le message pré-rempli pour y trouver des codes de suivi et les écrire dans HubSpot. La convention que nous recommandons :
* Utilisez un **mot-clé entre crochets** que l'utilisateur ne risque pas de taper par accident, par exemple `[SPRING_LAUNCH]` ou `[NEWSLETTER_JUL]`.
* Entourez le mot-clé de marqueurs afin que l'analyse ne soit pas ambiguë.
* Veillez à ce que le mot-clé soit court et lisible par l'homme afin que le message prérempli reste naturel.
Le code extrait est placé dans la propriété `whatsapp_entry_source` du contact HubSpot (ou dans une propriété personnalisée que vous spécifiez dans **Flowella → Paramètres → HubSpot**).
### Générer les liens par campagne
Un modèle pratique : dans votre outil de campagne HubSpot ou votre feuille de calcul marketing, créez une petite recherche de campagne → code d'entrée, et générez une URL `wa.me` par campagne. Utilisez un raccourcisseur d'URL ou l'URL de suivi de la campagne si vous souhaitez un lien plus clair sur les courriels et les créations publicitaires.
## Modèle 3 : UTM de soumission de formulaire
Lorsqu'une soumission de formulaire HubSpot déclenche un workflow WhatsApp, les propriétés standard HubSpot UTM (`hs_analytics_first_url`, `hs_analytics_source`, `hs_analytics_source_data_1` etc.) sont déjà présentes sur le contact. Flowella les lit via l'intégration de HubSpot et les affiche dans le contexte de la conversation.
C'est le schéma le plus clair lorsque WhatsApp est un canal de **suivi** : le client est arrivé à l'origine via une URL étiquetée UTM, a soumis un formulaire, et Flowella déclenche un WhatsApp Flow qui comble les lacunes. L'attribution du UTM est préservée d'un bout à l'autre sans rien de spécifique au WhatsApp.
## Création de rapports HubSpot à partir de ces données
Une fois que l'attribution a été attribuée au contact, vous pouvez créer des rapports HubSpot standard à partir de ces données :
* **Contacts par `whatsapp_entry_source`** - quelles campagnes ont généré des leads WhatsApp
* **Distributions → première source = WhatsApp** - revenus attribuables aux contacts provenant de WhatsApp
* Performance du flux de travail par source\*\* - quelles campagnes ont produit les taux de réponse/conversion les plus élevés dans le WhatsApp Flow
Consultez [Rapports et tableaux de bord](/fr/hubspot/reporting-and-dashboards) pour connaître les modèles de rapports que nous vous recommandons de mettre en place.
## Quelle attribution Flowella écrit-elle à HubSpot ?
Par défaut, Flowella écrit les propriétés suivantes sur chaque contact pendant l'activité de WhatsApp :
| Propriété | Type | Date d'écriture | | |
| ----------------------------- | -------------------- | ------------------------------------------------------------- | --------------------------- | -------------------- |
| `whatsapp_opted_in` | Booléen | Lorsque le contact donne son consentement WhatsApp | `whatsapp_first_message_at` | Booléen |
| `whatsapp_first_message_at` | Horodatage | Quand Flowella voit pour la première fois un message entrant | | |
| `whatsapp_last_message_at` | Horodatage | Mise à jour à chaque message entrant | | |
| `whatsapp_entry_source` | Chaîne de caractères | Code source du premier message entrant ou `ctwa_clid` | `whatsapp_campaign_id` | Chaîne de caractères |
| `whatsapp_campaign_id` | String | ID de campagne Flowella pour la conversation, le cas échéant. | | |
| `whatsapp_template_last_sent` | Chaîne de caractères | Le modèle le plus récent envoyé au contact | | |
Vous pouvez associer d'autres données WhatsApp à des propriétés HubSpot personnalisées dans **Flowella → Settings → HubSpot → Field mapping**.
## Problèmes courants
Tous les WhatsApp entrants ne sont pas accompagnés d'un `ctwa_clid`. Seuls ceux qui proviennent d'une publicité CTWA sur Facebook/Instagram en ont un. Les messages directs (où le client a tapé manuellement votre numéro dans WhatsApp) n'auront pas cette valeur, ce qui est correct - il n'y a pas de publicité à laquelle les attribuer.
Le message prérempli n'est qu'un message par défaut. Certains utilisateurs le suppriment avant de l'envoyer, d'autres le modifient. Ne vous y fiez pas pour la logique de routage critique.
Pour une attribution solide, préférez `ctwa_clid` (que l'utilisateur ne peut pas supprimer) à l'analyse du message prérempli `text` (qu'il peut supprimer).
Un client qui a cliqué sur une publicité CTWA de Facebook le mardi, n'a pas envoyé de message, puis a ouvert la même publicité le mercredi et a envoyé un message, aura le `ctwa_clid` du clic du mercredi dans les métadonnées WhatsApp. L'attribution standard first-touch / last-touch de HubSpot fonctionne toujours sur les UTMs sous-jacents si le client a également visité votre site web entre-temps.
## Guides connexes
* [CTWA Ads](/fr/campaigns/click-to-whatsapp-ads) - configuration complète incluant l'API Conversions
* [Rapports et tableaux de bord](/fr/hubspot/reporting-and-dashboards) - transformer les données d'attribution en rapports
* [Workflow Actions](/fr/hubspot/workflow-actions) - les actions de workflow qui se déclenchent à l'arrivée d'un message entrant.