WhatsApp AgentKit
Construye tu propio agente de WhatsApp con inteligencia artificial en menos de 30 minutos. No necesitas saber programar — Claude Code escribe todo el código por ti. Solo responde preguntas sobre tu negocio.
Proyecto open source
Esta página es una guía paso a paso. El código completo del proyecto, documentación técnica y actualizaciones están en el repositorio de GitHub.
Danos una estrella en GitHub para apoyar el proyecto.
El flujo completo
1. Clona e inicia
3 comandos en tu terminal para preparar todo
2. Claude construye
Responde 10 preguntas y Claude escribe tu agente
3. Despliega
Docker local o Railway desde GitHub — tú decides
01 el proyecto
¿Qué es AgentKit?
AgentKit es un proyecto que usa Claude Code para generar un agente de WhatsApp completo y personalizado para tu negocio.
Tú solo respondes preguntas sobre tu negocio. Claude Code se encarga de:
- Escribir todo el código
- Configurar la conexión a WhatsApp
- Crear un "cerebro" con IA que sabe de tu negocio
- Dejarlo 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 3pm"
🏠
Inmobiliaria
"Tenemos 3 depas en tu rango..."
02 requisitos
Qué necesitas antes de empezar
Son solo 4 cosas. Si ya tienes Claude Code instalado, solo necesitas una API key y una cuenta de WhatsApp.
1. Python 3.11 o superior
Es el lenguaje que usa el agente por detrás.
Mac: brew install python
Windows: Descarga desde python.org
2. Claude Code
La herramienta de Anthropic que va a construir tu agente.
npm install -g @anthropic-ai/claude-code3. Anthropic API Key
Es la "llave" para que tu agente piense con Claude AI. Consíguela en platform.anthropic.com
4. Cuenta de WhatsApp API
Elige un proveedor (Claude Code te ayuda a configurarlo):
Whapi.cloud — Fácil, sandbox gratis
Meta Cloud API — Gratis por conversación
Twilio — Para empresas grandes
03 instalación
Instalar AgentKit (3 comandos)
Paso 1: Clona el repositorio
Esto descarga el proyecto a tu computadora. Abre tu terminal y copia este comando:
Clonar el repositorio
git clone https://github.com/Hainrixz/whatsapp-agentkit.gitEntrar a la carpeta
cd whatsapp-agentkitPaso 2: Ejecuta el script de inicio
Este script prepara todo automáticamente — instala dependencias y configura el entorno:
Iniciar el proyecto
bash start.shPaso 3: Abre Claude Code y escribe /build-agent
Esto inicia el proceso donde Claude Code te hace preguntas sobre tu negocio y construye tu agente:
Abrir Claude Code
claudeUna vez dentro de Claude Code, escribe: /build-agent
04 la entrevista
Claude Code te hace 10 preguntas (5 minutos)
Claude Code te pregunta sobre tu negocio. Solo tienes que responder con texto normal — no necesitas saber nada técnico. Con tus respuestas, Claude construye un agente personalizado.
Nombre de tu negocio
A qué te dedicas
Para qué quieres el agente
Nombre del agente
Tono de comunicación
Horario de atención
Archivos de tu negocio (menú, precios, FAQ)
Tu Anthropic API Key
Qué proveedor de WhatsApp prefieres
Credenciales del proveedor
¿Qué pasa después?
Claude Code toma tus respuestas y en 2-5 minutos genera automáticamente toda la estructura del proyecto: código del agente, configuración, base de conocimiento, tests y Docker.
05 probar
Prueba tu agente en la terminal (5 minutos)
Antes de conectarlo a WhatsApp, puedes chatear con tu agente directamente en la terminal para verificar que responde bien. Es como un simulador de chat.
Probar agente en terminal
python tests/test_local.pyIniciar servidor local
uvicorn agent.main:app --reload --port 800006 despliegue
Despliega a producción
Tienes dos opciones para poner tu agente en internet. Las dos funcionan bien — elige la que se te haga más fácil.
Opción A: Docker (en tu computadora o servidor)
Docker empaqueta tu agente en un contenedor que corre igual en cualquier máquina. Ideal si tienes tu propio servidor o VPS.
Construir y levantar con Docker
docker compose up --buildVer logs del agente
docker compose logs -f agentOpción B: Railway (desde GitHub, sin servidor propio)
Railway es una plataforma que hospeda tu agente por ti. Conectas tu repositorio de GitHub y Railway lo despliega automáticamente. Tiene plan gratis para proyectos pequeños.
- Sube tu proyecto a GitHub (Claude Code puede hacerlo por ti)
- Entra a railway.app y conecta tu cuenta de GitHub
- Selecciona tu repositorio de whatsapp-agentkit
- Railway detecta el Dockerfile y despliega automáticamente
- Configura las variables de entorno (API keys) en el dashboard de Railway
- Railway te da una URL pública — configúrala como webhook en tu proveedor de WhatsApp
07 personalizar
Personaliza tu agente después
No necesitas tocar código. Abre Claude Code y pide cambios con lenguaje natural:
Cambiar tono
claude "Haz que el agente sea más amigable y casual."Agregar servicio
claude "Agrega nuestro nuevo servicio de delivery al agente."Cambiar proveedor
claude "Migra de Whapi a Meta Cloud API."08 arquitectura
¿Cómo funciona por dentro?
Cuando un cliente envía un mensaje a tu WhatsApp, esto es lo que pasa:
- El mensaje llega al proveedor de WhatsApp (Whapi, Meta o Twilio)
- El proveedor lo envía a tu servidor via webhook
- Tu servidor busca el historial de esa conversación
- Envía el mensaje + historial + información de tu negocio a Claude AI
- Claude genera una respuesta inteligente
- La respuesta se envía de vuelta por WhatsApp
09 preguntas frecuentes
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. Claude API cuesta ~$3 por millón de tokens (muy barato para un bot). WhatsApp depende del proveedor — Whapi tiene sandbox gratis. Railway tiene plan gratis.
¿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 varias veces, uno por negocio.
¿Puedo cambiar de proveedor después?
Sí. Dile a Claude Code: "Quiero migrar de Whapi a Meta Cloud API."