API de conversiones de Meta: qué es y cómo configurarla bien

La API de conversiones de Meta (Conversions API o CAPI) permite enviar eventos a Meta desde tu servidor o desde tu CRM, sin depender solo del navegador. Esta guía explica qué es, qué datos lleva un evento, cómo se evita contar dos veces lo mismo y qué suele salir mal.

Guía 4 min de lectura · Actualizado: 2026-11-08

Venta del CRM → Meta

Qué es la API de conversiones de Meta

Es una interfaz que te deja mandar a Meta eventos de negocio (un formulario enviado, una compra, una venta cerrada) directamente desde un sistema tuyo: tu servidor, tu plataforma de comercio electrónico o tu CRM. El píxel hace lo mismo desde el navegador del visitante; la API lo hace desde fuera del navegador.

Eso tiene dos consecuencias prácticas. La primera: los eventos no se pierden por bloqueadores ni por restricciones del navegador. La segunda, y más importante para quien vende por teléfono o con comerciales: puedes enviar eventos que ocurren después de la visita, como «cita agendada» o «venta cobrada», que el píxel nunca ve porque suceden en el CRM. Es lo que se conoce como conversiones offline en Meta.

Qué lleva un evento de la API de conversiones

Cada evento es una petición con unos campos básicos. Los principales:

CampoPara qué sirve
event_nameQué ha pasado (por ejemplo, Lead o Purchase)
event_timeCuándo ocurrió, en tiempo Unix
action_sourceDónde ocurrió: web, correo, teléfono, sistema, etc.
user_dataDatos para reconocer a la persona: correo y teléfono (con hash), identificadores de clic y navegador
custom_dataValor, moneda y detalles del evento
event_idIdentificador para no contar dos veces el mismo evento si también llega por el píxel

El correo y el teléfono deben normalizarse (minúsculas, sin espacios, teléfono con prefijo) y enviarse con hash SHA-256 según indica la documentación. El valor y la moneda son los que permiten optimizar por ingresos y no solo por número de eventos.

Cómo configurarla paso a paso

  1. Decide qué eventos vas a enviar. Empieza por pocos y que importen: lead, lead cualificado y venta.
  2. Elige el origen del envío. Desde la web (servidor o gestor de etiquetas del servidor) para los eventos de navegación; desde el CRM para los de negocio.
  3. Captura los identificadores en el momento del clic o del formulario y guárdalos con el contacto: el parámetro fbclid de la URL (que da lugar a fbc), la cookie _fbp, el correo y el teléfono.
  4. Genera un event_id único y úsalo igual en el píxel y en la API cuando ambos envían el mismo evento.
  5. Prueba con la herramienta de eventos de prueba del Administrador de eventos antes de dar nada por bueno.
  6. Revisa la calidad de cada evento tras unos días (ver nuestra guía de calidad de coincidencia).

Cómo evitar eventos duplicados con el píxel

Si un mismo evento llega por el píxel y por la API, Meta lo cuenta una vez solo si puede reconocer que es el mismo. Para eso necesita el mismo event_name y el mismo event_id en las dos vías. Si falta el identificador, o es distinto, el evento se duplica y los informes inflan las conversiones.

Una regla sencilla: los eventos de navegador pueden ir por ambas vías con el mismo identificador; los eventos de negocio que solo existen en el CRM van solo por la API, con su propio identificador (por ejemplo, el número de la oportunidad).

Errores típicos con la API de conversiones

Qué ventaja da frente al píxel solo

El píxel sigue siendo útil, pero cubre únicamente lo que ocurre en el navegador y está expuesto a bloqueadores y cookies rechazadas. La API cubre ese hueco y añade lo que sucede en tu empresa. Meta recomienda usar ambos de forma redundante: lo que uno pierde, lo recupera el otro. Para entender el envío desde el servidor en general, tienes la guía de server-side tracking.

Acelera Sales

Cómo lo resuelve Acelera Sales

Acelera Sales mide tu publicidad hasta la venta cobrada en el CRM y devuelve esa venta a las plataformas con su API de conversiones. Hay conectores listos para Meta, Google/YouTube, TikTok, LinkedIn, Microsoft y Pinterest, y se conecta con cualquier CRM, con tu web y con los canales donde habla el cliente (WhatsApp, llamadas, chat). Cuando una oportunidad pasa a «cobrada», Acelera Sales envía a Meta el evento con valor, moneda, identificadores de clic y datos del contacto con hash, usando un identificador estable para evitar duplicados. Además vigila la calidad que Meta puntúa para cada evento y, si baja, corrige la causa (un campo que ya no se captura, un formato roto) antes de que el algoritmo lo note. Ver integración con Meta Ads o mirar la demo.

Preguntas frecuentes

¿Qué es la API de conversiones de Meta?

Es el sistema para enviar eventos a Meta desde un servidor o un CRM en lugar de desde el navegador. Sirve para no perder eventos y para enviar los que ocurren fuera de la web, como una venta cerrada.

¿La API de conversiones sustituye al píxel de Meta?

No hace falta sustituirlo. Meta recomienda usar píxel y API juntos, con el mismo identificador de evento para que no se cuente dos veces.

¿Necesito programar para usar la API de conversiones?

Hay integraciones ya hechas en plataformas de comercio electrónico y gestores de etiquetas. Para conectar un CRM a medida o enviar ventas cobradas, normalmente hace falta una integración técnica.

¿Qué es el event_id y por qué importa?

Es un identificador único del evento. Si el píxel y la API envían el mismo evento con el mismo nombre e identificador, Meta lo deduplica y lo cuenta una vez.

¿Cómo compruebo que la API funciona?

Con la herramienta de eventos de prueba del Administrador de eventos y revisando después la calidad de cada evento. Recibir el evento sin error no basta: tiene que coincidir con una persona.

Relacionados

¿Lo vemos con tus datos?

En 30 minutos te enseñamos cómo se vería tu publicidad medida hasta la venta. Sin compromiso.