> ## 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. # Tracciamento UTM e CTWA: ctwa_clid da WhatsApp a HubSpot > Attribuite le chat WhatsApp agli annunci Click-to-WhatsApp con l'ID clic di referral ctwa_clid di Meta, oltre ai codici dei link wa.me e alle proprietà UTM di HubSpot in Flowella. 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 **Click-to-WhatsApp (CTWA)** di Facebook e Instagram allegano un ID clic, il campo webhook di Meta **`ctwa_clid`**, quando un utente apre WhatsApp dall'annuncio. Flowella acquisisce quel payload di referral sul primo messaggio in entrata, lo memorizza sulla conversazione e sul contatto e può scriverlo in HubSpot per report e workflow. ### Cosa invia Meta nel webhook in entrata Nei webhook **messages** della Cloud API (ad esempio i messaggi di testo), le chat originate da CTWA includono un oggetto `referral`. Meta documenta questi campi (i nomi sono esatti): | Campo | Significato | | - | - | | **`ctwa_clid`** | ID clic dell'annuncio Click to WhatsApp (univoco per ogni tocco sull'annuncio) | | `source_id` | ID dell'annuncio | | `source_type` | In genere `ad` | | `source_url` | URL Facebook / Instagram dell'annuncio | | `body` / `headline` | Testo principale e titolo dell'annuncio, se presenti | | `media_type` / URL di immagini o video | Metadati dei media creativi | | `welcome_message.text` | Testo di benvenuto dell'annuncio, se configurato | Riferimento ufficiale: [Text messages webhook — Click to WhatsApp ad](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/text) (il parametro `` corrisponde a `ctwa_clid`). Meta **omette** completamente `referral.ctwa_clid` per i messaggi che provengono da un posizionamento pubblicitario in **WhatsApp Status**. Altri campi di referral possono comunque essere presenti. Non date per scontato che ogni conversazione CTWA abbia un ID clic. ### Flowella → HubSpot Flusso: 1. Il cliente vede un annuncio CTWA su Facebook o Instagram. 2. Il cliente tocca **Invia messaggio**. WhatsApp si apre; Meta registra il clic. 3. Il cliente invia il primo messaggio. Flowella riceve il webhook in entrata con l'oggetto `referral`. 4. Flowella memorizza `ctwa_clid`, l'ID dell'annuncio e l'URL della fonte sulla conversazione e sul contatto. 5. Al completamento di un WhatsApp Flow, Flowella scrive le proprietà del contatto HubSpot in modo che elenchi, report e workflow possano utilizzarle immediatamente. | Proprietà HubSpot | Fonte | | - | - | | `flowella_ctwa_clid` | `referral.ctwa_clid` | | `flowella_ad_id` | `referral.source_id` | | `flowella_ad_source_url` | `referral.source_url` | | `flowella_entry_point` | Ingresso classificato (ad esempio `ad`) | Se configurate l'attribuzione degli annunci su un punto di ingresso CTWA, Flowella può anche inviare a Meta un evento `Lead` della Conversions API per ID clic (`action_source: business_messaging`, `messaging_channel: whatsapp`, con `user_data.ctwa_clid`). Vedere [Punti di ingresso CTWA](/it/app/entry-points#ctwa-entry-points). La Conversions API for Business Messaging di Meta utilizza lo stesso `ctwa_clid` per attribuire l'evento all'annuncio. Gli eventi devono essere inviati entro la finestra di conversione di Meta (documentata come 7 giorni dal clic). Vedere [CTWA Ads](/it/campaigns/click-to-whatsapp-ads) per la configurazione lato annuncio. Le campagne rivolte all'Europa possono mostrare metriche di messaggistica vuote in Ads Manager anche quando l'attribuzione in HubSpot è corretta: la reportistica first-party di HubSpot funziona comunque. Potete anche utilizzare i trigger dei workflow Flowella come **Modulo completato** o **Risposta testuale** nelle [azioni dei workflow HubSpot](/it/hubspot/workflow-actions) una volta che il contatto ha queste proprietà. ## 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: non c'è un annuncio a cui attribuirli. Meta omette inoltre `ctwa_clid` per i posizionamenti pubblicitari in **WhatsApp Status**, anche quando sono presenti altri campi `referral`. 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 * [Punti di ingresso](/it/app/entry-points) - attribuzione degli annunci CTWA e configurazione della Conversions API * [Annunci CTWA](/it/campaigns/click-to-whatsapp-ads) - configurazione lato annuncio in Meta Ads Manager * [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 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.