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

# Automations e IA

> Cómo coordinar automatizaciones con el agente IA, pausas y handoff humano

# Automations e IA

Las automatizaciones pueden trabajar junto al agente IA.

La parte importante es evitar que dos sistemas respondan al mismo cliente al mismo tiempo.

***

## Problema común: doble respuesta

Un cliente escribe:

```text theme={null}
quiero hablar con un asesor
```

Podrían responder tres cosas:

* una automatización
* el agente IA
* una integración externa

Si no coordinas el flujo, el cliente recibe varias respuestas y la experiencia se rompe.

***

## Herramientas para coordinar

| Configuración            | Para qué sirve                                                |
| ------------------------ | ------------------------------------------------------------- |
| `Omitir IA`              | La automatización se encarga y la IA no responde a ese evento |
| `toggle_ai`              | Activa, apaga o pausa la IA como acción                       |
| `Parar al coincidir`     | Evita que otras automatizaciones también ejecuten             |
| Triggers post-IA         | Reaccionan a cosas que pasan después de la IA                 |
| Control por conversación | Pausa o apaga IA para un hilo específico                      |

Ver [Control de IA](/guides/agent-control) y [Control por Conversación](/api-reference/conversations/ai-control).

***

## Cuándo usar Omitir IA

Activa `Omitir IA` cuando la automatización ya cubre la respuesta del cliente.

Ejemplos:

* fuera de horario
* cliente pide humano
* lead de Meta recibe template
* trigger manda mensaje de bienvenida
* webhook externo se encargará del siguiente paso

<Warning>
  Si una automatización envía mensaje y no omites IA, el agente puede responder también.
</Warning>

***

## Cuándo usar toggle\_ai

Usa la acción `toggle_ai` cuando quieres cambiar el estado de la IA.

| Modo     | Ejemplo                                      |
| -------- | -------------------------------------------- |
| Pausar   | Humano atenderá durante 30 minutos           |
| Apagar   | Cliente VIP requiere atención manual         |
| Encender | El flujo manual terminó y la IA puede volver |

Ejemplo:

```text theme={null}
Trigger: contiene "humano"
Acciones:
1. Agregar tag "requiere-humano"
2. Pausar IA 60 minutos
3. Asignar agente
4. Enviar mensaje corto
```

***

## Triggers relacionados con IA

### User replied to AI

Úsalo cuando quieres reaccionar después de que el usuario responde a la IA.

Casos:

* cliente muestra interés después de una respuesta de IA
* cliente pide aclaración
* cliente pide humano
* quieres mover etapa por respuesta a la IA

### AI scheduled appointment

Úsalo cuando el agente agendó una cita.

Casos:

* mover a etapa `Cita agendada`
* asignar agente
* enviar template de confirmación
* avisar a n8n o CRM

***

## Handoff humano

Un buen handoff hace tres cosas:

<Steps>
  <Step title="Detecta intención">
    Trigger por keyword, respuesta a IA o regla de soporte.
  </Step>

  <Step title="Pausa o apaga IA">
    Usa `Omitir IA` y/o `toggle_ai`.
  </Step>

  <Step title="Asigna responsable">
    Usa `assign_agent` con fallback.
  </Step>

  <Step title="Confirma al cliente">
    Envía un mensaje corto diciendo que una persona lo atenderá.
  </Step>
</Steps>

Mensaje ejemplo:

```text theme={null}
Claro, te paso con una persona del equipo para que te ayude mejor.
```

***

## Patrón recomendado: humano toma control

```mermaid theme={null}
flowchart LR
    message["Cliente pide humano"] --> trigger["Trigger keywords"]
    trigger --> skipAi["Omitir IA"]
    skipAi --> pause["Pausar IA"]
    pause --> assign["Asignar agente"]
    assign --> reply["Mensaje de confirmación"]
```

***

## Patrón recomendado: IA agenda cita

```mermaid theme={null}
flowchart LR
    aiEvent["IA agendó cita"] --> stage["Mover funnel"]
    stage --> assign["Asignar agente"]
    assign --> template["Enviar template"]
    template --> notify["Notificar CRM o n8n"]
```

***

## Errores comunes

| Error                                     | Resultado                      | Mejor enfoque                 |
| ----------------------------------------- | ------------------------------ | ----------------------------- |
| Automation e IA responden juntas          | Cliente recibe doble respuesta | Usa `Omitir IA`               |
| Apagar IA globalmente por casos puntuales | Afectas todo el negocio        | Usa control por conversación  |
| No asignar agente en handoff              | Nadie toma el caso             | Usa `assign_agent`            |
| Pausa demasiado corta                     | La IA vuelve antes de tiempo   | Ajusta duración según proceso |
| No confirmar handoff                      | Cliente no sabe qué pasó       | Envía mensaje corto           |

***

## Enlaces útiles

<CardGroup cols={2}>
  <Card title="colme-2" icon="robot" href="/concepts/colme-2">
    Entiende cómo el agente convive con control, tools y handoff.
  </Card>

  <Card title="Control del Agente" icon="sliders" href="/guides/agent-control">
    Configura pausas, handoff y comportamiento de IA.
  </Card>

  <Card title="Control por Conversación" icon="message" href="/api-reference/conversations/ai-control">
    Controla IA por conversación desde API.
  </Card>

  <Card title="Actions" icon="list-check" href="/guides/automations/actions">
    Diseña acciones seguras para evitar duplicados.
  </Card>
</CardGroup>