Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.whaapy.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Automatizaciones con Meta Lead Ads

Las automatizaciones con Meta Lead Ads te permiten actuar cuando llega un lead desde Facebook o Instagram. Puedes crear o actualizar el contacto, mapear campos del formulario, asignar agente, mover el lead a una etapa, enviar un template y notificar a sistemas externos.

​
Antes de empezar

Necesitas:
La integración de Meta Lead Ads conectada.
Páginas y formularios sincronizados.
Templates aprobados si quieres contactar al lead fuera de la ventana permitida.
Campos del formulario claros: nombre, teléfono, email y preguntas relevantes.
Si todavía no ves formularios, revisa la integración en el dashboard: Integraciones -> Meta Lead Ads.

​
Trigger

Usa el trigger meta_lead_received. Puedes configurarlo de tres formas:
ConfiguraciónResultado
Sin página ni formularioCualquier lead sincronizado
Página específicaLeads de esa página
Uno o varios formulariosSolo leads de esos formularios
Si tienes campañas con objetivos distintos, crea una automatización por formulario. Es más fácil medir y mantener.

​
Flujo recomendado

​
Paso 1: Actualizar contacto

Usa update_contact para mapear respuestas del formulario hacia campos del contacto. Ejemplo: 
{{lead.field.full_name}} -> name
{{lead.field.email}} -> email
{{lead.field.company}} -> company
{{lead.field.city}} -> city
{{lead.field.budget}} -> custom:presupuesto
El builder puede sugerir mappings cuando seleccionas un formulario específico.
El teléfono normalmente se usa para crear o encontrar el contacto. No necesitas mapearlo manualmente salvo que tengas un caso especial.

​
Paso 2: Clasificar el lead

Acciones útiles:
  • add_tag: meta-lead, campaña-abril, lead-frio, lead-caliente
  • set_custom_field: guardar campaña, presupuesto o servicio de interés
  • move_funnel_stage: mover a Nuevo lead, Contactar, Cotización
Mantén una convención simple para tags. Evita crear tags distintos para lo mismo.

​
Paso 3: Asignar agente

Usa assign_agent si alguien debe atender el lead. Modos recomendados:
ModoCuándo usarlo
fixedUn solo responsable para esa campaña
round_robinRepartir leads entre vendedores
least_loadedBalancear carga activa
randomReparto simple sin prioridad
Configura fallback para evitar que un lead quede sin dueño.

​
Paso 4: Enviar template

Si vas a escribir al lead por WhatsApp y no hay ventana activa, usa send_template. Ejemplo: 
Hola {{contact.first_name}}, vimos que solicitaste información. Soy {{agent.first_name}} de Whaapy, ¿te puedo ayudar por aquí?
Si el template tiene variables, usa Variables para llenar nombre, agente, servicio o campaña.

​
Paso 5: Notificar a sistemas externos

Si tu CRM o equipo necesita enterarse:
  • usa http_request para un webhook directo
  • usa n8n si el flujo tiene varios pasos
  • manda solo los datos necesarios
Payload ejemplo: 
{
  "source": "meta_lead_ads",
  "name": "{{contact.name}}",
  "phone": "{{contact.phoneNumber}}",
  "email": "{{lead.field.email}}",
  "agent": "{{agent.email}}"
}

​
Opciones avanzadas

OpciónRecomendación
Ejecutar una vezActivar si el mismo lead no debe procesarse varias veces
Omitir IAActivar si envías template o asignas humano inmediatamente
Parar al coincidirActivar si este flujo no debe combinarse con otras reglas
PrioridadAlta si el lead debe procesarse antes de otras automatizaciones

​
Errores comunes

ErrorResultadoMejor enfoque
Usar cualquier formulario para todoLeads mal clasificadosCrea reglas por formulario
No mapear email o empresaContactos incompletosUsa update_contact
Sin fallback de agenteLeads sin responsableDefine fallback
Enviar texto libre fuera de ventanaMensaje fallaUsa template aprobado
No probar payload externoCRM recibe datos incompletosUsa test webhook

​
Siguiente paso

Si el lead debe pasar a CRM, revisa Webhooks y n8n.