> ## 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

> Qué son las automatizaciones de Whaapy y cuándo usarlas para operar conversaciones de WhatsApp

# Automatizaciones

Las automatizaciones de Whaapy te permiten crear reglas tipo **si pasa esto, haz aquello** dentro de WhatsApp.

Sirven para ejecutar acciones repetibles sin depender de que una persona o una integración externa revise cada conversación manualmente.

<Info>
  Las automatizaciones viven en el dashboard de Whaapy en `/automations`. No necesitas llamar al motor interno ni configurar infraestructura para usarlas.
</Info>

***

## Qué resuelven

En un negocio real, muchas acciones se repiten todos los días:

* etiquetar contactos nuevos
* enviar un mensaje de bienvenida
* mover un lead a una etapa del funnel
* pausar la IA cuando interviene un humano
* asignar conversaciones a agentes
* avisar a un CRM o sistema externo
* responder fuera de horario
* procesar leads de Meta Lead Ads

Una automatización convierte esas reglas en un flujo explícito, visible y editable.

```mermaid theme={null}
flowchart LR
    eventNode["Evento en Whaapy"] --> triggerNode["Trigger coincide"]
    triggerNode --> optionsNode["Opciones avanzadas"]
    optionsNode --> actionsNode["Acciones en orden"]
    actionsNode --> resultNode["Resultado para cliente o equipo"]
    actionsNode --> aiNode["Control de IA"]
    actionsNode --> webhookNode["HTTP request o n8n"]
```

***

## Modelo mental

Cada automatización tiene cuatro partes:

| Parte                | Qué define                                                 |
| -------------------- | ---------------------------------------------------------- |
| Nombre y descripción | Para qué existe la regla                                   |
| Trigger              | Qué evento o condición la dispara                          |
| Opciones avanzadas   | Prioridad, ejecución única, omitir IA o parar otras reglas |
| Acciones             | Qué debe pasar cuando coincide                             |

Ejemplo:

```text theme={null}
Trigger:
Cliente escribe "quiero cotizar"

Acciones:
1. Agregar tag "lead-caliente"
2. Mover contacto a etapa "Cotización"
3. Enviar mensaje de bienvenida
4. Asignar agente por round robin
```

***

## Cuándo usar Automations

Usa automatizaciones cuando quieres que Whaapy actúe sobre eventos concretos.

<CardGroup cols={2}>
  <Card title="Reglas repetibles" icon="repeat">
    Etiquetar, mover, asignar o enviar mensajes cuando ocurre algo específico.
  </Card>

  <Card title="Operación comercial" icon="chart-line">
    Clasificar leads, avanzar funnels y dar seguimiento sin hacerlo manualmente.
  </Card>

  <Card title="Control de IA" icon="robot">
    Pausar, apagar o coordinar la IA para evitar dobles respuestas.
  </Card>

  <Card title="Sistemas externos" icon="plug">
    Enviar datos a otros sistemas usando HTTP requests o n8n.
  </Card>
</CardGroup>

***

## Automations vs IA vs Webhooks vs n8n

| Necesidad                                  | Usa                                          |
| ------------------------------------------ | -------------------------------------------- |
| Responder con criterio conversacional      | [Agente IA](/concepts/ai-agent)              |
| Ejecutar una regla simple dentro de Whaapy | Automatizaciones                             |
| Recibir eventos en tu sistema              | [Webhooks](/api-reference/webhooks/overview) |
| Orquestar flujos complejos entre apps      | [n8n](/integrations/n8n)                     |
| Mandar mensajes desde tu app               | [Messages API](/api-reference/messages/send) |

No compiten entre sí. Normalmente se combinan.

Ejemplo:

* una automatización detecta un lead nuevo
* actualiza el contacto
* asigna un agente
* envía un template
* pausa la IA
* avisa a n8n o a tu CRM

***

## Qué puedes automatizar

### Triggers

Una automatización puede dispararse por texto, comportamiento del cliente, cambios de funnel, horarios, eventos de IA o Meta Lead Ads.

<CardGroup cols={2}>
  <Card title="Texto del cliente" icon="message-square">
    Coincidencia exacta, contiene texto, keywords o regex.
  </Card>

  <Card title="Eventos de conversación" icon="messages-square">
    Primer mensaje, respuesta a IA o acciones posteriores al agente.
  </Card>

  <Card title="Funnel y horarios" icon="git-branch">
    Entrada a una etapa del pipeline o rango horario.
  </Card>

  <Card title="Meta Lead Ads" icon="megaphone">
    Lead recibido desde formularios conectados de Meta.
  </Card>
</CardGroup>

Ver [Triggers](/guides/automations/triggers).

### Acciones

Las acciones se ejecutan en orden.

Pueden agregar tags, actualizar campos, mover etapas, enviar mensajes o templates, controlar IA, llamar un webhook, asignar agentes y actualizar datos del contacto.

Ver [Actions](/guides/automations/actions).

***

## Opciones avanzadas

| Opción             | Para qué sirve                                                                 |
| ------------------ | ------------------------------------------------------------------------------ |
| Prioridad          | Decide qué regla se evalúa antes cuando hay varias posibles                    |
| Ejecutar una vez   | Evita repetir la misma regla para el mismo contexto                            |
| Omitir IA          | Evita que el agente responda cuando la automatización ya se encargó            |
| Parar al coincidir | Hace que esta regla sea exclusiva y detenga otras automatizaciones compatibles |

Estas opciones son importantes cuando tienes varias reglas parecidas.

<Warning>
  Si dos automatizaciones responden al mismo mensaje y ninguna detiene a la otra, puedes terminar con acciones duplicadas.
</Warning>

***

## Casos comunes

<CardGroup cols={2}>
  <Card title="Bienvenida a nuevos contactos" icon="hand-wave" href="/guides/automations/getting-started">
    Detecta primer mensaje, etiqueta al contacto y envía respuesta inicial.
  </Card>

  <Card title="Meta Lead Ads" icon="megaphone" href="/guides/automations/meta-leads">
    Convierte leads de formularios en contactos accionables.
  </Card>

  <Card title="Pausa de IA al escalar" icon="pause" href="/guides/automations/ai-handoff">
    Evita que la IA conteste cuando tu equipo toma control.
  </Card>

  <Card title="Webhook a CRM" icon="plug" href="/guides/automations/webhooks-and-n8n">
    Manda datos a sistemas externos o workflows de n8n.
  </Card>
</CardGroup>

***

## Por dónde empezar

<Steps>
  <Step title="Crea una automatización simple">
    Usa un trigger fácil de probar, como `contains` o `keywords`. Ver [Primer flujo](/guides/automations/getting-started).
  </Step>

  <Step title="Agrega una acción segura">
    Empieza con tag, custom field o mensaje interno antes de usar HTTP requests o asignación.
  </Step>

  <Step title="Prueba antes de activar">
    Usa el test del builder para confirmar que el trigger coincide como esperas.
  </Step>

  <Step title="Activa y observa">
    Déjala activa y revisa resultados antes de agregar más reglas parecidas.
  </Step>
</Steps>