> ## 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.
# UTM tracciamento da WhatsApp a HubSpot
> Attribuite le conversazioni WhatsApp alla campagna che le ha avviate, usando i parametri UTM su annunci Click-to-WhatsApp, link click-to-chat e tracking CTWA.
Quando un cliente vi raggiunge tramite WhatsApp, la parte più preziosa del contesto è **da dove proviene**: quale annuncio Click-to-WhatsApp (CTWA) ha intercettato, quale link del sito web, quale campagna e-mail. Senza questa attribuzione, la vostra reportistica si riduce a "WhatsApp" come unica fonte. Grazie ad essa, è possibile confrontare le campagne, calcolare il ROAS degli annunci e inserire l'attribuzione corretta negli accordi HubSpot.
Questa pagina descrive i tre modelli supportati da Flowella per spostare l'attribuzione delle campagne da WhatsApp a HubSpot.
## Modello 1: annunci click-to-WhatsApp (`ctwa_clid`)
Gli annunci CTWA di Facebook e Instagram allegano un ID click (`ctwa_clid`) a ogni conversazione che originano. Meta passa questo ID nel contesto della conversazione quando l'utente tocca l'annuncio e avvia la chat, e Flowella lo inoltra a HubSpot nel record del contatto.
Flusso:
1. Il cliente vede un annuncio CTWA su Facebook o Instagram.
2. Il cliente tocca il pulsante **Invia messaggio** sull'annuncio. WhatsApp si apre con un messaggio precompilato e Meta registra lo `ctwa_clid`.
3. Il cliente invia il messaggio. Flowella riceve il messaggio in entrata con `ctwa_clid` nei metadati.
4. Flowella crea o aggiorna il contatto HubSpot con il valore `ctwa_clid` su una proprietà dedicata.
5. Flowella memorizza anche il valore `ctwa_clid` rispetto alla conversazione, in modo che gli analisti possano risalire alla spesa pubblicitaria.
L'integrazione dell'API Conversioni di Meta per inviare eventi di conversione a Facebook Ads Manager utilizza lo stesso `ctwa_clid`. Vedere [CTWA Ads](/it/campaigns/click-to-whatsapp-ads) per configurarla in modo da poter ottimizzare la spesa pubblicitaria sulle conversioni effettive, non solo sui clic.
## Pattern 2: Link click-to-chat dalle proprie pagine
Quando inserite un pulsante **Chat on WhatsApp** nel vostro sito web o nella vostra e-mail, utilizzerete un link `wa.me`. Il link supporta un parametro `text` che precompila il primo messaggio dell'utente:
```text theme={null}
https://wa.me/441234567890?text=Hi%20I%27m%20interested%20in%20%5BSPRING_LAUNCH%5D
```
Flowella può analizzare il messaggio precompilato per trovare i codici di tracciamento e scriverli in HubSpot. La convenzione che raccomandiamo è la seguente:
* Usare una **parola chiave** tra parentesi che l'utente difficilmente digiterà per sbaglio, ad esempio `[SPRING_LAUNCH]` o `[NEWSLETTER_JUL]`.
* Avvolgere la parola chiave in marcatori in modo che il parsing non sia ambiguo.
* Mantenere la parola chiave breve e leggibile, in modo che il messaggio precompilato abbia un aspetto naturale.
Il codice estratto finisce nella proprietà HubSpot del contatto `whatsapp_entry_source` (o in una proprietà personalizzata specificata in **Flowella → Impostazioni → HubSpot**).
### Generazione dei link per campagna
Uno schema pratico: nello strumento per le campagne HubSpot o nel foglio di calcolo per il marketing, creare un piccolo lookup della campagna → codice di ingresso e generare un URL `wa.me` per campagna. Utilizzate un accorciatore di URL o l'URL di tracciamento della campagna se volete un link più ordinato nelle e-mail e nelle creatività pubblicitarie.
## Schema 3: UTM per l'invio di moduli
Quando l'invio di un modulo HubSpot attiva un flusso di lavoro WhatsApp, le proprietà standard HubSpot UTM (`hs_analytics_first_url`, `hs_analytics_source`, `hs_analytics_source_data_1` ecc.) sono già presenti nel contatto. Flowella le legge tramite l'integrazione HubSpot e le visualizza nel contesto della conversazione.
Questo è lo schema più pulito quando WhatsApp è un canale di **follow-up**: il cliente è arrivato originariamente tramite un URL contrassegnato da UTM, ha inviato un modulo e Flowella attiva uno WhatsApp Flow che colma le lacune. L'attribuzione UTM viene mantenuta da un capo all'altro, senza che vi sia nulla di specifico per WhatsApp.
## Creazione di rapporti HubSpot con questi dati
Una volta che l'attribuzione è stata assegnata al contatto, è possibile creare rapporti HubSpot standard:
* **Contatti per `whatsapp_entry_source`** - quali campagne hanno portato a WhatsApp leads
* **Deals → prima fonte = WhatsApp** - ricavi attribuibili ai contatti originati da WhatsApp
* **Prestazioni del flusso di lavoro per fonte** - quali campagne hanno prodotto i tassi di risposta/conversione più elevati all'interno di WhatsApp Flow
Vedere [Reporting and dashboards](/it/hubspot/reporting-and-dashboards) per i modelli di report che consigliamo di impostare.
## Quale attribuzione scrive Flowella a HubSpot?
Per impostazione predefinita, Flowella scrive le seguenti proprietà su ogni contatto durante l'attività di WhatsApp:
| Proprietà | Tipo | Quando viene scritto |
| ----------------------------- | --------- | -------------------------------------------------------------------------- |
| `whatsapp_opted_in` | Boolean | Quando il contatto dà il consenso a WhatsApp |
| `whatsapp_first_message_at` | Timestamp | Quando Flowella vede per la prima volta un messaggio in entrata |
| `whatsapp_last_message_at` | Timestamp | Aggiornato su ogni messaggio in entrata |
| `whatsapp_entry_source` | Stringa | Il codice sorgente analizzato del primo messaggio in entrata o `ctwa_clid` |
| `whatsapp_campaign_id` | Stringa | L'ID della campagna Flowella per la conversazione, se applicabile |
| `whatsapp_template_last_sent` | Stringa | Il modello più recente inviato al contatto |
È possibile mappare ulteriori dati WhatsApp alle proprietà HubSpot personalizzate in **Flowella → Impostazioni → HubSpot → Mappatura campi**.
## Problemi comuni
Non tutti gli WhatsApp in arrivo portano con sé uno `ctwa_clid`. Solo quelli che provengono da un annuncio CTWA di Facebook/Instagram lo portano. I messaggi diretti (in cui il cliente ha digitato manualmente il vostro numero in WhatsApp) non avranno questo valore, il che è corretto: non c'è un annuncio a cui attribuirli.
Il messaggio precompilato è solo un'impostazione predefinita. Alcuni utenti lo cancellano prima dell'invio, altri lo modificano. Non fare affidamento su di esso per la logica di instradamento critica.
Per un'attribuzione solida, preferire `ctwa_clid` (che l'utente non può eliminare) al parsing del precompilato `text` (che può farlo).
Un cliente che ha fatto clic su un'inserzione Facebook CTWA martedì, non ha inviato messaggi, poi ha aperto la stessa inserzione mercoledì e ha inviato messaggi, avrà lo `ctwa_clid` del clic del mercoledì nei metadati WhatsApp. L'attribuzione standard first-touch / last-touch di HubSpot funziona ancora sugli UTM sottostanti se il cliente ha visitato il vostro sito web nel frattempo.
## Guide correlate
* [Annunci CTWA](/it/campaigns/click-to-whatsapp-ads) - configurazione completa, comprese le API di conversione
* [Reporting e dashboard](/it/hubspot/reporting-and-dashboards) - trasformare i dati di attribuzione in report
* [Azioni del flusso di lavoro](/it/hubspot/workflow-actions) - le azioni del flusso di lavoro che si attivano quando arriva un messaggio in entrata