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

¿Prefieres publicar anuncios que dirijan a una página de tu propio sitio web con un botón de WhatsApp? Consulta Atribución de clics en anuncios para WhatsApp.

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 en el 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 de pago 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: whatsapp, instagram o messenger.
captured_at Cuándo se registró por primera vez la referencia en el contacto.

Puedes verlo sin necesidad de configuración: la página del contacto muestra una etiqueta Came from ad debajo de su nombre (pasa el cursor sobre ella para ver los detalles del anuncio), el panel de contacto junto al chat también lo muestra, y la Actividad del contacto comienza con el toque en el anuncio. También puedes leerlo a través de webhooks y la API (consulta a continuación). No es una columna 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.

Leads que llegan sin número de teléfono

Algunas personas que le envían un mensaje desde un anuncio tienen su número de teléfono oculto por WhatsApp. En ese caso, Meta entrega un ID privado de la persona en lugar de un número, y el contacto se crea con un campo de teléfono vacío. Esto es normal. Las respuestas, las respuestas de la IA y los seguimientos automáticos siguen llegando a la persona, porque Your AI Connector se dirige a ellos a través de ese ID.

Deje el campo de teléfono vacío en dicho contacto. No escriba su propio número de empresa en él: un mensaje no puede enviarse de un número a sí mismo, por lo que el siguiente seguimiento automático fallaría y el contacto se pausaría. Your AI Connector ahora rechaza guardar uno de sus propios números conectados como teléfono de un contacto. Si la persona comparte su número más tarde, o le envía un mensaje de nuevo con él visible, se completará automáticamente.

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.

Anuncios de clic a Instagram y clic a Messenger

Los anuncios que abren un mensaje directo de Instagram o un chat de Messenger se registran de la misma manera, en la página de Facebook y la cuenta de Instagram que conectaste con la tarjeta de Instagram y Messenger. Cuando alguien inicia un chat desde uno de esos anuncios, el contacto obtiene un ad_referral con channel establecido en instagram o messenger, source_type establecido en ad y source_id establecido en el ID del anuncio. Eso te proporciona el anuncio detrás de cada contacto, para que puedas calcular el costo por reserva por anuncio.

Algunas diferencias con respecto a WhatsApp:

  • No existe ctwa_clid; ese campo está vacío. Meta solo emite ese identificador de clic para WhatsApp.
  • headline es el título del anuncio cuando Meta lo envía, y source_url es el enlace a la imagen o video del anuncio cuando existe uno. body está vacío.
  • Si el contacto provino primero de un anuncio y luego inicia un chat desde un anuncio diferente, ad_referral muestra el anuncio más reciente.
  • Los contactos de anuncios de Messenger incluyen el anuncio a partir del 14 de octubre de 2026. Los contactos que provinieron de un anuncio de Messenger antes de esa fecha no tienen ad_referral, porque los detalles del anuncio no se registraron entonces y no pueden completarse posteriormente.
  • Los chats de Messenger que comienzan con un toque en el botón Empezar de la página no se registran. Elimine el botón Empezar de su página (Meta Business Suite, configuración de la bandeja de entrada) para que las personas inicien el chat escribiendo, y el anuncio se registre en su primer mensaje.

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. Para los anuncios que envían a las personas primero a tu propio sitio web, Your AI Connector puede enviar los resultados a Meta por ti cuando se aplica una etiqueta: consulta Enviar resultados a Meta. Para los anuncios de clic a WhatsApp, reenvías los datos mediante 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 configura en la propia etiqueta, en la pestaña Tags del editor del agente de IA al que está asignado el contacto, no en Ajustes. Cada etiqueta tiene 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).
  • La función integrada Enviar resultados a Meta envía los datos de clics registrados por el script del sitio web; no envía el ctwa_clid de los anuncios de clic a WhatsApp. Para esos casos, y para Google Ads, reenvías los datos a través de Zapier/Make/Pabbly. Si deseas una integración nativa, infórmalo al equipo de soporte en hi@youraiconnector.com.
  • La atribución se captura de ahora en adelante, desde el momento en que esto esté activo. No se puede aplicar de forma retroactiva a conversaciones que ocurrieron antes.

Próximos pasos