WhatsApp AgentKit
Construye tu propio agente de WhatsApp con inteligencia artificial en menos de 30 minutos. Sin código: Claude Code genera toda la infraestructura respondiendo 10 preguntas sobre tu negocio.
/build-agent¿Qué es WhatsApp AgentKit?
AgentKit es un proyecto open source que usa Claude Code para generar un agente de WhatsApp completo y personalizado para tu negocio. No necesitas saber programar: Claude Code escribe todo el código, configura la conexión con WhatsApp, crea un “cerebro IA” que conoce tu negocio y lo deja listo para que tus clientes le escriban.
🍽️ Restaurante
"El especial del día es…"
💇 Clínica / Salón
"Tu cita es el martes a las 15h"
🏠 Inmobiliaria
"Tenemos 3 pisos en tu rango…"
Requisitos previos
Solo 4 cosas. Si ya tienes Claude Code, solo necesitas API Key y cuenta de WhatsApp.
Python 3.11 o superior
El lenguaje que usa el agente por detrás.
Mac: brew install python · Win: python.org/downloadsClaude Code
La herramienta de Anthropic que construye tu agente.
npm install -g @anthropic-ai/claude-codeAnthropic API Key
La "llave" para que tu agente piense con Claude AI.
platform.anthropic.com/settings/api-keysCuenta WhatsApp API
Elige un proveedor: Whapi.cloud, Meta Cloud API o Twilio.
Instalación
3 comandos y estás dentro.
Clona el repositorio
Descarga el proyecto en tu ordenador con dos comandos.
git clone https://github.com/Hainrixz/whatsapp-agentkit.git cd whatsapp-agentkit
Ejecuta el script de inicio
Este script instala dependencias y prepara el entorno automáticamente.
bash start.sh
Abre Claude Code y escribe /build-agent
Claude Code te hará 10 preguntas sobre tu negocio y generará todo el código.
claude /build-agent
La entrevista de Claude Code
10 preguntas · ~5 minutos · Sin tecnicismos
Arquitectura del sistema
Lo que ocurre cuando un cliente te escribe:
FastAPI
Servidor web
Claude AI
Cerebro IA
SQLite / Postgres
Historial
Docker
Contenedor
Despliegue a producción
Dos opciones, ambas funcionan. Elige la que te resulte más fácil.
Opción A — Docker
Ideal si tienes tu propio servidor o VPS. Corre igual en cualquier máquina.
docker compose up --build
Opción B — Railway
Free planConectas tu repo de GitHub, Railway detecta el Dockerfile y despliega solo. Te da una URL pública para el webhook.
railway.appPersonaliza tu agente después
No necesitas tocar código. Abre Claude Code y pide cambios en lenguaje natural:
claude "Haz que el agente sea más amigable y cercano."
claude "Añade nuestro nuevo servicio de reparto al agente."
claude "Migra de Whapi a Meta Cloud API."
Preguntas frecuentes
¿Necesito saber programar?
No. Claude Code escribe todo el código por ti. Solo respondes preguntas sobre tu negocio.
¿Cuánto cuesta?
AgentKit es gratis y open source (MIT). La API de Claude cuesta ~$3 por millón de tokens. Whapi tiene sandbox gratuito y Railway tiene plan free para proyectos pequeños.
¿Puedo usarlo para mi negocio real?
Sí. Después de probarlo localmente, súbelo a Railway o Docker y cualquier mensaje de WhatsApp será atendido por tu agente.
¿Qué pasa si el agente no sabe algo?
Responde: "No tengo esa información, déjame conectarte con alguien de nuestro equipo." Nunca inventa datos.
¿Puedo tener varios agentes?
Sí. Clona el repositorio tantas veces como negocios tengas, uno por agente.
¿Puedo cambiar de proveedor después?
Sí. Dile a Claude Code: "Quiero migrar de Whapi a Meta Cloud API" y lo hace por ti.