Chatbot para WhatsApp con IA: guia completa de configuracion

Para configurar un chatbot para WhatsApp con IA necesitas tres componentes: una API de mensajeria (Evolution API), un orquestador de flujos (n8n) y un modelo de lenguaje (Claude o GPT-4). En menos de una tarde puedes tener respuestas automaticas inteligentes activas.

Por que un chatbot para WhatsApp con IA y no un bot tradicional

Un chatbot tradicional responde con opciones numeradas: "1 para ventas, 2 para soporte". Un chatbot para WhatsApp con IA entiende el lenguaje natural, recuerda el contexto de la conversacion, califica al lead mientras chatea y puede agendar citas sin intervencion humana.

La diferencia en numeros: una empresa de servicios con 200 mensajes diarios en WhatsApp tarda en promedio 4 horas en responder a todos. Con un bot inteligente, el 80% se resuelve en segundos. Los humanos solo intervienen en los casos complejos.

Requisitos previos

• Evolution API v2.x instalado (Docker o VPS propio)
• n8n self-hosted o cloud (version 1.x)
• API key de Claude (Anthropic) o OpenAI
• Numero de WhatsApp dedicado (no tu numero personal — Evolution API vincula el numero via QR)
• Conocimientos basicos de JSON y webhooks

Paso 1: Instalar y conectar Evolution API

Evolution API es la capa que conecta tu servidor con WhatsApp. Es la opcion mas usada en LATAM para proyectos de automatizacion whatsapp ia fuera de Meta Business.

# Levantar Evolution API con Docker
docker run -d \
  --name evolution-api \
  -p 8080:8080 \
  -e AUTHENTICATION_API_KEY=tu_api_key_secreta \
  -e AUTHENTICATION_EXPOSE_IN_FETCH_INSTANCES=true \
  atendai/evolution-api:v2.2.0

Una vez levantado, crea una instancia y escanea el QR con el numero que usaras como bot:

# Crear instancia
curl -X POST http://localhost:8080/instance/create \
  -H #43a047">"apikey: tu_api_key_secreta" \
  -H #43a047">"Content-Type: application/json" \
  -d '{#43a047">"instanceName": "nexo-bot", "integration": "WHATSAPP-BAILEYS"}'

Abre http://localhost:8080/instance/nexo-bot/qrcode en el navegador y escanea con WhatsApp. En 10 segundos el numero queda conectado.

Paso 2: Configurar el webhook en n8n

Cuando llega un mensaje a Evolution API, necesitas que n8n lo reciba y procese. El webhook es el puente.

En Evolution API, configura el webhook de tu instancia:

{
  #43a047">"webhook": {
    #43a047">"url": "https://tu-n8n.com/webhook/whatsapp-entrada",
    #43a047">"byEvents": true,
    #43a047">"events": ["MESSAGES_UPSERT"]
  }
}

En n8n, crea un workflow con estos nodos en orden:

1. Webhook (trigger) — recibe el mensaje entrante
2. IF — filtra mensajes propios y grupos
3. Code — extrae el numero, nombre y texto del payload
4. AI Agent — procesa con el LLM
5. HTTP Request — envia la respuesta via Evolution API

El filtro IF es critico para no procesar tus propios mensajes salientes:

// Condicion: solo mensajes entrantes reales
$json.data.key.fromMe === false && $json.data.key.remoteJid.includes('@s.whatsapp.net')

Paso 3: Configurar el agente de IA en n8n

El nodo AI Agent de n8n permite conectar Claude o GPT-4 con memoria de conversacion. Esta es la diferencia entre un bot whatsapp inteligente que recuerda el contexto y uno que empieza de cero en cada mensaje.

System prompt base para un negocio de servicios:

Eres el asistente virtual de [Nombre del Negocio]. Tu trabajo es:
1. Responder preguntas sobre servicios y precios
2. Calificar si el contacto es un cliente potencial
3. Agendar citas si el cliente esta listo para avanzar

Tono: amable, directo, sin emojis.
Idioma: espanol latinoamericano.

Cuando el cliente quiera agendar, pide: nombre completo, fecha preferida y telefono.
Cuando no sepas algo, responde: "Te paso con un asesor en un momento."

La memoria de conversacion se configura con el nodo Window Buffer Memory de n8n, usando el numero de telefono como session ID. Cada cliente tiene su propio hilo independiente.

Paso 4: Enviar la respuesta de vuelta a WhatsApp

El ultimo nodo envia la respuesta generada por el LLM al numero del cliente:

// Nodo HTTP Request — POST a Evolution API
// URL: http://tu-evolution-api:8080/message/sendText/nexo-bot
{
  #43a047">"number": "{{ $('Webhook').item.json.data.key.remoteJid }}",
  #43a047">"text": "{{ $('AI Agent').item.json.output }}"
}

Ciclo completo: mensaje entra → n8n lo recibe → Claude lo procesa → n8n envia la respuesta → cliente ve la respuesta en WhatsApp. Todo en menos de 3 segundos.

Arquitectura del sistema

WhatsApp (cliente)
    ↓ mensaje
Evolution API (v2.x, Docker)
    ↓ webhook POST
n8n (orquestador)
    ↓ extrae datos + consulta memoria
Claude / GPT-4 (LLM)
    ↓ respuesta generada
n8n
    ↓ HTTP POST
Evolution API → WhatsApp (cliente)

Latencia total: menos de 3 segundos

Para menos de 500 conversaciones simultaneas, la memoria interna de n8n es suficiente. Para mas volumen, usa Redis como backend de memoria.

Lo que aprendimos en produccion

Despues de desplegar este stack para varios clientes:

• El filtro de grupos es obligatorio: sin el, el bot responde en grupos donde fue anadido y genera confusion
• Limitar el contexto a 10 mensajes: guardar mas ralentiza el LLM y sube el costo de tokens sin mejorar la calidad
• Horario en el prompt: si el negocio no atiende 24/7, declara las horas para que el bot avise cuando no hay humanos disponibles
• Fallback a humano: detectar frases como "quiero hablar con una persona" y notificar al equipo por email o Slack
• Evolution API en servidor dedicado: la conexion WebSocket de WhatsApp es sensible a picos de CPU — no compartir host con servicios de alto consumo

En resumen

1. Evolution API conecta tu numero de WhatsApp al servidor via QR
2. Webhook en n8n recibe cada mensaje entrante en tiempo real
3. AI Agent con memoria procesa el mensaje con Claude o GPT-4 manteniendo el contexto
4. HTTP Request envia la respuesta generada de vuelta al cliente
5. El sistema responde en menos de 3 segundos y escala a cientos de conversaciones simultaneas

Si quieres implementar este chatbot para WhatsApp con IA en tu negocio sin construirlo desde cero, en AgentesNexo lo hacemos por ti. Escribenos en agentesnexo.com o por WhatsApp al +591 67564218