Qué es la API de conversiones de Meta (CAPI) y cómo se configura

1. ¿Qué es la API de conversiones de Meta?

La API de conversiones de Meta es una conexión directa entre tus datos de marketing (servidor, plataforma web, app o CRM) y los sistemas de optimización de anuncios de Meta. Según su Centro de ayuda, sirve para optimizar la segmentación, reducir el costo por resultado y medir los resultados de tus campañas.

Se la conoce como CAPI. Meta indica que admite eventos de varios orígenes, como sitios web, tiendas físicas, correo electrónico, chats con el negocio, teléfono, app para celulares y offline. Para un negocio de servicios, eso permite informar una cita agendada por WhatsApp o una cotización aceptada por teléfono, aunque nada de eso ocurra dentro de tu sitio web.

Patricio Hernández lo plantea en su video «Meta ve tus leads» (15 de septiembre de 2026) como dos historias separadas: Meta ve el anuncio, el clic y el formulario, y tu negocio ve si esa persona calificó, agendó o compró. La CAPI es uno de los caminos para que la segunda historia llegue a Meta.

2. ¿En qué se diferencia la API de conversiones del píxel y de las UTM?

El píxel registra lo que ocurre en el navegador, la API de conversiones envía eventos desde un servidor o un CRM y las UTM guardan el origen de la visita en tu sistema. Meta recomienda usar píxel y API juntos, una configuración redundante, porque la API captura eventos que el píxel pierde por problemas de red o de carga.

Patricio lo resume así en el video: «Meta no va a reconocer automáticamente una venta solo porque guardaste la UTM campaign». Las UTM entregan contexto para tu análisis, y la atribución que necesita Meta es otra capa.

Si usas píxel y CAPI a la vez, Meta fija como objetivo un índice de cobertura de eventos de 75 % entre los eventos del servidor y los del píxel. Para evitar duplicados, ambos deben llevar el mismo nombre de evento y el mismo event_id: Meta compara los eventos recibidos dentro de 48 horas y, cuando coinciden, conserva el primero.

3. ¿Qué eventos puede enviar la API de conversiones de Meta?

La API de conversiones de Meta envía los eventos que tu negocio registra: visitas, compras, contactos o etapas de venta. Para conversaciones por mensajes, Meta for Developers lista 14 nombres de evento, como LeadSubmitted, QualifiedLead y Purchase. Cada evento del servidor exige cuatro campos: nombre, hora, datos de la persona y origen de la acción.

El origen de la acción tiene nueve valores posibles, entre ellos website, phone_call, chat y business_messaging. La hora del evento puede ser hasta siete días anterior al envío: si un solo evento supera ese plazo, Meta devuelve error para toda la solicitud.

Los nombres de evento vienen de la documentación de Meta; el cruce con las etapas es un ejemplo, porque cada negocio define las suyas. Patricio recomienda enviar solo las señales más relevantes (lead, calificado, agendó, asistió, cotización, cierre o perdido) y no cada llamada intermedia.

4. ¿Qué datos necesita Meta para reconocer a la persona?

Para reconocer a la persona, la API de conversiones exige al menos un dato suyo con el formato correcto. Los de prioridad alta son el correo electrónico y el identificador de clic; el teléfono tiene prioridad media. Con ellos Meta calcula una calidad de coincidencia de 0 a 10, usando las últimas 48 horas de datos.

Según Meta, cuanto mejor es esa calidad, más probable es asociar los eventos a cuentas de Meta, atribuir conversiones a tus anuncios y entregarlos a quienes tienen más probabilidades de convertir, lo que puede resultar en un menor costo por acción. La puntuación existe para eventos web estándar y personalizados, como visitas a la página, artículos agregados al carrito y compras, así que conviene enviar eventos con regularidad.

Patricio advierte que el identificador de clic llega con la visita y que el negocio debe guardarlo. Si el origen no se conserva en el CRM, ninguna integración puede reconstruirlo después.

Meta también recuerda que necesitas permisos legales y el consentimiento de las personas antes de compartir su información, y recomienda consultar a un asesor legal para armar tu plan de cumplimiento.

5. ¿Cómo se configura la API de conversiones de Meta?

Para configurarla necesitas un píxel, un Meta Business Suite y un token de acceso, según la documentación para desarrolladores. Meta explica que existen varias formas de hacerlo, con distinto esfuerzo y costo, y que muchas integraciones no requieren un desarrollador. En sitios web con píxel, ofrece además una configuración en un clic desde el Administrador de eventos.

1. Define la señal. Decide qué significa un contacto bueno en tu negocio y quién lo registra. Patricio lo dice así: «primero es criterio, después tecnología».
2. Registra cada avance en el CRM, con el origen de la persona guardado desde el primer contacto.
3. Elige la vía de integración: un socio, una configuración de Meta o una integración directa.
4. Genera el token de acceso. Meta recomienda hacerlo desde el Administrador de eventos, en la pestaña Configuración; el enlace solo lo ven los usuarios con privilegios de desarrollador.
5. Envía los eventos con el mismo event_id que el píxel y lo más cerca posible del momento real, como recomienda Meta.
6. Revisa el Administrador de eventos: cobertura, deduplicación y calidad de coincidencias.

Esta guía resume el orden de trabajo de la API de conversiones de Meta; cada vía tiene requisitos propios que Meta detalla en su documentación.

6. ¿Cómo funciona la API de conversiones de Meta en anuncios que llevan a WhatsApp?

En los anuncios que abren una conversación, Meta entrega al negocio un identificador único por clic llamado ctwa_clid. Tu sistema lo guarda con la conversación y lo devuelve junto con cada evento posterior, y así Meta atribuye la conversión al clic original. Sin ese identificador, Meta intenta emparejar con correo o teléfono con hash, sin garantía.

Meta entrega el ctwa_clid en el webhook de la API de WhatsApp Business (Cloud API); sin esa integración tu sistema no lo recibe. La ruta sin identificador tiene límites que Meta documenta: atribuye eventos a una interacción con anuncios de los últimos siete días, está disponible en un subconjunto de países y no usa el ID externo para emparejar. Además, Meta no deduplica los eventos de mensajes, así que conviene evitar envíos repetidos.

Meta explica que compartir eventos de mensajes permite medir en el Administrador de anuncios el número de compras y el costo por compra de los anuncios que abren chats, y optimizar las campañas para ese resultado. Para ver cómo funcionan estos anuncios por dentro, revisa cómo funcionan los anuncios de click to WhatsApp.

7. ¿Qué límites tiene la API de conversiones de Meta?

La API de conversiones tiene tres límites: depende de los datos que tu negocio registra, ofrece una atribución con márgenes de error y no asegura un costo por lead menor. Patricio lo expresa: «no significa atribución perfecta, no significa que meta vaya a encontrar compradores mágicamente». Con las señales de vuelta tienes información más completa para decidir.

Con las señales posteriores de vuelta, según Patricio, puedes detectar fugas, comparar calidad en vez de solo volumen y decidir presupuesto con más contexto comercial. Pone un ejemplo: un vendedor atiende a un lead hasta la compra, pero lo deja tres semanas en la etapa de nuevo lead. Esa venta no vuelve a Meta, y para Meta ese contacto queda como perdido.

Por eso insiste en la disciplina del equipo: «si no se registra, no existe». Si tu CRM acumula oportunidades en una sola etapa, la API enviará información incompleta.

8. ¿Cómo trabaja Olympus la API de conversiones con Meta Ads?

Olympus arma campañas de Meta Ads con anuncios que abren conversación en WhatsApp, y su página de servicio explica que pone un filtro de 3 a 5 preguntas antes del mensaje y le informa a Meta quién calificó, para que busque personas parecidas.

Meta Performance (USD 490 al mes, o $490.000 + IVA en Chile, más la pauta que pagas directo a Meta) incluye campañas, guiones y reporte mensual; el alcance de la conexión con tu CRM se define en el diagnóstico.

Aparte del plan, en el video, Patricio describe que Olympus instala y opera la infraestructura que conecta la adquisición con el CRM y el seguimiento, y capacita al equipo de ventas para que registre cada avance. El objetivo es que el equipo comercial y el de marketing lean los mismos datos. Un ejemplo publicado en la página de casos de éxito: Solvex Energías Renovables cerró 3 proyectos por $17,5 millones con clientes llegados desde los anuncios en Meta. Es un caso puntual; ningún resultado queda garantizado. El caso corresponde a campañas de Meta Ads, sin medición de la API de conversiones.

Si quieres revisar cómo entra hoy la información a tu CRM y qué señales tiene sentido devolverle a Meta, puedes agendar un diagnóstico de 30 minutos. También puedes leer el servicio de Meta Ads y cómo responde el setter de WhatsApp con IA.