Starter Kit

Starter Kit: Agente IA para WhatsApp con n8n + Evolution API + LiteLLM (Self-Hosted)

## ¿Cuántas horas perdiste intentando conectar n8n con Evolution API? Configurar el webhook. Entender el formato del payload. Decidir qué modelo de IA usar. Hac

¿Cuántas horas perdiste intentando conectar n8n con Evolution API?

Configurar el webhook. Entender el formato del payload. Decidir qué modelo de IA usar. Hacer que todo corra en un servidor sin que se caiga al tercer día. Documentar algo para poder retomarlo en dos semanas.

Eso es lo que te ahorra este starter kit.


Qué recibís

Un stack completo y probado en producción para agentes de WhatsApp con IA:

  • docker-compose.yml — los 4 servicios levantados con un solo comando

  • litellm/config.yaml — proxy agnóstico de modelos: Claude, DeepSeek, GPT-4o y Gemini preconfigurados con bloques listos para descomentar

  • n8n/workflows/agente-pedidos.json — workflow importable que recibe mensajes de WhatsApp, los procesa con el LLM configurado y responde

  • .env.example — cada variable con comentario explicativo

  • docs/</strong><a target="_blank" rel="noopener noreferrer nofollow" href="http://setup.md"><strong>setup.md</strong></a><strong> — 13 pasos desde VPS vacío hasta stack corriendo (15-30 minutos)

  • docs/</strong><a target="_blank" rel="noopener noreferrer nofollow" href="http://decisiones-arquitectura.md"><strong>decisiones-arquitectura.md</strong></a><strong> — por qué se eligió cada componente con las alternativas descartadas

  • docs/</strong><a target="_blank" rel="noopener noreferrer nofollow" href="http://troubleshooting.md"><strong>troubleshooting.md</strong></a><strong> — errores comunes y sus soluciones exactas

  • scripts/</strong><a target="_blank" rel="noopener noreferrer nofollow" href="http://install-check.sh"><strong>install-check.sh</strong></a><strong> — verifica que los 4 servicios están corriendo


Por qué LiteLLM cambia todo

La mayoría de los templates de n8n + WhatsApp llaman directamente a OpenAI o Anthropic. Si después querés cambiar de modelo, tenés que editar cada nodo HTTP del workflow.

Este stack pone LiteLLM en el medio. n8n siempre llama a http://litellm:4000 con model: "default". Para cambiar de proveedor: editar 3 líneas en un YAML, reiniciar un contenedor. Los workflows no se tocan.

Activo por defecto: DeepSeek (el más económico). Claude, GPT-4o y Gemini están en el config con sus bloques listos para activar.


Sin depender de Meta

Evolution API funciona con un número de WhatsApp estándar escaneando un QR. Sin proceso de aprobación de Meta Business, sin costo por mensaje, sin restricciones de ventanas de 24 horas para mensajes entrantes.


Para quién es

Freelancers y desarrolladores que construyen agentes de WhatsApp para clientes de negocios locales (restaurantes, tiendas, servicios). Sabés usar n8n o estás aprendiéndolo. No querés partir de cero con la infraestructura.


Lo que NO incluye

  • Memoria de conversación (el README explica cómo agregarla)

  • Panel de pedidos (el README explica cómo construirlo)

  • Soporte individualizado


También te puede interesar