Cómo configurar el evento Lead de Facebook CAPI (Conversion API)

Este documento explica paso a paso cómo configurar correctamente el evento Lead utilizando la API de Conversiones de Facebook (CAPI), integrándolo con tu CRM mediante flujos de trabajo (Workflows).

Paso 1: Crear o seleccionar un píxel de Facebook

1. Accede a tu Facebook Business Manager (Meta Business Suite).
2. En el menú lateral izquierdo, dirígete a Events Manager (Administrador de eventos).
3. Asegúrate de estar conectado a la cuenta publicitaria correcta y de contar con todos los permisos necesarios.

4. 

Conectar una fuente de datos

1. En la barra lateral izquierda, haz clic en Conectar fuentes de datos.

2. 

3. Selecciona la opción CRM y haz clic en Siguiente.

4. 

5. Aparecerá una ventana emergente con las mejores prácticas recomendadas por Facebook. Haz clic en Siguiente para continuar.

6. 

7. Selecciona una de las siguientes opciones:
   • Crear un nuevo píxel, o
   • Usar un píxel existente.

   • 

8. Haz clic en Continuar una vez que los detalles del píxel estén definidos.

Seleccionar el socio CRM

1. Después de crear o seleccionar el píxel, elige LeadConnector como socio CRM.
2. Haz clic en Siguiente.

3. 

⚠️ Nota importante

Después de hacer clic en Siguiente, Facebook puede redirigirte al sitio web del socio. Puedes ignorar este paso y continuar directamente con la creación de los flujos de trabajo en tu CRM para enviar eventos vía CAPI.

Validaciones importantes del Events Manager

Si ves el estado "Esperando eventos CRM durante siete días", verifica lo siguiente:

• Estás enviando datos diariamente y de forma consistente al píxel.
• Se generan al menos 50 eventos reales en un período de 7 días.
• Los eventos de prueba no cuentan como eventos válidos.
• Al menos dos etapas del píxel deben estar recibiendo eventos.

• 

Una vez completado este paso, ya puedes comenzar a enviar eventos desde el CRM.

Requisitos previos para eventos Lead vía Facebook CAPI

Antes de configurar los flujos de trabajo, asegúrate de que:

1. En el CRM, navegues a Configuración > Integraciones.
2. La cuenta de Facebook esté conectada con permisos de administrador.
3. La Página de Facebook (donde eres administrador) esté integrada correctamente.
4. El formulario de Facebook Lead Ads correcto esté mapeado en el CRM.

5. 

6. 

Mapeo de campos del formulario de Facebook

• El formulario debe estar correctamente mapeado y con estado habilitado.
• El mapeo se encuentra en: Configuración de ubicación > Integraciones > Mapeo de campos del formulario de Facebook.
• Se admiten campos personalizados de:
  • Opción única
  • Opción múltiple

Paso 2: Crear los flujos de trabajo para Facebook CAPI

⚠️ Importante

Para que el proceso funcione correctamente, es necesario crear dos flujos de trabajo.

Flujo de trabajo 1: Crear / Actualizar Oportunidad

Este flujo se encarga de capturar el lead y registrarlo correctamente en el pipeline.

Configuración

1. Ve a Automatizaciones > Flujos de trabajo.
2. Crea un nuevo flujo de trabajo.
3. Agrega un disparador:
   • Facebook Lead Form Submission.

   • 

4. (Opcional) Agrega filtros para definir qué formulario específico activará el flujo.

5. 

Acción: Meta Conversion API

1. Agrega una acción Meta Conversion API.

2. 

3. Completa los siguientes campos:
   • Access Token
   • Pixel ID
   • Nombre de la etapa

   • 

   • 

Obtener el Access Token

• Ve a Events Manager > Fuentes de datos > Configuración.
• Desplázate hacia abajo y haz clic en Generar token de acceso.
• Copia y pega el token en la acción del flujo de trabajo.

• 

Obtener el Pixel ID

• Ve a Events Manager > Fuentes de datos > Configuración.
• Copia el Dataset ID (este corresponde al Pixel ID).

• 

Acción: Crear o Actualizar Oportunidad

1. Agrega la acción Crear / Actualizar Oportunidad.

2. 

3. Selecciona:
   • Pipeline
   • Etapa del pipeline
4. Define el nombre de la oportunidad usando el nombre completo del Lead.

5. 

6. Activa la opción "Permitir duplicados de oportunidades".

7. 

8. Guarda y publica el flujo de trabajo.
9.  

Flujo de trabajo 2: Enviar el evento Lead a Facebook CAPI

Este flujo se activa cuando el lead cambia de etapa en el pipeline.

Configuración

1. Crea un segundo flujo de trabajo.
2. Selecciona el disparador:
   • Cambio de etapa del pipeline.
3. Agrega una acción Meta Conversion API.

4. 

Configuración del evento

• Tipo de evento: Lead
• Access Token: (mismo proceso descrito anteriormente)

• 

• Pixel ID: Dataset ID del Events Manager

• 

• Nombre de la etapa:
  • Debe representar claramente el pipeline y la etapa.
  • Utiliza el selector de valores personalizados para incluir:
    • Pipeline de oportunidades
    • Etapa del pipeline

4. Guarda la acción y publica el flujo de trabajo.

Mapeo personalizado de parámetros (Custom Mapping)

Al igual que en Google Ads, ahora es posible configurar mapeo personalizado para eventos de Facebook.

Cómo funciona

• El mapeo personalizado está deshabilitado por defecto.
• Al activarlo, puedes mapear:
  • FBCLID (eventos del embudo)
  • Facebook Lead ID (eventos de Lead)
• Si se proporcionan valores personalizados:
  • Tendrán prioridad sobre los valores internos del sistema.
• Si se dejan vacíos:
  • El sistema utilizará los valores predeterminados.

Pruebas y validación

1. Usa la herramienta de prueba de Lead Ads.
2. Selecciona la página y el formulario correctos.
3. Genera un lead de prueba.

4. 

5. Verifica que el evento aparezca en Events Manager.

6. 

7. Mueve el lead a otra etapa del pipeline configurada en el segundo flujo.
8. Confirma:
   • Ejecución correcta del flujo de trabajo
   • Recepción del evento en Events Manager

⏱️ El evento puede tardar hasta 24 horas en reflejarse correctamente.

Nota final importante

Para ambos flujos de trabajo, asegúrate de habilitar la opción:

• "Permitir múltiples" en la configuración del flujo de trabajo.

Esto garantiza que los eventos se envíen correctamente a Facebook CAPI.