API de Conversiones de Meta (CAPI): guía para leads

La API de Conversiones de Meta (CAPI) es una conexión de servidor a servidor que envía eventos de conversión desde tu servidor web, tu CRM o tu backend directo a Meta, en lugar de depender solo del Pixel del navegador. Meta recomienda usarla junto con el Pixel y deduplicar ambos con un event_id compartido. Para negocios que generan leads, su mayor valor no está en el formulario: está en enviar las etapas posteriores del CRM, como lead calificado o venta cerrada, para que Meta optimice hacia las personas que de verdad compran.

En esta guía verás qué es la CAPI de Meta, las tres formas principales de configurarla, cómo funciona la deduplicación, cómo leer el Event Match Quality y qué eventos conviene enviar si vendes por WhatsApp, por teléfono o con un equipo comercial.

¿Qué es la API de Conversiones de Meta?

El Pixel corre en el navegador del visitante. Los bloqueadores de anuncios, las funciones de privacidad del navegador, las decisiones de consentimiento y las páginas lentas pueden impedir que se dispare. La API de Conversiones de Meta envía el mismo tipo de evento desde un servidor que tú controlas, así que no depende del navegador.

Cada evento de servidor tiene algunos campos obligatorios, según la referencia de parámetros de Meta:

• event_name: un evento estándar como Lead o Purchase, o un nombre personalizado.
• event_time: una marca de tiempo Unix en segundos. Puede ser de hasta 7 días antes del envío. Si un solo evento de la solicitud es más antiguo, falla la solicitud completa.
• user_data: datos del cliente para hacer la coincidencia, como correo y teléfono con hash.
• action_source: dónde ocurrió la conversión. Los valores permitidos incluyen website, app, phone_call, chat, physical_store, system_generated, business_messaging, email y other.
• event_source_url: obligatorio para eventos de sitio web.

Como la CAPI vive de tu lado, también puede enviar eventos que el Pixel nunca ve: un lead que el vendedor marcó como calificado en Kommo, un contrato firmado o un pago registrado en tu sistema de cobranza.

¿Qué forma de configurar la API de Conversiones de Meta te conviene?

Hay tres caminos prácticos. Cambian en esfuerzo, costo y control sobre los datos.

Camino	Cómo funciona	Esfuerzo	Ideal para	Límite principal
Integración con un partner	Una plataforma que ya usas (CRM, ecommerce, gestor de etiquetas o herramienta de atribución) se conecta a Meta desde el Administrador de eventos	Bajo, muchas veces menos de un día	Equipos sin desarrolladores	Solo envías lo que el partner soporta
Conversions API Gateway	Una instancia de servidor de Meta que alojas en una cuenta de nube (la guía de Meta te pide elegir región de hosting) y que replica los eventos del Pixel desde servidor	Medio	Sitios que quieren copias de servidor de sus eventos web con poco código	Replica eventos web; por sí sola no envía etapas del CRM
Integración directa	Tus desarrolladores llaman a la API con un token de acceso generado en el Administrador de eventos	Alto	Stacks a la medida y control total de eventos del CRM	Requiere tiempo de ingeniería y mantenimiento

Muchos equipos combinan dos caminos: el Gateway o un partner para eventos web, y una integración desde el CRM para las etapas siguientes. Si quieres comparar opciones para devolver eventos del CRM a las plataformas, revisa nuestra guía para conectar conversiones offline del CRM.

¿Cómo funciona la deduplicación entre el Pixel y la API de Conversiones de Meta?

Si mandas el mismo evento desde el Pixel y desde la CAPI, Meta necesita saber que es una sola conversión. Si no, cuenta dos. La documentación de deduplicación de Meta describe dos métodos.

1. event_id más event_name (recomendado). Genera un ID único por conversión, por ejemplo el ID del lead. Pásalo al Pixel como eventID (el cuarto argumento de la llamada fbq track) y a la CAPI como event_id. Los nombres de evento deben coincidir exactamente, por ejemplo Lead y Lead.
2. fbp o external_id más event_name. Envía el mismo identificador de navegador o tu propio ID de usuario desde ambos lados. Solo funciona si el evento del navegador llega primero. No deduplica flujos que solo vienen del servidor o solo del navegador.

Meta solo deduplica dentro de las 48 horas posteriores al primer evento con un event_id dado. Cuando las dos copias no difieren de forma relevante, Meta en general conserva la que recibió primero.

Un error común es generar el event_id dos veces, una en el navegador y otra en el servidor. Así nunca coinciden. Crea el ID una sola vez (por ejemplo, al enviar el formulario), déjalo en la página para que el Pixel lo lea y manda el mismo valor desde tu servidor. Nuestro artículo sobre deduplicar conversiones entre plataformas cubre el problema más amplio del doble conteo.

¿Qué es el Event Match Quality en la API de Conversiones de Meta?

El Event Match Quality (EMQ, calidad de coincidencia de eventos) estima qué tan bien se pueden relacionar los datos de cliente de tus eventos de servidor con una cuenta de Meta. La documentación para desarrolladores de Meta lo describe como una calificación sobre 10, visible por evento en el Administrador de eventos. Algunas guías de terceros también mencionan etiquetas como Excelente, Buena, Aceptable y Mala, así que revisa qué muestra hoy tu cuenta.

El EMQ sube cuando envías más y mejores identificadores. La lista habitual:

• Correo y teléfono normalizados (minúsculas, sin espacios, teléfono con código de país, como 52 para México) y con hash SHA-256.
• fbc (se arma con el fbclid de la URL del clic en el anuncio) y fbp (la cookie de navegador), capturados al enviar el formulario y guardados con el lead.
• Dirección IP y user agent del cliente en eventos web (estos van sin hash).
• external_id: tu propio ID estable de cliente o de lead, con hash.
• Nombre, apellido, ciudad y país cuando los tengas.

Los eventos del CRM suelen calificar más bajo que los eventos web porque la venta ocurre días después, lejos del navegador. La solución es guardar fbc, fbp, correo y teléfono en el registro del lead al momento del formulario, y enviarlos en cada etapa posterior.

¿Qué eventos enviar por la API de Conversiones de Meta si generas leads?

Un formulario lleno es una señal débil. Muchos leads nunca contestan el teléfono ni el WhatsApp. Si Meta solo ve eventos Lead, aprende a encontrar gente que llena formularios, no gente que compra. La CAPI te deja enviar las etapas que importan.

Etapa del embudo	Evento sugerido	Origen	Uso en anuncios
Formulario enviado	Lead	Pixel + CAPI, deduplicado	Señal de volumen, aprendizaje inicial
Lead calificado por ventas	Evento personalizado, por ejemplo QualifiedLead	CRM vía CAPI	Optimización cuando el volumen lo permita
Cita o visita realizada	Schedule o evento personalizado	CRM vía CAPI	Reportes y audiencias
Venta cerrada	Purchase con valor y moneda (por ejemplo MXN)	CRM vía CAPI	Reporte de ingresos y señales de valor

Si usas formularios instantáneos (Lead Ads), Meta también ofrece la integración Conversion Leads. Según su guía, requiere guardar en tu CRM el ID de lead de Meta (recomendado), al menos 200 leads al mes, cargas al menos una vez al día, que la etapa optimizada ocurra dentro de los 28 días posteriores al lead y una tasa de conversión de esa etapa entre 1% y 40%. Meta estima de 2 a 4 semanas de aprendizaje después de verificar los datos.

Para leads de anuncios que abren WhatsApp, el identificador es la conversación, no una cookie. Ese flujo está en nuestra guía de atribución de anuncios de WhatsApp. Para la parte estratégica de alimentar mejores señales a Meta, lee cómo optimizar Meta Ads para leads calificados.

¿Cómo configurar la API de Conversiones de Meta paso a paso?

1. Audita tu Pixel. En el Administrador de eventos, lista los eventos que se disparan hoy y confirma que cada uno tenga el nombre y los parámetros correctos.
2. Elige el camino. Partner, Gateway o integración directa, según la tabla de arriba.
3. Genera un event_id por conversión y pásalo tanto al Pixel como al evento de servidor.
4. Captura identificadores al enviar el formulario: correo, teléfono, fbc, fbp, IP y user agent. Guárdalos en el registro del CRM.
5. Envía el evento Lead web desde el servidor y confirma en Probar eventos que Meta lo muestra como deduplicado.
6. Mapea las etapas del CRM a eventos (QualifiedLead, Purchase) y envíalos conforme ocurren, al menos a diario, dentro de la ventana de 7 días de event_time.
7. Revisa el EMQ y los diagnósticos después de unos días. Agrega los identificadores que falten antes de cambiar la optimización.
8. Cambia la optimización poco a poco. Pasa una campaña al evento más profundo cuando tenga volumen estable y compara el costo por lead calificado contra la configuración anterior.

Ejemplo: qué cambia al enviar leads calificados por la API de Conversiones de Meta

Ejemplo (números hipotéticos): una desarrolladora inmobiliaria en Monterrey invierte $110,000 MXN al mes en Meta y recibe 600 leads de formulario, con un costo por lead de $183 MXN. Ventas califica 90 (15%). El costo por lead calificado es de $1,222 MXN.

Métrica	Solo Pixel, optimizando a Lead	CAPI con QualifiedLead enviado desde el CRM
Inversión mensual	$110,000 MXN	$110,000 MXN
Leads de formulario	600	450
Costo por lead	$183 MXN	$244 MXN
Leads calificados	90 (15%)	99 (22%)
Costo por lead calificado	$1,222 MXN	$1,111 MXN

En este ejemplo el costo por lead sube y el costo por lead calificado baja. Por eso necesitas datos del CRM para juzgar el cambio: el Administrador de anuncios por sí solo mostraría la segunda configuración como peor. Los resultados varían por cuenta; tómalo como el patrón a buscar, no como un pronóstico.

¿Para quién es la API de Conversiones de Meta y cuándo no ayuda tanto?

Encaja con equipos de generación de leads, B2B y ventas consultivas cuya conversión real ocurre en un CRM como Kommo, HubSpot o Clientify; con sitios con mucho tráfico de iOS o con bloqueadores; y con cualquier anunciante que invierta lo suficiente en Meta como para que la calidad de la señal afecte resultados.

Ayuda menos cuando tienes muy poco volumen (unas cuantas conversiones al mes le dan poco a Meta para aprender), cuando tu equipo no actualiza las etapas del CRM con disciplina o cuando no capturas datos de contacto en la etapa de lead. La CAPI tampoco te dice qué causó Meta; para eso necesitas pruebas de lift o grupos de control, como explicamos en la guía de pruebas de incrementalidad.

La función de API de conversiones de Admira envía eventos del CRM a las plataformas de anuncios desde servidor, ligados al clic original, para equipos que usan HubSpot, Salesforce, Kommo o Clientify. Es una opción entre varios partners; si tu CRM ya tiene una integración nativa confiable con Meta, puede ser suficiente.

Preguntas frecuentes sobre la API de Conversiones de Meta

¿Sigo necesitando el Pixel de Meta si uso la CAPI?

Sí, en la mayoría de los casos. Meta describe como configuración recomendada usar el Pixel y la CAPI juntos, con deduplicación.

¿La API de Conversiones de Meta tiene costo?

Meta no cobra por la API. Tu costo es la herramienta del partner, el hosting en la nube del Gateway o el tiempo de desarrollo de una integración directa.

¿Por qué mis eventos de CAPI se cuentan dos veces?

Casi siempre el event_id es distinto entre navegador y servidor, o los nombres de evento no coinciden exactamente. Ambos deben ser idénticos y llegar dentro de 48 horas.

¿Qué es un buen Event Match Quality?

Más alto es mejor, y Meta no publica una meta universal. Enfócate en enviar correo, teléfono, fbc, fbp y external_id en cada evento, y observa la tendencia.

¿Puedo enviar eventos de más de 7 días?

No con un evento de servidor estándar: Meta rechaza toda la solicitud si algún event_time tiene más de 7 días. Envía las etapas del CRM a diario.

¿La CAPI funciona con leads de WhatsApp?

Sí, pero la coincidencia depende del teléfono y de los datos de la conversación, no de cookies del navegador. Usa un action_source que refleje dónde ocurrió la conversión.