> ## 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.
# Seguimiento UTM de WhatsApp a HubSpot
> Atribuye las conversaciones de WhatsApp a la campaña que las inició usando parámetros UTM en anuncios Click-to-WhatsApp, enlaces click-to-chat y el tracking CTWA.
Cuando un cliente llega a usted a través de WhatsApp, el contexto más valioso es **de dónde viene**: qué anuncio de Click-to-WhatsApp (CTWA) ha pulsado, qué enlace web, qué campaña de correo electrónico. Sin esa atribución, sus informes se reducen a "WhatsApp" como fuente única. Con ella, puede comparar campañas, calcular el ROAS de los anuncios e introducir la atribución adecuada en las ofertas de HubSpot.
Esta página cubre los tres patrones compatibles con Flowella para trasladar la atribución de campañas de WhatsApp a HubSpot.
## Patrón 1: Hacer clic en anuncios de WhatsApp (`ctwa_clid`)
Los anuncios CTWA de Facebook e Instagram adjuntan un ID de clic (`ctwa_clid`) a cada conversación que originan. Meta pasa este ID al contexto de la conversación cuando el usuario pulsa el anuncio e inicia el chat, y Flowella lo reenvía a HubSpot en el registro del contacto.
Flujo:
1. El cliente ve un anuncio de CTWA en Facebook o Instagram.
2. 2. El cliente pulsa el botón **Enviar mensaje** del anuncio. WhatsApp se abre con un mensaje pre-rellenado y Meta graba el `ctwa_clid`.
3. El cliente envía el mensaje. Flowella recibe el mensaje entrante con `ctwa_clid` en los metadatos.
4. Flowella crea o actualiza el contacto HubSpot con el valor `ctwa_clid` en una propiedad dedicada.
5. 5. Flowella también almacena `ctwa_clid` en la conversación para que los análisis puedan volver a unirse al gasto publicitario.
La integración de la API de conversiones de Meta para enviar eventos de conversión a Facebook Ads Manager utiliza el mismo `ctwa_clid`. Consulta [CTWA Ads](/es/campaigns/click-to-whatsapp-ads) para configurarlo y optimizar el gasto publicitario en función de las conversiones reales, no sólo de los clics.
## Patrón 2: Enlaces click-to-chat desde sus propias páginas
Cuando ponga un botón **Chat on WhatsApp** en su página web o correo electrónico, utilizará un enlace `wa.me`. El enlace admite un parámetro `text` que rellena previamente el primer mensaje del usuario:
```text theme={null}
https://wa.me/441234567890?text=Hi%20I%27m%20interested%20in%20%5BSPRING_LAUNCH%5D
```
Flowella puede analizar el mensaje precargado en busca de códigos de seguimiento y escribirlos en HubSpot. La convención que recomendamos:
* Utilice una **palabra clave entre corchetes** que el usuario probablemente no escriba por accidente, por ejemplo, `[SPRING_LAUNCH]` o `[NEWSLETTER_JUL]`.
* Envuelva la palabra clave en marcadores para que el análisis sintáctico no sea ambiguo.
* Mantén la palabra clave corta y legible para que el mensaje rellenado parezca natural.
El código extraído se almacena en la propiedad `whatsapp_entry_source` del contacto HubSpot (o en una propiedad personalizada que especifique en **Flowella → Configuración → HubSpot**).
### Generación de enlaces por campaña
Un patrón práctico: en su herramienta de campaña HubSpot u hoja de cálculo de marketing, construya una pequeña búsqueda de campaña → código de entrada, y genere una URL `wa.me` por campaña. Utilice un acortador de URL o la URL de seguimiento de la campaña si desea un enlace más ordenado en el correo electrónico y los creativos publicitarios.
## Patrón 3: UTM de envío de formularios
Cuando el envío de un formulario HubSpot desencadena un flujo de trabajo WhatsApp, las propiedades HubSpot UTM estándar (`hs_analytics_first_url`, `hs_analytics_source`, `hs_analytics_source_data_1`, etc.) ya están en el contacto. Flowella las lee a través de la integración HubSpot y las muestra en el contexto de la conversación.
Este es el patrón más limpio cuando WhatsApp es un canal de **seguimiento**: el cliente llegó originalmente a través de una URL etiquetada con UTM, envió un formulario y Flowella activa un WhatsApp Flow que rellena los huecos. La atribución UTM se mantiene de principio a fin sin nada específico para WhatsApp.
## Creación de informes HubSpot a partir de estos datos
Una vez que la atribución recae en el contacto, puede crear informes HubSpot estándar a partir de ella:
* **Contactos por `whatsapp_entry_source`** - qué campañas generaron contactos WhatsApp
* Ofertas → primera fuente = WhatsApp\*\* - ingresos atribuibles a contactos originados por WhatsApp
* Rendimiento del flujo de trabajo por fuente\*\* - qué campañas produjeron las mayores tasas de respuesta/conversión dentro de WhatsApp Flow
Consulte [Informes y cuadros de mando](/es/hubspot/reporting-and-dashboards) para ver los patrones de informes que recomendamos configurar.
## ¿Qué atribución escribe Flowella a HubSpot?
Por defecto, Flowella escribe las siguientes propiedades en cada contacto durante la actividad de WhatsApp:
\| Propiedad Tipo Cuándo se escribe
\| --- | --- | --- |
\| `whatsapp_opted_in` Booleano Cuando el contacto da su consentimiento a WhatsApp
\| Cuando Flowella ve por primera vez un mensaje entrante.
\| `whatsapp_last_message_at` | Timestamp | Se actualiza en cada mensaje entrante | `whatsapp_entry_source` | Timestamp | Cuando Flowella ve un mensaje entrante por primera vez
\| `whatsapp_entry_source` Cadena del código fuente del primer mensaje entrante o `ctwa_clid`
\| `whatsapp_campaign_id` | Cadena | ID de campaña Flowella para la conversación, si procede | `whatsapp_template_last_sent` | Cadena | Actualizada en cada mensaje entrante
\| `whatsapp_template_last_sent` Cadena La plantilla más reciente enviada al contacto.
Puede asignar datos adicionales de WhatsApp a propiedades personalizadas de HubSpot en **Flowella → Configuración → HubSpot → Asignación de campos**.
## Problemas comunes
No todos los WhatsApp entrantes llevan un `ctwa_clid`. Sólo los que proceden de un anuncio CTWA de Facebook/Instagram lo llevan. Los mensajes directos (en los que el cliente teclea tu número en WhatsApp manualmente) no tendrán este valor, lo cual es correcto: no hay ningún anuncio al que atribuirlos.
El mensaje pre-rellenado es sólo un valor por defecto. Algunos usuarios lo borran antes de enviarlo, otros lo editan. No confíes en él para la lógica de enrutamiento crítica.
Para una atribución robusta, prefiera `ctwa_clid` (que el usuario no puede eliminar) a `text` pre-fill parsing (que sí puede).
Un cliente que hizo clic en un anuncio CTWA de Facebook el martes, no envió ningún mensaje y, a continuación, abrió el mismo anuncio el miércoles y envió un mensaje, tendrá el `ctwa_clid` del clic del miércoles en los metadatos WhatsApp. La atribución estándar de primer contacto/último contacto de HubSpot sigue funcionando en las UTM subyacentes si el cliente también visitó su sitio Web entre medias.
## Guías relacionadas
* [CTWA Ads](/es/campaigns/click-to-whatsapp-ads) - configuración completa, incluida la API de conversiones
* [Reporting and dashboards](/es/hubspot/reporting-and-dashboards) - convertir datos de atribución en informes
* [Acciones de flujo de trabajo](/es/hubspot/workflow-actions) - las acciones de flujo de trabajo que se activan cuando llega un mensaje entrante