La API de conversiones de Meta es una conexión que envía los eventos de tu negocio a Meta directamente desde tu servidor, CRM o plataforma. Complementa al píxel del navegador, recupera conversiones que se pierden por bloqueos o errores y entrega mejores datos para medir y optimizar tus campañas de Facebook e Instagram.
Si inviertes en Meta Ads y tus reportes no cuadran con las ventas reales, probablemente te faltan datos. El píxel, que funciona en el navegador de cada visitante, ya no captura todo lo que ocurre: bloqueadores, navegadores con más privacidad, conexiones que fallan y ventas que se cierran fuera del sitio quedan fuera.
La API de conversiones existe para cerrar esa brecha. En esta guía verás qué es, cómo funciona junto al píxel, qué datos envía, cómo evitar contar dos veces la misma conversión y qué opciones tienes para implementarla. Todo lo técnico viene de la documentación oficial de Meta para desarrolladores, consultada en octubre de 2026.
Qué es la API de conversiones de Meta
Según la documentación oficial de la API de conversiones, se trata de una conexión entre los datos de marketing del anunciante, desde su servidor, plataforma web, aplicación o CRM, y los sistemas de Meta. Meta usa esos datos para medir los resultados y optimizar la entrega de los anuncios.
Los eventos que envías por la API de conversiones se vinculan a un conjunto de datos y se procesan igual que los eventos del píxel de Meta. La diferencia es el origen: el píxel los envía desde el navegador del visitante; la API, desde un sistema que tú controlas.
En la práctica, la API de conversiones permite enviar a Meta cosas como:
- Eventos del sitio web. Formularios enviados, compras, registros o clics en WhatsApp, enviados desde el servidor.
- Eventos del CRM. Un lead que se calificó, una visita a la sala de ventas que se concretó o una venta que se cerró días después.
- Eventos fuera de línea. Ventas en tienda física o cierres por teléfono vinculados a una campaña.
- Eventos de mensajería. Conversiones originadas en conversaciones de Messenger, Instagram o WhatsApp.
Un punto de vocabulario: en el administrador de eventos de Meta verás términos como conjunto de datos, eventos del navegador, eventos del servidor y calidad de coincidencia. No necesitas dominar cada detalle técnico para tomar buenas decisiones, pero sí entender qué eventos mides, de dónde vienen y si se están contando bien. Esa claridad es la que te permite conversar con tu agencia o tu equipo técnico y exigir resultados verificables.
Tampoco es una herramienta solo para grandes anunciantes. Una pyme que invierte de forma constante en Facebook e Instagram, y que recibe sus contactos por formulario o WhatsApp, también pierde datos con el píxel solo.
Por qué el píxel ya no basta
El píxel de Meta es un código que se ejecuta en el navegador. Si el navegador no lo carga, lo bloquea o se cierra antes de que termine, el evento no llega. Eso ocurre más de lo que parece:
- Bloqueadores de anuncios y rastreo. Impiden que el código del píxel se ejecute.
- Navegadores y sistemas con más privacidad. Limitan cookies y rastreo entre sitios.
- Problemas de conexión. En el celular, una señal débil puede cortar el envío del evento.
- Conversiones que ocurren después. En rubros como el inmobiliario, la venta real se cierra semanas después del formulario, fuera del sitio.
Cuando faltan eventos, el algoritmo de Meta aprende con información incompleta. Optimiza hacia lo que ve, que no siempre es lo que más te importa. La API de conversiones no reemplaza al píxel: lo respalda con una segunda vía de datos que no depende del navegador.
Cómo funcionan juntos el píxel y la API de conversiones
Meta recomienda lo que llama una configuración redundante. En su guía de prácticas recomendadas indica que conviene usar la API de conversiones además del píxel y compartir los mismos eventos con ambas herramientas.
La lógica es simple: si un evento se pierde en el navegador, llega por el servidor; si llega por ambas vías, Meta lo cuenta una sola vez gracias a la deduplicación.
Deduplicación: cómo evitar contar dos veces
Según la documentación de Meta sobre deduplicación, Meta determina si dos eventos son el mismo a partir de su identificador y su nombre:
- Mismo nombre de evento. El evento del píxel y el de la API deben llamarse igual, por ejemplo “Lead” o “Purchase”.
- Mismo identificador. El parámetro eventID del píxel debe coincidir con el event_id de la API de conversiones.
- Ventana de tiempo. Los eventos solo se deduplican si llegan dentro de las 48 horas siguientes a la recepción del primer evento con ese identificador.
- Preferencia. Si ambos eventos no difieren en contenido, Meta suele quedarse con el que recibió primero.
Meta también aclara que esta deduplicación no aplica si usas una sola fuente, solo navegador o solo servidor. Una configuración con píxel y API de conversiones sin identificadores coincidentes duplica conversiones e infla los reportes.
Qué datos envía la API de conversiones
Cada evento que envías por la API de conversiones incluye información del evento y, para que Meta pueda asociarlo a una persona, información del cliente.
Datos del evento
- Nombre del evento. Lead, Purchase, Schedule, Contact u otro estándar o personalizado.
- Hora del evento. Según la documentación de parámetros del servidor, puede ser de hasta 7 días antes del envío; si un evento supera ese plazo, Meta devuelve un error para toda la solicitud.
- Origen de la acción. El parámetro action_source indica dónde ocurrió: sitio web, aplicación, llamada telefónica, chat, tienda física, correo, mensajería de negocios, generado por el sistema u otro.
- Identificador del evento. Necesario para la deduplicación con el píxel.
- Valor y moneda. En compras o ventas, el monto en pesos chilenos u otra moneda.
Datos del cliente
La documentación de parámetros de información del cliente distingue dos grupos:
| Grupo | Ejemplos de parámetros | Tratamiento |
|---|---|---|
| Datos personales | Correo (em), teléfono (ph), nombre (fn), apellido (ln), fecha de nacimiento (db), género (ge) | Deben enviarse con hash, tras normalizarlos; por ejemplo, el correo sin espacios y en minúsculas. |
| Identificador externo | external_id, como el ID del cliente en tu CRM | Hash recomendado, con el mismo formato en todos los canales. |
| Datos técnicos del navegador | Dirección IP, agente de usuario, identificador de clic (fbc) e identificador de navegador (fbp) | No deben enviarse con hash. |
El hash transforma el dato, por ejemplo un correo, en una cadena irreconocible antes de enviarlo. Meta compara esa cadena con las suyas para encontrar coincidencias sin recibir el dato en texto plano.
Calidad de coincidencia de eventos
Meta muestra en el administrador de eventos una calificación de calidad de coincidencia de eventos. Según sus prácticas recomendadas, solo los eventos que logran coincidir con una persona sirven para atribuir y optimizar anuncios, y mientras mejor sea la coincidencia, mejor. Enviar más parámetros de calidad, como correo, teléfono e identificadores fbc y fbp, mejora ese indicador.
Por qué tus campañas necesitan la API de conversiones
Más allá de lo técnico, la API de conversiones cambia lo que puedes pedirle a Meta. Estos son los beneficios prácticos:
- Medición más completa. Recuperas eventos que el píxel pierde, así que tus reportes se acercan más a la realidad.
- Mejor optimización. Con más señales, el algoritmo aprende más rápido qué personas convierten y a quién mostrarle los anuncios.
- Optimizar hacia lo que importa. Puedes enviar eventos de calidad desde el CRM, como lead calificado o venta, y no solo el formulario. Así Meta busca personas que compran, no solo que llenan formularios.
- Atribución de ventas fuera del sitio. Ventas en sala, por teléfono o por WhatsApp pueden vincularse a la campaña que las originó.
- Audiencias más precisas. Los eventos del servidor también alimentan audiencias personalizadas y similares.
Para negocios con ciclos de venta largos, como inmobiliarias, constructoras, educación o servicios B2B, el tercer punto es el más valioso. Si conectas el CRM con la API de conversiones, la campaña deja de premiar leads de baja calidad.
Si todavía estás definiendo tu estrategia en la plataforma, revisa primero nuestra guía de Meta Ads para empresas.
Cómo implementar la API de conversiones: opciones
Hay varias formas de poner en marcha la API de conversiones, con distinto nivel de esfuerzo técnico y control.
| Opción | Cómo funciona | Cuándo conviene |
|---|---|---|
| Integración de socio | Plataformas como Shopify, WooCommerce o algunos CRM ofrecen conexión nativa o mediante plugins. | Tiendas y sitios en plataformas compatibles que buscan una puesta en marcha rápida. |
| Contenedor del lado del servidor | Un administrador de etiquetas en servidor recibe los eventos del sitio y los reenvía a Meta y a otras plataformas. | Sitios con varias plataformas de medición y equipo técnico disponible. |
| Gateway de Meta | Una solución de Meta que se instala en la nube y replica los eventos del píxel por el servidor. | Empresas que quieren servidor propio sin desarrollar a medida. |
| Integración directa | Tu equipo de desarrollo envía los eventos con solicitudes a la API desde tu servidor o CRM. | Casos con eventos del CRM, ventas fuera de línea o requisitos específicos. |
La documentación oficial resume el proceso en tres pasos: elegir el método de integración, implementar el envío de eventos y verificar que los eventos llegan y se deduplican correctamente.
Pasos prácticos para una implementación ordenada
- Define los eventos que importan. Formulario enviado, clic en WhatsApp, visita agendada, lead calificado y venta, según tu embudo.
- Revisa tu píxel. Antes de sumar la API de conversiones, confirma que el píxel registra bien los eventos y sin duplicados.
- Genera un identificador por evento. El mismo para el navegador y el servidor.
- Envía datos del cliente con hash. Correo y teléfono normalizados, más fbc y fbp sin hash.
- Prueba en el administrador de eventos. Usa la herramienta de prueba de eventos para ver qué llega por cada vía y si se deduplica.
- Monitorea la calidad de coincidencia. Revisa el indicador y corrige parámetros faltantes.
- Conecta el CRM. Cuando la base funcione, suma los eventos de calidad desde el CRM.
Para que el CRM pueda enviar eventos útiles, necesita registrar el origen de cada lead y las etapas de venta. Si vendes propiedades, lo explicamos en qué es un CRM inmobiliario.
Un ejemplo de flujo con la API de conversiones para inmobiliarias
Para aterrizar todo lo anterior, veamos cómo se vería la API de conversiones en una inmobiliaria que vende departamentos en verde con campañas de Meta Ads. Es un flujo ilustrativo, no un caso de cliente.
- La persona ve el anuncio y completa el formulario en la landing del proyecto. El píxel registra un evento “Lead” y, al mismo tiempo, el servidor envía el mismo “Lead” por la API de conversiones, con el mismo identificador, el correo y el teléfono con hash, y los valores fbc y fbp.
- El lead entra al CRM con el origen de campaña. El ejecutivo lo contacta por WhatsApp y lo califica según presupuesto y plazo.
- Cuando el lead se califica, el CRM envía un evento personalizado, por ejemplo “LeadCalificado”, por la API de conversiones, dentro del plazo de 7 días que exige Meta.
- Cuando la persona visita la sala de ventas, el CRM envía un evento “Schedule” o uno personalizado de visita.
- Cuando firma la promesa, el CRM envía un evento de venta en ese momento, con la hora de la firma y el valor de la operación. Como el evento se envía apenas ocurre, cumple con el plazo de 7 días.
Con este flujo, la campaña puede optimizarse hacia leads calificados en lugar de cualquier formulario. Y el equipo comercial ve en los reportes qué anuncios trajeron visitas y promesas, no solo contactos.
La clave es que el CRM registre bien cada etapa. Sin esa disciplina, la API de conversiones no tiene nada valioso que enviar. Si quieres que una agencia gestione la estrategia completa, revisa nuestro servicio de gestión de Meta Ads.
Privacidad y consentimiento
La API de conversiones trabaja con datos personales de tus clientes, aunque se envíen con hash. Eso exige orden y transparencia.
- Política de privacidad actualizada. Informa en tu sitio qué datos recoges, para qué los usas y con qué plataformas los compartes.
- Consentimiento. Respeta las preferencias de cookies y comunicación de cada persona, y no envíes eventos de quienes no lo aceptaron cuando corresponda.
- Datos mínimos. Envía lo necesario para medir y optimizar, no toda la ficha del cliente.
- Normativa chilena. Revisa con tu asesor legal cómo la legislación de protección de datos personales aplica a tu caso.
Una implementación cuidadosa de la API de conversiones protege a tus clientes y también a tu marca.
Errores comunes con la API de conversiones
- Duplicar conversiones. Enviar el mismo evento por píxel y servidor sin event_id coincidente infla resultados y confunde al algoritmo.
- Enviar eventos tarde. Meta recomienda compartir los eventos cuando ocurren; los que superan 7 días se rechazan.
- Hash mal aplicado. Aplicar hash a la IP o al fbp, o no normalizar el correo antes del hash, reduce las coincidencias.
- Medir solo el formulario. Si no envías eventos de calidad desde el CRM, desaprovechas la principal ventaja de la API de conversiones.
- Instalar y olvidar. Cambios en el sitio, el formulario o el CRM pueden romper el envío. Revisa el administrador de eventos cada mes.
La medición de Meta debería cuadrar con la de tus otras herramientas. Compara siempre con Google Analytics 4 y con tu CRM para detectar desvíos.
Preguntas frecuentes sobre la API de conversiones
¿La API de conversiones reemplaza al píxel de Meta?
No. Meta recomienda usar ambos en una configuración redundante, compartiendo los mismos eventos. El píxel mide en el navegador y la API envía desde el servidor lo que el navegador no logra registrar.
¿Cómo evito que se cuenten conversiones dobles?
Usa el mismo nombre de evento y el mismo identificador en el píxel y en la API. Meta deduplica los eventos que coinciden si llegan dentro de 48 horas desde el primero.
¿Necesito un programador para implementarla?
Depende. Algunas plataformas tienen integraciones nativas que se activan con pocos pasos. Para enviar eventos del CRM o ventas fuera de línea, normalmente se necesita apoyo técnico o una herramienta de servidor.
¿Qué datos personales envía la API?
Puede enviar correo, teléfono, nombre y otros datos, siempre con hash, más datos técnicos como IP, agente de usuario y los identificadores fbc y fbp, que se envían sin hash.
¿Sirve para negocios que venden por WhatsApp o en sala de ventas?
Sí. La API acepta eventos con origen en chat, llamada telefónica o tienda física. Si registras esas ventas en un CRM, puedes enviarlas a Meta y vincularlas a tus campañas.
¿Con cuánto retraso puedo enviar un evento?
La hora del evento puede ser de hasta 7 días antes del envío. Si un evento supera ese plazo, Meta rechaza la solicitud completa. Lo recomendable es enviar cada evento apenas ocurre.
Configuramos el píxel y la API de conversiones con deduplicación, conectamos tu CRM y dejamos tus campañas optimizando hacia leads calificados y ventas reales.
Ver analítica y conversiones →