Cómo conectar Meta Conversions API a Merez

Conectar Meta con Merez significa enviar tus leads al Conversions API desde el servidor, sin depender del píxel del navegador. Así Meta recibe la señal de que un lead se calificó y puede medir y optimizar con ella. Necesitas dos datos de tu conjunto de datos y una decisión de negocio: en qué etapa del embudo avisas. Este es el paso a paso.

Qué necesitas antes de empezar

• Módulo Analítica activo en Merez. La integración de Meta vive dentro de ese módulo. Sin él, la fila aparece como “Requiere módulo (Analítica)” y no se puede guardar.
• Acceso al conjunto de datos en Events Manager con un usuario que pueda generar tokens. Meta aclara que el enlace “Generar token de acceso” solo lo ven los usuarios con privilegios de desarrollador sobre el negocio; si no lo ves, pídeselo a quien administre la cuenta.
• Un conjunto de datos (dataset) con el píxel de tu sitio o el que Meta haya creado para tu negocio. Si ya tenías píxel, el ID del conjunto es el mismo número.
• El embudo de Merez con sus etapas definidas. Antes de configurar, decide cuál de esas etapas equivale a “lead calificado” para tu operación. Esa decisión es la que dispara el evento.
• Tu cuenta de Merez con permiso de edición. Solo el dueño de la cuenta (el correo principal) puede abrir y guardar la configuración; los demás usuarios ven el estado.
• Nada de código de prueba para arrancar. Ese campo se usa solo mientras estás verificando y luego se deja vacío.

Las credenciales, una por una

Son dos campos obligatorios, un campo opcional y una elección de embudo. El opcional es el que más problemas causa cuando se queda puesto, así que léelo con calma.

Campo en Merez	Qué es	Dónde se consigue exactamente
Pixel / Dataset ID	El identificador del conjunto de datos que recibe los eventos. Si tu negocio ya tenía píxel, es el mismo número.	Events Manager → Conjuntos de datos → elige el conjunto de tu negocio. El ID aparece en la ficha del conjunto y es el que se usa en la ruta /{PIXEL_ID}/events del Conversions API.
Access Token	Token que autoriza a Merez a escribir eventos en ese conjunto. Sin él, Meta rechaza el envío.	Events Manager → tu píxel → pestaña Configuración → sección Conversions API → “Generar token de acceso”, dentro de la opción de configuración manual. Sigue el cuadro de diálogo y copia el token.
Código de prueba (opcional)	Código temporal que Meta genera en la herramienta Probar eventos para que los envíos se vean en esa ventana. No es un entorno de pruebas aislado.	Events Manager → Probar eventos. Copia el código que muestra la página en ese momento; si la cierras y la vuelves a abrir, toma el código nuevo que aparezca.
Avisar de un lead calificado	La etapa del embudo de Merez que dispara el evento QualifiedLead hacia Meta. No es una credencial: es la regla de negocio.	Merez → configuración del embudo. Elige la etapa que tu equipo usa cuando el lead ya está calificado, no la de primer contacto.

Sobre el token: se genera por conjunto de datos y queda ligado a ese negocio. Si alguien lo revoca o lo regenera, el que tenías en Merez deja de servir y los envíos fallan. Por eso conviene que lo genere una persona y quede registrado quién lo hizo y cuándo.

Simulación de uso: de la plataforma a Merez

Caso: Aceros del Sur, distribuidora de materiales de construcción en Medellín. Pauta en Facebook e Instagram, los interesados escriben por WhatsApp y el equipo comercial mueve cada lead por un embudo con etapas Nuevo, Contactado, Calificado y Ganado. Quieren que Meta sepa cuándo un lead llega a Calificado.

1. Abre Events Manager y entra al conjunto de datos de Aceros del Sur. Confirma el ID: si ya tenían píxel, es el mismo número que venían usando.
2. Ve a la pestaña Configuración, busca la sección Conversions API y pulsa “Generar token de acceso”. Copia el token completo. Si el enlace no aparece, el usuario no tiene privilegios de desarrollador.
3. En Merez, abre Analítica → Meta (Conversions API). La fila está en “Sin configurar”. Pega el Pixel / Dataset ID y el Access Token. Deja “Código de prueba” vacío.
4. En “Avisar de un lead calificado”, elige la etapa Calificado. Guarda. Con los dos datos completos la fila pasa a “Conectada”; si falta el token, queda en “Faltan credenciales”.
5. Antes de cerrar, prueba. En Events Manager abre Probar eventos y copia el código que muestra esa página en ese momento. Pégalo en Merez en “Código de prueba”, guarda y pulsa “Enviar evento de prueba”.
6. Mira la ventana de Probar eventos: el evento debe aparecer con su nombre, la hora y el método de conexión del servidor. Si en dos o tres minutos no aparece, el código o el conjunto de datos no son los correctos.
7. Cierra la prueba: borra el código en Merez, guarda y confirma que la fila sigue en “Conectada” y que el campo quedó vacío. Desde ese momento, cada lead que llegue a Calificado dispara un QualifiedLead hacia Meta.
8. Valida con un lead real de prueba: muévelo a Calificado y búscalo en Events Manager → Resumen del conjunto de datos. Meta documenta que los eventos enviados por el Conversions API se pueden verificar en unos 20 minutos.

Lo que cambió en Merez: la fila pasó de “Sin configurar” a “Conectada” y la etapa elegida quedó como disparador. Lo que cambió en Meta: el conjunto de datos empezó a recibir un evento por servidor con el nombre QualifiedLead y el método de conexión del Conversions API.

Cómo comprobar que quedó bien

1. Con código de prueba: el evento aparece en Probar eventos con el código pegado en Merez. Es la prueba de que el token y el conjunto son correctos.
2. Sin código de prueba: mueve un lead a la etapa elegida y búscalo en Resumen del conjunto de datos. Debe figurar como evento recibido, con el Conversions API como método de conexión.
3. Campo vacío: confirma que “Código de prueba” quedó en blanco después de la verificación. Es el chequeo más importante de todos.
4. Estado: la fila debe seguir en “Conectada”. Si dice “Pausada”, alguien desactivó la integración.

El código de prueba no es un sandbox. La documentación de Meta indica que ese campo debe usarse solo para pruebas y quitarse del envío de producción, y aclara que los eventos enviados con el código no se descartan: entran a Events Manager. Si lo dejas puesto, el tráfico real se mezcla con las pruebas y la lectura del conjunto deja de ser confiable (Meta for Developers, consultado el 7 de noviembre de 2026).

Errores frecuentes

Síntoma	Causa	Qué hacer
La fila queda en “Faltan credenciales”	Falta el token o el Dataset ID, o el token se pegó incompleto	Copia el token entero otra vez. El token se genera para un conjunto de datos concreto.
El evento no aparece en Probar eventos	El código pegado es de otra sesión de la herramienta, o el conjunto de datos no es el mismo	Vuelve a abrir Probar eventos, copia el código vigente, pégalo en Merez y reenvía la prueba.
El tráfico real quedó marcado como prueba	El código de prueba se quedó guardado en producción	Bórralo, guarda y verifica que el campo esté vacío. Los envíos hechos mientras estaba puesto quedaron asociados a la prueba.
Meta rechaza el envío por token inválido	El token se revocó, se regeneró o el usuario no tenía privilegios	Genera un token nuevo en Configuración → Conversions API y pégalo en Merez.
El lead se califica pero no se ve el evento	La etapa configurada no es la que se está moviendo, o el embudo se editó	Revisa “Avisar de un lead calificado” y mueve un lead por la etapa correcta.
La fila pasa a “Pausada”	Alguien desactivó la integración o cambió el módulo	Reactívala desde el panel y confirma que el módulo Analítica sigue activo.

Límites y buenas prácticas

Merez no crea el conjunto de datos, no administra tu cuenta de anuncios y no corrige el píxel de tu sitio. Tampoco decide qué eventos acepta Meta ni cómo los empareja: eso es del proveedor. El Conversions API es una interfaz de Meta y sus requisitos cambian cuando Meta los cambia; la documentación consultada en noviembre de 2026 es la referencia de este artículo.

• El token es una credencial sensible. Quien lo tenga puede enviar eventos a tu conjunto. Guárdalo como una contraseña y renuévalo si sale del equipo.
• Deja el código de prueba solo mientras verificas. Un evento enviado con código no se puede reescribir después.
• Revisa cada mes que la fila siga en “Conectada”, que el token no esté revocado y que el conjunto de datos sea el correcto.
• Si cambias el embudo o renombras etapas, vuelve a revisar la etapa configurada. Un cambio de nombre puede dejar la regla apuntando a una etapa que ya nadie usa.
• Un lead calificado, un evento. No configures dos reglas que disparen lo mismo o vas a duplicar señales.
• No uses el Conversions API como única fuente de verdad comercial: es una señal para Meta, no tu CRM. El seguimiento del lead vive en Merez.