WhatsApp Bot SaaS 🤖
Bot de WhatsApp 24/7 con IA que actúa como empleado real de cualquier negocio.
Stack
- Backend: Node.js + Express + Baileys v7 + Socket.io
- IA: Groq (Llama 3.3 70B + Llama 3.1 8B fallback)
- Base de datos: Supabase (PostgreSQL)
- Pasarela de pagos: Mercado Pago (Suscripciones PreApproval con 7 días de prueba gratis)
- Frontend: Next.js 14 + TypeScript
Inicio rápido
1. Backend
cd backend
npm install
# Editar .env con tus keys
npm run dev
2. Frontend
cd frontend
npm install
npm run dev
Variables de entorno necesarias
backend/.env
GROQ_API_KEY → https://console.groq.com (gratis)GEMINI_API_KEY → https://aistudio.google.com/apikey (gratis, sin tarjeta en la mayoría de regiones). Lee los catálogos en PDF que son puras imágenes. Tiene límite por minuto y por día: el motor espacia las llamadas (VISION_RPM, por defecto 8) y, si se acaba la cuota del día, se detiene y guarda lo leído; al volver a subir el mismo PDF continúa donde quedó sin gastar IA en lo ya hecho. Opcional: GEMINI_VISION_MODEL (por defecto gemini-2.5-flash). Si existe, tiene prioridad sobre OpenRouter para leer catálogos.OPENROUTER_API_KEY → https://openrouter.ai/keys (visión: el bot interpreta las fotos que envían los clientes y lee los catálogos en PDF que son puras imágenes; sin esta clave las fotos se derivan a un asesor y esos catálogos no se pueden importar)OPENROUTER_VISION_MODEL → opcional, por defecto google/gemini-2.5-flashSUPABASE_URL → URL del proyecto SupabaseSUPABASE_SERVICE_KEY → Supabase Dashboard > Settings > API > service_role keyMP_ACCESS_TOKEN → Mercado Pago Developers (Producción: APP_USR-..., Sandbox: TEST-...)ADMIN_WHATSAPP → Tu número sin + (ej: 573001234567)ADMIN_PASSWORD → Contraseña del admin
Importar un catálogo en PDF
En el panel, Conocimiento → PDF. Hay dos caminos y se usan los dos a la vez:
- PDF con texto (menús, listas de precios): se reparte en productos, FAQs e información del negocio.
- PDF de puras imágenes (catálogos de diseño, donde el nombre, el precio y la ficha técnica están dentro de la imagen): se saca la foto de cada página, el modelo de visión la lee y crea el producto con su foto, que queda publicada en el bucket
catalogo de Supabase Storage para que el bot se la envíe al cliente. Tarda unos minutos y el avance se ve en la misma pantalla.
Lo que el negocio ya tenía configurado nunca se pisa: los nombres repetidos se descartan. Tope: 15 MB y 80 páginas por archivo.
Estructura
backend/ → API + WhatsApp bot engine
frontend/ → Dashboard usuario + Admin panel
