Integración con Meta Ads

Vixiees se integra con Meta Ads (Facebook/Instagram Lead Ads) para capturar leads automáticamente desde formularios de anuncios.

Conectar Meta Ads

Requisitos

Cuenta de Facebook Business con acceso a la página
Permisos de administrador en la página de Facebook
Formularios Lead Ads configurados

Pasos para conectar

Ve a Configuración > Integraciones > Meta Ads
Haz clic en Conectar con Facebook
Inicia sesión en tu cuenta de Facebook
Selecciona las páginas que deseas conectar
Autoriza los permisos solicitados

Datos sincronizados

Al conectar, Vixiees obtiene:

Lista de páginas de Facebook
Formularios Lead Ads de cada página
Campos de cada formulario

Reconectar la integración

Si Meta Ads ya está conectado, el botón cambia a Reconectar. Al hacer clic, aparece un aviso de confirmación: reconectar vuelve a vincular los formularios y puede provocar pérdida de datos, así que solo debe hacerse si se ha cambiado de cuenta de Facebook o es necesario refrescar los permisos.

Dar permisos no siempre basta: "Clientes potenciales" en Meta

Es habitual conectar la integración, conceder todos los permisos que pide Meta, y aun así que los leads no lleguen. La causa más frecuente: la página de Facebook no tiene aceptados los Términos de Servicio de Lead Ads (lo que Meta llama acceso a "Clientes potenciales"), un ajuste independiente de los permisos generales de conexión.

Vixiees no muestra ningún aviso en pantalla cuando falta este paso — la página puede aparecer conectada con normalidad y aun así no recibir ningún lead.

Cómo comprobarlo y activarlo: en Meta Business Suite, entra en la configuración de la página de Facebook y busca la sección de acceso a clientes potenciales / Lead Ads — acepta los términos pendientes ahí. Si el problema persiste, reconecta la integración en Vixiees después de activarlo en Meta.

Configurar formularios

Cada formulario debe configurarse para mapear sus campos a Vixiees.

Mapeo de campos

Selecciona el formulario en la lista
Para cada campo del formulario, elige el atributo de contacto correspondiente
Asegúrate de mapear email o teléfono (obligatorio)
Opcionalmente, asigna un playbook y estado inicial
Guarda los cambios

Campos obligatorios

Cada formulario debe tener mapeado al menos:

Email o
Teléfono

Sin estos campos, los leads se ignorarán.

Captura de leads

Flujo automático

Cuando un usuario completa un formulario Lead Ads:

Meta envía los datos a Vixiees via webhook
Vixiees busca o crea el contacto
Se aplica el mapeo de campos configurado
Se asigna al playbook y estado indicados
El contacto queda disponible para el equipo comercial

Cómo se reconoce un contacto existente

Vixiees busca un contacto con el mismo email o teléfono recibido en el formulario — basta con que coincida uno de los dos, no hace falta que coincidan ambos.

Qué pasa con los datos del contacto

Si el nuevo envío trae un valor no vacío para un campo (nativo o personalizado), ese valor sobrescribe el que ya tenía el contacto. Si el formulario no incluye ese campo, el valor existente se conserva sin cambios.

Ten esto en cuenta si alguien corrige un dato a mano en la ficha del contacto: un reenvío posterior del mismo formulario puede pisar esa corrección si el formulario trae un valor distinto para ese campo.

Cambio de playbook al reenviar el formulario

Que el contacto se mueva o no al playbook/estado configurado en el formulario depende del ajuste "Comportamiento con contacto existente", con 3 opciones:

Opción	Qué hace
Nunca mover	El contacto se actualiza pero se queda en su playbook/estado actual
Mover siempre	El contacto se reasigna al playbook/estado del formulario en cada reenvío
Mover solo si está Ganado o Perdido	No molesta a un contacto en proceso activo, pero reengancha automáticamente a quien ya estaba cerrado

Tarea automática de reenvío

Si el playbook actual del contacto tiene activa una plantilla de tarea de reenvío de formulario, se crea automáticamente al detectar que un contacto ya existente volvió a rellenar el formulario — útil para que el vendedor sepa que el lead volvió a mostrar interés.

Se registra el envío del formulario en el historial del contacto en todos los casos

Playbooks y asignación

Configuración por formulario

Cada formulario puede tener:

Campo	Descripción
Playbook	A qué playbook asignar los leads
Estado inicial	En qué estado del playbook empiezan

Sin configuración

Si no se configura playbook, se usa el playbook por defecto de la cuenta.

Información de anuncios

Si tienes permisos de lectura de anuncios, Vixiees puede capturar:

Campo	Descripción
Nombre del anuncio	El anuncio que generó el lead
Grupo de anuncios	El conjunto de anuncios
Página	La página de Facebook

Esta información aparece en el historial del contacto.

Permisos necesarios

Para obtener datos de anuncios:

ads_management
ads_read

Campos personalizados

Además de los campos estándar, puedes mapear:

Campos personalizados del formulario
Atributos personalizados de Vixiees

El mapeo es flexible y permite cualquier combinación.

Historial de formularios

Cada envío de formulario se registra en el contacto:

Fecha y hora del envío
Formulario utilizado
Respuestas completas
Información del anuncio (si está disponible)

Registro de webhooks

Cada vez que Meta envía un lead a Vixiees, el evento queda registrado en la pestaña Registro de webhooks de la integración, con el resultado exacto de ese envío.

Qué muestra cada entrada

Fecha del evento
Formulario de origen
Resultado: contacto creado, contacto actualizado, error, u omitido
Si el evento creó o actualizó un contacto, un enlace directo a esa ficha
Identificadores técnicos (página, formulario, leadgen, anuncio, grupo de anuncios) y el payload recibido

Cuando un lead no crea un contacto

Si el evento no genera ni actualiza un contacto, el registro explica el motivo exacto:

Motivo	Qué significa
La página del webhook no pertenece a ninguna cuenta con la integración activa	Se desconectó la página o el webhook llegó a la cuenta equivocada
No se encontró la página o el formulario en esta cuenta	Falta configuración
El formulario no está configurado	Ningún campo de email ni teléfono mapeado
La cuenta está desactivada	El evento se omitió; es un comportamiento esperado, no un error
La llamada a la API de Meta falló	El token caducó o la petición expiró — puede requerir reconectar
Error interno al crear o actualizar el contacto	Error inesperado; si se repite, contacta con soporte
No se pudo leer el payload	Meta envió un evento con un formato no reconocido

Cada motivo incluye en la propia pantalla una sugerencia de qué revisar o corregir.

Campos con errores en un contacto creado

Un contacto puede crearse o actualizarse correctamente y aun así tener uno o más campos personalizados que no se pudieron guardar (por ejemplo, un valor que no coincide con las opciones configuradas). En ese caso, la entrada del registro muestra cuántos campos fallaron junto al resultado, sin necesidad de revisar un listado aparte.

Conclusión

La integración con Meta Ads permite:

Capturar leads automáticamente desde Facebook e Instagram
Mapear campos de forma flexible
Asignar leads al playbook correcto
Mantener historial completo de formularios
Diagnosticar exactamente por qué un lead no creó un contacto, evento a evento

Escenarios relevantes

Campañas de captación: Leads de anuncios llegan directamente a Vixiees
Múltiples formularios: Cada formulario puede ir a un playbook diferente
Seguimiento de campañas: Identificar qué anuncio generó cada lead