Configurar Meta CAPI (Pixel) y workflows de conversión

Conecta Pixel/Dataset ID y token CAPI, y envía eventos Purchase, Lead o Schedule desde workflows al cambiar de etapa.

¿Para qué sirve?

NovaFlow puede enviar eventos de conversión a Meta (Conversions API / CAPI) cuando ocurren hitos en tu CRM — por ejemplo una cita agendada, un lead calificado o una venta cerrada. Así Meta puede optimizar tus anuncios con datos del servidor, no solo del navegador.

Esta guía es genérica: cada workspace tiene sus propios pipelines, nombres de etapas y columnas en Oportunidades. Tú eliges en el workflow qué pipeline y qué etapa disparan cada evento.

Antes de empezar

Rol Admin (o permiso para Ajustes > Integraciones y Workflows).
Acceso a Meta Events Manager del negocio (Pixel o Dataset y token CAPI).
Saber qué etapa de tu embudo representa cada hito (ej. «Cita agendada», «Ganado», etc.) — los nombres varían por cuenta.

Parte 1 — Pixel ID y token CAPI (una vez por workspace)

Paso 1: Obtén el Pixel/Dataset ID en Meta

1. Entra a Meta Events Manager.

2. Selecciona el Pixel o Dataset de tu negocio.

3. Copia el ID numérico (aparece en Configuración o en la URL del recurso).

Paso 2: Genera el token de Conversions API

1. En el mismo dataset, abre Configuración → Conversions API.

2. Genera un token de acceso para envío de eventos desde servidor.

3. Cópialo en un lugar seguro — Meta solo lo muestra completo al crearlo.

> El token de Events Manager sirve para enviar eventos (CAPI). No es el mismo que conectar Facebook para Inbox o Lead Ads en la tarjeta Meta.

Paso 3: Configura NovaFlow

1. En NovaFlow, ve a Ajustes > Integraciones (`/settings/integrations`).

2. Baja hasta la sección Conversiones offline (CRM).

3. Pega el Meta Pixel/Dataset ID.

4. Pega el Meta CAPI token (campo de contraseña; si ya había uno guardado, déjalo vacío para conservarlo).

5. Elige Envío de conversiones Meta:

Automático al ganar oportunidad — al marcar una oportunidad como ganada, NovaFlow envía `Purchase` (comportamiento clásico).
Solo desde workflows — desactiva ese envío automático; tú controlas cada evento con workflows (recomendado si configuras varios eventos o quieres evitar duplicados).

6. Opcional: activa Enviar conversión offline a Meta al ganar un deal si usas el modo automático.

7. Pulsa Guardar y luego Probar conexión Meta. Deberías ver Meta CAPI: OK.

Sección Conversiones offline con Pixel ID y token CAPI

Paso 4: Código de prueba (recomendado al validar)

En Meta Events Manager → pestaña Test events, copia tu código de prueba (ej. `TEST12345`). Lo usarás temporalmente en el workflow para ver eventos en segundos sin ensuciar datos de producción. Quítalo cuando termines las pruebas.

Parte 2 — Workflow que envía eventos a Meta

Usa workflows cuando quieres enviar eventos en etapas intermedias (cita, propuesta, etc.) o controlar manualmente qué se envía y cuándo.

Paso 1: Crear o abrir un workflow

1. Ve a Workflows (`/workflows`).

2. Crea un workflow nuevo o edita uno existente.

3. Activa el interruptor Activo cuando esté listo.

Paso 2: Elegir el disparador (etapa de oportunidad)

1. Disparador: Etapa de oportunidad cambiada.

2. Pipeline: elige el embudo de tu negocio (cada cuenta puede tener nombres distintos: Ventas, Admisiones, etc.).

3. Etapa destino: la columna que representa el hito que quieres reportar a Meta (ej. la etapa donde cae una oportunidad al agendar cita — el nombre exacto lo defines tú en Oportunidades > Etapas).

> Si renombras una etapa en el tablero, el workflow sigue funcionando: NovaFlow guarda el ID interno de la etapa, no solo el nombre visible.

Haz clic en el nodo Trigger del editor para abrir el panel lateral de configuración.

Disparador: etapa de oportunidad cambiada con pipeline y etapa destino

Paso 3: Añadir la acción «Enviar evento a Meta»

1. Añade una acción: Enviar evento a Meta.

2. Evento de Meta (lista desplegable):

`Purchase` — venta / inscripción cerrada (suele usarse en etapa ganada).
`Lead` — lead calificado.
`Schedule` — cita o reunión agendada.
Evento personalizado… — si tu dataset ya recibe otro nombre en Meta.

3. Valor del evento:

Valor de la oportunidad — envía el monto del deal.
Valor fijo — monto constante.
Sin valor — típico para `Schedule` o `Lead`.

4. Origen del evento: deja Automático salvo que tu implementador indique otro valor. Si el contacto llegó por Click-to-WhatsApp, NovaFlow incluye la atribución correspondiente.

5. Código de prueba (opcional): pega el código de Test events mientras validas.

6. Casillas recomendadas:

Enviar solo si el contacto tiene atribución de Meta — activada si solo quieres leads de anuncios (`fbclid`, `ctwa_clid` o Lead Ad).
Enviar solo una vez por oportunidad — evita duplicados si la oportunidad vuelve a entrar en la misma etapa.
Fallar el workflow si el envío a Meta falla — desactivada en la mayoría de casos; un fallo de Meta no debería bloquear tu operación en CRM.

Haz clic en el nodo de la acción (debajo del trigger) para configurar el evento de Meta.

Acción Enviar evento a Meta: evento Schedule, valor y opciones

Paso 4: Guardar y probar

1. Guarda el workflow.

2. Con el código de prueba en Meta abierto, mueve una oportunidad de prueba (con atribución Meta si dejaste ese filtro) a la etapa configurada.

3. Revisa Test events en Meta — el evento debería aparecer en segundos.

4. Quita el código de prueba del workflow y guarda de nuevo para producción.

Ejemplos habituales (adapta nombres a tu cuenta)

| Objetivo en Meta | Disparador sugerido | Evento |

|------------------|---------------------|--------|

| Cita agendada | Etapa = tu columna de «cita» o «reunión» | `Schedule` |

| Venta cerrada | Etapa ganada o disparador «Oportunidad ganada» | `Purchase` |

| Lead calificado | Etapa = contactado / calificado | `Lead` |

Los nombres de columnas no son fijos en NovaFlow: configura el pipeline y las etapas que ya usas en Oportunidades, y selecciónalos en el workflow.

Evitar eventos duplicados

Si usas workflows para `Purchase`, pon Solo desde workflows en Integraciones.
Mantén activa Enviar solo una vez por oportunidad en la acción Meta.
No dejes el código de prueba en producción.

¿Qué deberías ver?

En Meta Test events (con código de prueba): eventos al mover oportunidades de prueba.
En Meta Overview (producción): nuevos tipos de evento pueden tardar desde minutos hasta horas en aparecer en la lista.
En NovaFlow: actividad en el contacto cuando el envío fue exitoso.

Preguntas frecuentes

¿El campo del token aparece vacío después de guardar? Es normal: por seguridad no se muestra el token guardado. Si no escribes uno nuevo, se conserva el anterior.

¿Necesito conectar la tarjeta Meta de Integraciones? Para mensajes y Lead Ads, sí. Para CAPI con Pixel + token en esta sección, es configuración aparte; ambas pueden coexistir.

¿Funciona con leads de WhatsApp (Click-to-WhatsApp)? Sí. NovaFlow envía la atribución del contacto cuando está disponible.

¿Puedo enviar eventos de oportunidades que ya estaban en la etapa? Los workflows se disparan al cambiar de etapa. Oportunidades que ya estaban en la columna antes de activar el workflow no se reprocesan solas; mueve una de prueba o consulta a tu administrador si necesitas un backfill puntual.

¿Por qué no veo el evento en Overview de Meta? Los eventos nuevos por CAPI pueden tardar. Usa Test events para validar en vivo.

¿Google Ads también se configura aquí? Google usa la conexión sGTM existente; esta pantalla es principalmente para Meta CAPI.