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

# Configurar Control

> Cómo configurar la tab Control del agente IA de Whaapy

# Configurar Control

La tab `Control` define cuándo puede responder la IA, cuándo debe detenerse y cómo convive con tu equipo humano.

Configura esto antes de poner el agente en producción. Si `Control` está mal definido, el agente puede responder cuando no debe, interrumpir a humanos o contestar antes de que el cliente termine de escribir.

***

## Qué se configura aquí

| Configuración              | Para qué sirve                                                                            |
| -------------------------- | ----------------------------------------------------------------------------------------- |
| Motor del agente           | Elegir la generación del agente, por ejemplo `colme-1` o `colme-2` cuando esté disponible |
| IA activa                  | Encender o apagar la IA para el negocio                                                   |
| Pausa automática           | Detener la IA después de una intervención humana o externa                                |
| Batching de mensajes       | Esperar varios mensajes cercanos antes de responder                                       |
| Memoria conversacional     | Permitir que el agente use contexto reciente de la conversación                           |
| Handoff                    | Transferir a humano cuando el caso lo requiere                                            |
| Keywords de escalación     | Detectar frases como "quiero hablar con alguien"                                          |
| Split de respuestas largas | Partir respuestas extensas en varios mensajes de WhatsApp                                 |

<Info>
  `Control` no define lo que el agente sabe. Eso va en [Knowledge](/guides/agent-knowledge). Tampoco define acciones externas. Eso va en [Tools](/guides/agent-tools) o [MCPs](/guides/agent-mcps).
</Info>

***

## Configuración recomendada

<Steps>
  <Step title="Elige el motor">
    Usa `colme-2` para nuevos agentes o para negocios donde necesitas mejor control de tools, handoff, batching y memoria.
  </Step>

  <Step title="Activa la IA">
    Enciende la IA solo cuando ya tengas prompt, knowledge y reglas mínimas de handoff.
  </Step>

  <Step title="Configura batching">
    Activa batching si tus clientes suelen mandar varios mensajes seguidos. Una ventana corta evita que el agente responda a mitad de la idea.
  </Step>

  <Step title="Define pausa humana">
    Activa pausa automática cuando tu equipo responda manualmente. Esto evita dobles respuestas entre humano e IA.
  </Step>

  <Step title="Configura handoff">
    Activa handoff si hay casos que deben pasar a ventas, soporte, cobranza o una persona específica.
  </Step>

  <Step title="Prueba respuestas largas">
    Activa split de respuestas largas si el agente suele explicar procesos, cotizaciones o instrucciones extensas.
  </Step>
</Steps>

***

## Motor del agente

| Motor     | Cuándo usarlo                                                                 |
| --------- | ----------------------------------------------------------------------------- |
| `colme-1` | Flujos legacy que todavía no quieres migrar                                   |
| `colme-2` | Nuevos agentes, uso de tools, subagents, MCPs, batching y handoff más robusto |

<Tip>
  Si estás configurando un agente desde cero, empieza con `colme-2`.
</Tip>

***

## Activar o apagar la IA

La activación global decide si el agente puede responder en el negocio.

* **Activo**: el agente puede responder según las reglas de cada conversación.
* **Inactivo**: la IA no responde en ninguna conversación del negocio.

Apagar la IA globalmente es útil para mantenimiento, revisión de configuración o incidentes operativos.

Si solo quieres detener una conversación específica, usa pausa o apagado por conversación desde el inbox o la API de [Control por Conversación](/api-reference/conversations/ai-control).

***

## Pausa automática

La pausa automática evita que la IA conteste encima de un humano.

Actívala cuando:

* tu equipo responde desde el inbox
* una integración externa manda mensajes
* hay procesos que requieren revisión manual
* el cliente pidió hablar con una persona

Recomendación inicial:

| Tipo de negocio    | Duración sugerida |
| ------------------ | ----------------- |
| Soporte rápido     | 15 a 30 minutos   |
| Ventas consultivas | 30 a 120 minutos  |
| Casos sensibles    | 4 a 24 horas      |

<Warning>
  No uses pausas enormes como sustituto de apagar la IA. Si un flujo siempre debe ser manual, desactiva la IA en esa conversación o configura handoff.
</Warning>

***

## Batching de mensajes

El batching agrupa mensajes cercanos antes de que el agente responda.

```text theme={null}
Cliente: Hola
Cliente: quiero una cita
Cliente: para el viernes
Cliente: en la tarde
```

Sin batching, la IA puede responder demasiado pronto. Con batching, el agente espera una ventana breve y entiende el bloque completo.

| Campo              | Recomendación                           |
| ------------------ | --------------------------------------- |
| Activar batching   | Sí, para WhatsApp casi siempre conviene |
| Ventana            | 3 a 8 segundos                          |
| Máximo de mensajes | 3 a 6 mensajes                          |

Usa ventanas más cortas para soporte urgente y más largas para ventas o agendamiento.

***

## Memoria conversacional

La memoria permite que el agente use contexto reciente para mantener continuidad.

Actívala cuando:

* el cliente vuelve a preguntar sobre lo mismo
* el flujo tiene varios pasos
* la conversación incluye preferencias o datos previos
* el agente necesita entender el historial reciente

No la uses para guardar datos sensibles que deberían vivir en un sistema transaccional. Para datos operativos, usa `Tools` o `MCPs`.

***

## Handoff y keywords

El handoff define cuándo la conversación debe pasar a una persona.

Keywords útiles:

```text theme={null}
humano
asesor
agente
persona real
quiero hablar con alguien
llámame
queja
cancelar servicio
```

Buenas prácticas:

* incluye variantes reales que usan tus clientes
* no metas keywords demasiado genéricas como "ayuda"
* combina keywords con reglas del subagent de soporte si el flujo es complejo
* activa `desactivar IA al transferir` si tu equipo tomará el caso manualmente

***

## Split de respuestas largas

WhatsApp se siente mejor cuando las respuestas largas se parten en bloques legibles.

Activa split si el agente responde instrucciones paso a paso, cotizaciones, políticas extensas, listas de productos o explicaciones de procesos.

| Campo        | Valor sugerido        |
| ------------ | --------------------- |
| Split activo | Sí                    |
| Umbral       | 800 a 1500 caracteres |

***

## Errores comunes

| Error                       | Qué pasa                                 | Cómo corregirlo                                                    |
| --------------------------- | ---------------------------------------- | ------------------------------------------------------------------ |
| Activar IA sin knowledge    | El agente responde genérico              | Configura [Knowledge](/guides/agent-knowledge) antes de producción |
| Batching apagado            | Responde antes de que el cliente termine | Activa batching con ventana corta                                  |
| Sin pausa humana            | Humano e IA contestan al mismo tiempo    | Activa pausa automática                                            |
| Keywords genéricas          | Escala demasiadas conversaciones         | Usa frases específicas                                             |
| No partir respuestas largas | Mensajes pesados y difíciles de leer     | Activa split                                                       |

***

## API relacionada

<CardGroup cols={2}>
  <Card title="Agente IA" icon="robot" href="/api-reference/agent/overview">
    Endpoints globales para activar, pausar y generar sugerencias.
  </Card>

  <Card title="Control por Conversación" icon="message" href="/api-reference/conversations/ai-control">
    Pausa o desactiva la IA en conversaciones específicas.
  </Card>
</CardGroup>
