Conversions API para WhatsApp: cómo mandarle a Meta el lead calificado y no el "hola"

Es la versión de la Conversions API de Meta para conversaciones: en vez de mandar lo que pasó en tu sitio web, mandás lo que pasó en un chat de WhatsApp, Messenger o Instagram que empezó en un anuncio. Meta la describe como la forma de "share their clients' data … directly from their servers" para mejorar el rendimiento de los anuncios que llevan a mensajería (documentación oficial).

Para WhatsApp, cada evento necesita cuatro campos obligatorios:

• action_source: business_messaging
• messaging_channel: whatsapp
• whatsapp_business_account_id: el ID de tu cuenta de WhatsApp Business
• ctwa_clid: el identificador del clic que llega en el primer mensaje de la conversación

El ctwa_clid es la llave. Si tu CRM no lo guardó cuando entró el mensaje, después no hay forma de atribuirle el evento a ese anuncio. Cómo llega y dónde viene está en cómo medir qué anuncio trajo la venta.

Meta lista estos eventos para mensajería. La columna de la derecha es nuestra sugerencia de dónde encaja cada uno en un embudo de venta por WhatsApp; los nombres son los oficiales.

Meta no deduplica los eventos de mensajería: si mandás dos veces el mismo, cuenta dos veces. La deduplicación es trabajo del CRM (lo contamos en cómo medir anuncios de clic a WhatsApp).

Acá es donde más se promete de más. La documentación de Meta dice textual que la optimización por compra está disponible "for ads that click to Messenger and ads that click to WhatsApp only, but is not available for Instagram ad optimization at this time" (fuente).

Traducido:

1. Optimizar por compra en anuncios de clic a WhatsApp: documentado. 2. Optimizar por compra en anuncios de clic a Instagram Direct: no disponible por ahora. 3. Optimizar por lead calificado: el evento QualifiedLead existe y Meta lo recibe, pero la documentación no describe una optimización por ese evento para anuncios de clic a WhatsApp. Hay proveedores que lo venden como si existiera; nosotros no lo pudimos confirmar.

Por eso importa cómo se mandan los eventos, no sólo que se manden.

Viene prendido en el CRM, sobre tu número de siempre conectado por coexistencia:

• Al entrar la conversación de un anuncio, el CRM guarda el ctwa_clid y el ID del anuncio en la ficha del contacto y manda LeadSubmitted, una sola vez por conversación.
• Cada 15 minutos, un clasificador lee las conversaciones nuevas. Mira sólo los mensajes del cliente —no lo que dice el vendedor ni el bot— y busca señales de intención de compra que se definen por rubro. En una concesionaria, por ejemplo: un modelo concreto, un usado para entregar, un anticipo o una pregunta por cuotas. Usa IA, con reglas de respaldo si la IA no está disponible.
• Si la conversación califica, manda QualifiedLead y, junto con él, un Purchase con un valor de referencia por marca o rubro. Es deliberado: como la única optimización documentada para clic a WhatsApp es la de compra, así la campaña aprende de leads calificados en vez de conversaciones que dicen "hola".
• Cada evento sale con un identificador propio y el CRM registra que ya lo mandó, para no duplicar.

• Tu número en la API oficial. Con la coexistencia, sin sacarlo de la app de WhatsApp Business del celular.
• Un dataset de Meta vinculado a tu cuenta de WhatsApp Business. Meta permite vincular un solo dataset por página, y aplica la misma restricción a las cuentas de WhatsApp Business (fuente).
• Anuncios de clic a WhatsApp. Sin anuncio no hay ctwa_clid, y sin ctwa_clid no hay a quién atribuirle el evento.
• Ojo con los Estados de WhatsApp: en ese placement Meta no manda el ctwa_clid, así que esos leads se atienden igual pero no se pueden devolver como conversión.

• Optimización por QualifiedLead en anuncios de clic a WhatsApp. No figura en la documentación de la Conversions API para mensajería (30-09-2026). Si Meta la documenta, actualizamos esta página.
• Plazo máximo para mandar un evento después del clic. La página de la API para mensajería no lo indica.
• Cuánto mejora el costo por lead. Depende de la cuenta, el rubro y el volumen de eventos. No publicamos un porcentaje que no podamos mostrarte con tu propia cuenta.