# Agente IA

Asistente que atiende WhatsApp (y el widget de chat web, si está activo)
vendiendo el catálogo del negocio, respondiendo preguntas de clientes y
escalando a un humano cuando hace falta. Es distinto del copilot de ayuda
del sistema: este agente atiende a los CLIENTES del negocio, no a los
usuarios del panel.

## Bandeja (Agente → bandeja principal)

Lista de conversaciones con clientes. Cada conversación tiene un modo:

- **Bot**: el agente IA responde solo.
- **Humano**: un usuario del negocio tomó la conversación; el bot no
  responde hasta que se vuelva a activar.
- **Pausado**: el bot se detiene temporalmente (p. ej. mientras alguien
  revisa un caso) sin pasar formalmente a modo humano.

Sobre cada mensaje: click derecho para **responder citando**, copiar,
reenviar o eliminar.

Sobre el contacto de la conversación hay un botón para **crear o
vincular el cliente** correspondiente (mismo modal de alta rápida que
usan otras pantallas) — así una conversación de WhatsApp/webchat con
alguien que todavía no es cliente registrado se liga a su ficha sin salir
de la bandeja. Ver doc `clientes`, sección "Ficha inteligente del
cliente", para lo que esa ficha hace con la conversación una vez ligada
(seguimientos, resumen de conversaciones, timeline).

## Canales (Agente → Canales)

Conecta los canales por los que el agente atiende: número de WhatsApp
(vía Meta), Telegram, y/o el widget de chat embebible para el sitio web. Un
negocio puede tener varios canales activos a la vez.

## Configuración (Agente → Configuración)

Perfil del negocio para el agente (rubro, tono, políticas de envío/devolución),
FAQ propias, reglas de negocio y qué información puede compartir (por
ejemplo, métodos de pago: solo se ofrecen las cuentas bancarias marcadas
como visibles al agente en el módulo **Banco**).

## Cobranza (Agente → Cobranza)

Envío automático de recordatorios de pago por WhatsApp para facturas de
crédito vencidas. El envío saliente usa **siempre** una plantilla de Meta
aprobada (no es libre ni generada por IA, porque fuera de la ventana de 24h
WhatsApp rechaza texto libre). Cuando el cliente responde, ahí sí entra la
IA: puede consultar su estado de cuenta y responder preguntas sobre lo que
debe.

## Leads (Agente → Leads)

Notifica al equipo de ventas cuando el agente detecta una conversación con
intención de compra que necesita seguimiento humano. También usa plantilla
Meta aprobada configurable en la misma página.

## Envíos (Agente → Envíos)

Configura las zonas y costos de envío que el agente ofrece al cotizar un
pedido por WhatsApp/widget.

### Agregar una zona de envío

**Agente → Envíos → Nueva zona de envío**: una zona es UNA ciudad (con su
departamento opcional), y dentro de ella agregas uno o más **métodos de
envío** (nombre, costo, nota) — por ejemplo "Delivery" a C$50 y "Retiro en
tienda" a C$0 para la misma ciudad. No se puede repetir la misma ciudad
dos veces: si ya existe una zona para esa ciudad, edítala en vez de crear
otra.

### Importar varias de una vez

**Importar CSV** carga muchas zonas a la vez (departamento, ciudad,
método, costo, nota). Si una ciudad del archivo ya existía, sus métodos
se **reemplazan por completo** con lo que traiga el CSV — no se suman a
los que ya tenía.

## Notificaciones (campana)

La campana del panel avisa en tiempo real (más un respaldo si el
WebSocket falla) de 4 eventos: pedido web nuevo (WooCommerce/Shopify),
seguimiento de cliente vencido, conversación nueva (WhatsApp o webchat),
y lead nuevo detectado por el agente. Cuando el evento tiene un dueño
claro (p. ej. un seguimiento con responsable asignado) notifica solo a
esa persona; si no, notifica a todo el negocio. Click en la notificación
de conversación nueva abre esa conversación directo en la bandeja.

## Métricas (Agente → Métricas)

Volumen de conversaciones, tasa de resolución por el bot vs. escalado a
humano, y tiempo de respuesta.

## Errores comunes

- **El agente no responde**: revisa que la conversación no esté en modo
  **humano** o **pausado**.
- **El agente no menciona una promoción/método de pago que sí existe**:
  revisa que esté marcado como visible al agente (`agent_visible`) en el
  módulo correspondiente (Promociones, Banco).
- **No llegó la notificación de cobranza/lead**: sin plantilla de Meta
  aprobada configurada, el envío se bloquea silenciosamente por WhatsApp —
  revisa la plantilla configurada en Cobranza/Leads.