Your AI Connector Docs

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 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 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.)

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