Saltar al contenido

WhatsApp AI

Configura el asistente de WhatsApp para atención y automatizaciones.

8 min de lectura

Guía desde cero para dejar operativo el gateway de WhatsApp y el Agente Ai de atención al cliente.

Antes de empezar:

  • Permiso settings_access.
  • Una API Key de LLM (DeepSeek, OpenAI, Anthropic, Gemini) o Ollama local.
  • Credenciales del proveedor WhatsApp que vayas a usar (Meta, Evolution, Twilio, Waboxapp o 360dialog).
  • Empresa asignada al usuario (el canal queda ligado a esa empresa).

1. Abrir el módulo

  1. Menú Ajustes → Integraciones → WhatsApp AI.
  2. Entras a /whatsapp-ai.

Vista: WhatsApp AI

Verás:

  • Título WhatsApp AI y subtítulo Gateway, Agente Ai y conversaciones automatizadas.
  • Acciones rápidas: Conectar numero, Configurar IA, Ver chats, Reglas.
  • Pestañas: Gateway, Conexion, Agente Ai, Automatizaciones, Base de conocimiento, Plantillas WhatsApp, Reportes.
  • En Gateway: KPIs (Numeros conectados, Conversaciones activas, Requieren humano, Agente Ai activo, Tasa de resolucion IA).

2. Conectar el número (pestaña Conexion)

  1. Abre Conexion (o pulsa Conectar numero).
  2. En Configuracion de conexion elige Proveedor:
    • Meta Cloud API
    • Evolution API (común con QR)
    • Twilio
    • Waboxapp
    • 360dialog
  3. Completa según el proveedor:
Campo UI Obligatorio Notas
Proveedor Sí Determina qué campos aparecen
Numero de WhatsApp Sí (salvo Evolution QR) Formato del proveedor / E.164
Empresa Sí Empresa propietaria del canal
Modo Sí Sandbox (IA responde sin enviar a WhatsApp real) o Produccion
Token de acceso Según proveedor API token / access token
Webhook URL Automático Cópialo al panel del proveedor
Webhook Secret Según proveedor Validación de eventos
URL / clave de instancia Evolution personalizada En Configuraciones avanzadas
  1. Evolution: elige Evolution del servidor o Instancia personalizada. Si es personalizada, llena URL de instancia Evolution y Clave / nombre de instancia.
  2. Pulsa Probar. Si Evolution pide vinculación, usa Escanear QR y escanea con el WhatsApp Business del número.
  3. Cuando el chip Estado WhatsApp / Sesion deje de estar en espera: Guardar o Guardar y activar.

Importante: Solo un módulo WhatsApp puede estar activo. Al activar este canal, el otro se desactiva.

Checklist de conexión:

  • Proveedor seleccionado y credenciales guardadas
  • Webhook configurado en el proveedor (si aplica)
  • Prueba OK / QR vinculado
  • Canal en Produccion solo cuando vayas a enviar mensajes reales

3. Configurar el Agente Ai

  1. Pestaña Agente Ai → subtítulo Configuracion.
  2. Activa el switch Agente activo.
  3. En Motor IA completa:
Campo Recomendado inicio
Proveedor DeepSeek (u otro con saldo)
Modelo Ej. deepseek-chat
API Key Obligatoria (excepto Ollama)
Temperatura 0.3 (más preciso)
Max. tokens 1024
Idioma Español
Deteccion de intencion Activada
  1. En Tono y personalidad: elige un chip (Cercano…, Amigable…, Tecnico…) y revisa el System Prompt (máx. 4000 caracteres).
  2. En Horario de atencion: define zona horaria, Desde / Hasta, días (Lun–Dom) y Mensaje fuera de horario. Aplica cuando el cliente pide un humano; la IA puede atender 24/7.
  3. Revisa subtítulos según necesidad: Voz, Triggers, Departamentos, Notificaciones, Bancos.
  4. Guarda los cambios del agente (botones de guardado del panel).

4. Automatizaciones, conocimiento y plantillas

Automatizaciones

  1. Pestaña Automatizaciones.
  2. Define palabra clave → acción (texto, audio, transferir, factura) → prioridad (menor número = primero) → estado Activa/Pausada.
  3. Guardar reglas. Las reglas se ejecutan aunque el Agente Ai esté inactivo.

Base de conocimiento

  1. Pestaña Base de conocimiento.
  2. Crea entradas (FAQ / Manual / Texto / PDF), marca Activa y guarda (se vectoriza si hay API Key).

Plantillas WhatsApp

  1. Pestaña Plantillas WhatsApp.
  2. Nueva plantilla con categoría (Bienvenida, aviso de pago, corte, confirmación, Catálogo de planes (IA)).
  3. Activa solo las que deban usarse en flujos/herramientas IA.

5. Verificar en operación

  1. Pestaña Gateway: canal conectado y agente activo.
  2. Envía un WhatsApp de prueba al número conectado.
  3. Atiende en Mensajería → Chat (/messaging/chat): asigna, responde o deja la IA.
  4. Pestaña Reportes (7 / 14 / 30 días): chats, respuestas IA, pendientes humanos.

Consejo: Empieza en Sandbox, valida IA y reglas, y solo entonces pasa a Produccion.

6. Checklist final

  1. Canal Guardar y activar sin errores
  2. Agente activo + API Key + prompt
  3. Al menos una regla o entrada de conocimiento útil
  4. Mensaje real recibido y respondido
  5. Revisar alertas de Mensajes atascados en pending / llamadas perdidas en Gateway