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

# Agente IA

> Controla el agente de IA que responde automáticamente a tus clientes

El agente de IA de Whaapy responde automáticamente a los mensajes de tus clientes usando tu knowledge base, personalidad configurada y contexto de la conversación.

Esta sección documenta los endpoints para **controlar** el agente desde sistemas externos (n8n, Zapier, CRMs, etc.).

<Info>
  Si estás configurando el agente desde el dashboard, empieza por la guía de [Control](/guides/agent-control). Para entender el motor nuevo del agente, lee [colme-2](/concepts/colme-2).
</Info>

## Guías de configuración

<CardGroup cols={2}>
  <Card title="Control" icon="sliders" href="/guides/agent-control">
    Define cuándo responde la IA, cuándo se pausa y cómo convive con humanos.
  </Card>

  <Card title="Knowledge" icon="book-open" href="/guides/agent-knowledge">
    Alimenta al agente con documentos, FAQs, políticas y contexto del negocio.
  </Card>

  <Card title="Tools" icon="wrench" href="/guides/agent-tools">
    Habilita acciones reales como agenda, catálogo, triggers y handoff.
  </Card>

  <Card title="Subagents y MCPs" icon="diagram-project" href="/concepts/subagents-and-tools">
    Entiende cómo dividir responsabilidades y conectar sistemas externos.
  </Card>
</CardGroup>

## Endpoints

<CardGroup cols={2}>
  <Card title="Activar/Desactivar" icon="power-off" href="/api-reference/agent/toggle">
    Toggle global de la IA para todo el negocio
  </Card>

  <Card title="Pausar" icon="pause" href="/api-reference/agent/pause">
    Pausa temporal global con reactivación automática
  </Card>

  <Card title="Sugerencias" icon="lightbulb" href="/api-reference/agent/suggestions">
    Generar respuestas sugeridas sin enviar
  </Card>

  <Card title="Control por Conversación" icon="message" href="/api-reference/conversations/ai-control">
    Controlar la IA en conversaciones individuales
  </Card>
</CardGroup>

## Scopes Requeridos

| Endpoint                 | Scope                 |
| ------------------------ | --------------------- |
| Activar/Desactivar       | `agent:write`         |
| Pausar                   | `agent:write`         |
| Sugerencias              | `conversations:write` |
| Control por conversación | `conversations:write` |

## Flujo de Prioridades

Cuando llega un mensaje, el agente evalúa los controles en este orden:

```mermaid theme={null}
flowchart TD
    A[Mensaje Recibido] --> B{Pausa Global?}
    B -->|Sí| X[IA No Responde]
    B -->|No| C{IA Global ON?}
    C -->|No| X
    C -->|Sí| D{Pausa en Conversación?}
    D -->|Sí| X
    D -->|No| E{IA ON en Conversación?}
    E -->|No| X
    E -->|Sí| F[IA Responde]
```

<Note>
  Si cualquier nivel está pausado o desactivado, la IA no responderá. La prioridad es: **global > conversación**.
</Note>

## Casos de Uso

<AccordionGroup>
  <Accordion title="Handoff a humano">
    Cuando un agente humano toma el control, desactiva la IA para evitar respuestas automáticas.
  </Accordion>

  <Accordion title="Integración con CRM">
    Tu CRM puede pausar la IA mientras procesa tickets o envía respuestas automáticas.
  </Accordion>

  <Accordion title="Modo Copilot">
    Usa sugerencias de IA para asistir a agentes humanos sin enviar automáticamente.
  </Accordion>

  <Accordion title="Automatizaciones">
    n8n/Zapier pueden pausar la IA mientras ejecutan flujos personalizados.
  </Accordion>
</AccordionGroup>