# Atribución de anuncios de "Clic a WhatsApp" Si ejecutas anuncios de "Clic a WhatsApp" en Meta (Facebook/Instagram), Your AI Connector puede decirte de qué anuncio proviene cada cliente potencial de WhatsApp, y entregarte el identificador de clic de Meta que necesitas para reportar conversiones reales a Meta. Esto permite que tus campañas publicitarias se optimicen para ventas y reservas reales, no solo para "personas que iniciaron un chat". --- ## Qué se captura Cuando alguien toca un anuncio de Clic a WhatsApp y envía un mensaje a tu empresa, Meta adjunta información de referencia oculta a ese primer mensaje. Your AI Connector la lee automáticamente y la almacena en el contacto. Sin configuración ni ajustes, simplemente sucede. La información capturada se almacena en el contacto como `ad_referral` y contiene: | Campo | Qué es | |---|---| | `ctwa_clid` | El identificador de clic de Meta. Este es el valor que envías a la API de Conversiones de Meta para atribuir una conversión posterior al clic exacto del anuncio. Vacío para referencias de publicaciones orgánicas (ver más abajo). | | `source_id` | El ID del anuncio (o publicación) en el que hizo clic la persona. | | `source_type` | Ya sea `ad` (un anuncio pagado de "Clic a WhatsApp") o `post` (una publicación orgánica de Facebook/Instagram). | | `source_url` | El enlace asociado con el contenido del anuncio. | | `headline` | El texto del titular del anuncio. | | `body` | El texto del cuerpo del anuncio. | | `channel` | El canal por el que llegó la referencia (actualmente siempre `whatsapp`). | | `captured_at` | Cuándo se registró por primera vez la referencia en el contacto. | Puedes ver esto en el [panel de vista rápida](../get-started/creating-contacts.md) de un contacto si has configurado un campo personalizado para ello, o leerlo directamente a través de webhooks y la API (consulta a continuación); no aparece como su propio campo etiquetado en la tabla de Contactos. > **Una cosa que la carga útil no le indica:** a cuál de sus números llegó la conversación. No contiene ningún id de página ni id de cuenta de WhatsApp Business. Con un solo número, esto no importa; si utiliza varios números en diferentes páginas de Facebook, deberá asignar eso por su cuenta. --- ## Con qué conexión funciona esto > Esto funciona **solo con la conexión oficial de la API de WhatsApp.** Meta solo entrega la información de referencia estructurada (incluyendo `ctwa_clid`) a través de la API oficial de WhatsApp Business. La **conexión no oficial de WhatsApp (web) no la recibe**; no hay datos de clics de anuncios disponibles en esa conexión, debido al diseño de cómo funciona. Por lo tanto, si la atribución de anuncios de ciclo cerrado es importante para ti, ejecuta tus campañas de "Clic a WhatsApp" a través de un número conectado mediante la API oficial de WhatsApp. --- ## Comportamiento del primer contacto La referencia se captura en el **primer** mensaje que un contacto envía desde un anuncio. Si el mismo contacto hace clic más tarde en un anuncio diferente y ese nuevo clic lleva un identificador de clic, el `ad_referral` almacenado se actualiza para que el ID de clic se mantenga vigente para los informes. Las referencias de publicaciones orgánicas (que no tienen `ctwa_clid`) nunca sobrescriben un ID de clic de anuncio pagado capturado previamente. --- ## Cómo llevar los datos a Meta o Google Ads Your AI Connector captura los datos de atribución y los expone, pero actualmente **no** envía conversiones a Meta o Google por ti de forma nativa. Debes reenviar los datos utilizando webhooks y una herramienta de automatización. El objeto `ad_referral` se incluye en la sección `contact` de los eventos de [webhook](webhooks.md) salientes (por ejemplo, Nuevo mensaje, Contacto reanudado, Etiquetas de contacto actualizadas y eventos de análisis como Cita reservada). Una configuración típica de ciclo cerrado: 1. Un cliente potencial hace clic en tu anuncio de Clic a WhatsApp y te envía un mensaje. Your AI Connector registra `ad_referral` (incluyendo `ctwa_clid`) en el contacto. 2. A medida que el cliente potencial avanza (reservó una llamada, se convirtió en cliente, se perdió), marcas ese resultado (consulta "Cómo llevar la etapa del embudo" a continuación). 3. Se activa un webhook hacia tu herramienta de automatización (Zapier, Make o Pabbly) que lleva tanto el resultado como el `ctwa_clid` del contacto. 4. Tu herramienta de automatización llama a la API de Conversiones de Meta (usando `action_source = business_messaging` y el `ctwa_clid`) o a Google Ads (Importación de conversiones sin conexión / Conversiones mejoradas para clientes potenciales) para reportar la conversión. De esta manera, Meta y Google aprenden qué anuncios produjeron resultados reales y se optimizan en función de ellos. --- ## Cómo llevar la etapa del embudo Para informar de una conversión, normalmente necesita dos cosas: el ID de clic (capturado automáticamente) y el resultado (que usted establece). La forma más fiable de adjuntar un resultado es mediante **etiquetas**, ya que al aplicar una etiqueta se activa el webhook `contact_tags_updated`, y esa carga útil incluye el `ad_referral` del contacto. (Eliminar una etiqueta no lo activa; consulte [Contact Tags Updated](webhooks.md#contact-tags-updated-webhook).) Puedes aplicar etiquetas automáticamente: - Deja que tu agente de IA etiquete al contacto durante la conversación: configura reglas de etiquetado automático en la configuración del agente. Así es como funciona el patrón "una página de destino por anuncio → un mensaje de entrada → una etiqueta" si deseas etiquetar la fuente tú mismo. - O etiqueta manualmente desde Chats o la página de Contactos. Siempre que una etiqueta relevante cambia, el webhook se dispara con el ID de clic adjunto, listo para ser enviado como una conversión. La URL del webhook se establece en la propia etiqueta, en la pestaña **Etiquetas** del agente (o campaña) al que pertenece el contacto, no en Configuración. Cada etiqueta obtiene su propia URL, y todas pueden apuntar al mismo endpoint si desea un único lugar para recibir todo. ### Leer un id de clic que ya se perdió `ad_referral` también es devuelto por la API tanto en `GET /v1/contacts/{id}` (como `adReferral`) como en el endpoint de la lista de contactos (como `ad_referral`), por lo que si su receptor estaba caído, o si está conciliando información a posteriori, puede recuperar el id de clic en lugar de esperar al siguiente webhook. Los contactos que llegaron antes de que se registrara el id de clic en ellos tienen `null` aquí; el valor solo puede capturarse del mensaje entrante en sí, por lo que no hay nada que completar de forma retroactiva. --- ## Limitaciones - Solo conexión oficial a la API de WhatsApp (no la conexión web no oficial). - Aún no hay integración nativa de un solo clic con Meta CAPI o Google Ads; los datos se reenvían a través de Zapier/Make/Pabbly. Si desea una integración nativa, infórmeselo al equipo de soporte en hi@youraiconnector.com. - La atribución se captura a partir del momento en que esto está activo. No se puede aplicar de forma retroactiva a conversaciones que ocurrieron antes. --- ## Próximos pasos - [Webhooks](webhooks.md): vea la carga útil completa y qué eventos incluyen `ad_referral`. - [Uso de etiquetas para clasificar contactos](../get-started/creating-tags.md): configure las etiquetas que representan las etapas de su embudo.