Construye tu propio agente de WhatsApp con inteligencia artificial en menos de 30 minutos. No necesitas saber programar. Claude Code construye todo por ti.
AgentKit es un proyecto que usa Claude Code (la herramienta de programacion de Anthropic) para generar un agente de WhatsApp completo y personalizado para tu negocio.
Tu solo respondes preguntas sobre tu negocio. Claude Code se encarga de:
- Escribir todo el codigo
- Configurar la conexion con WhatsApp
- Crear un "cerebro" con IA que sabe sobre tu negocio
- Dejarlo listo para que tus clientes le escriban
git clone https://github.com/Hainrixz/whatsapp-agentkit.git
cd whatsapp-agentkit
bash start.shstart.sh solo verifica que tengas Python 3.11+ y Claude Code instalados.
claude
# Dentro de Claude Code escribe:
/build-agentEsto activa el sistema. Claude Code lee las instrucciones de CLAUDE.md y empieza
a guiarte paso a paso.
Te hace 10 preguntas, una por una:
- Nombre de tu negocio — ej: "Cafeteria El Buen Sabor"
- A que se dedica — ej: "Vendemos cafe de especialidad y postres artesanales"
- Para que quieres el agente — responder preguntas, agendar citas, tomar pedidos, etc.
- Nombre del agente — ej: "Sofia" (el nombre que veran tus clientes)
- Tono de comunicacion — profesional, amigable, vendedor, o empatico
- Horario de atencion — ej: "Lunes a Viernes 9am a 6pm"
- Archivos de tu negocio — menu, precios, FAQ (los pones en la carpeta /knowledge)
- API Key de Anthropic — la llave para usar Claude AI (te guia a obtenerla)
- Proveedor de WhatsApp — eliges entre Whapi.cloud, Meta, o Twilio
- Credenciales del proveedor — el token o keys de tu servicio de WhatsApp
Con tus respuestas, genera automaticamente estos archivos:
tu-proyecto/
├── agent/ ← EL AGENTE COMPLETO
│ ├── main.py Servidor web que recibe mensajes de WhatsApp
│ ├── brain.py Conexion con Claude AI (el cerebro)
│ ├── memory.py Guarda el historial de cada cliente
│ ├── tools.py Herramientas especificas de tu negocio
│ └── providers/ Conexion con tu servicio de WhatsApp
│ ├── base.py Interfaz comun
│ ├── __init__.py Selecciona el proveedor automaticamente
│ └── whapi.py Adaptador (o meta.py, o twilio.py)
│
├── config/ ← CONFIGURACION
│ ├── business.yaml Datos de tu negocio
│ └── prompts.yaml El "prompt" que define la personalidad del agente
│
├── knowledge/ ← TUS ARCHIVOS
│ └── (menu.pdf, precios.txt, etc.)
│
├── tests/
│ └── test_local.py Simulador de chat en tu terminal
│
├── requirements.txt Dependencias de Python
├── Dockerfile Para produccion
├── docker-compose.yml Orquestacion
└── .env Tus API keys (seguro, nunca se sube)
Claude Code ejecuta un simulador de chat donde TU escribes como si fueras un cliente:
Tu: Hola, que horarios tienen?
Agente: Hola! Nuestro horario es de Lunes a Viernes de 9am a 6pm.
Quieres que te ayude con algo mas?
Tu: Cuanto cuesta el cafe americano?
Agente: El cafe americano tiene un precio de $45 pesos.
Te gustaria ordenar uno?
Si algo no te gusta, le dices a Claude Code y lo ajusta al momento.
Cuando estes satisfecho con tu agente, Claude Code te guia para ponerlo en linea:
- Claude Code prepara tu proyecto para produccion (ajusta configuracion)
- Tu lo subes a GitHub — Claude Code te da los comandos exactos para crear tu repo
- Conectas Railway — entras a railway.app, le das tu repo de GitHub y Railway lo deployea automaticamente
- Configuras las variables — Claude Code te dice exactamente cuales poner en Railway (las mismas API keys de tu .env)
- Configuras el webhook — Claude Code te guia para conectar tu proveedor de WhatsApp con la URL de Railway
Despues de esto, cualquier persona que te escriba por WhatsApp sera atendida por tu agente.
Nota: No necesitas saber de servidores ni de deploy. Claude Code te dice cada paso, que escribir y donde hacer click.
Un cliente escribe "Hola" por WhatsApp
|
v
Tu proveedor de WhatsApp (Whapi/Meta/Twilio) recibe el mensaje
|
v
Envia el mensaje a tu servidor en Railway via webhook
|
v
agent/providers/ → Normaliza el mensaje (cada proveedor tiene formato diferente)
|
v
agent/memory.py → Busca el historial de ESE cliente (por numero de telefono)
|
v
agent/brain.py → Envia a Claude AI:
- El system prompt (personalidad + info de tu negocio)
- El historial de la conversacion
- El mensaje nuevo del cliente
|
v
Claude AI genera una respuesta inteligente
|
v
agent/providers/ → Envia la respuesta de vuelta por WhatsApp
|
v
El cliente recibe la respuesta en segundos
Cosas importantes:
- Cada cliente tiene su propio historial. Si alguien habla contigo y vuelve al dia siguiente, el agente recuerda la conversacion anterior.
- El agente NUNCA inventa informacion. Solo responde con lo que tu le diste.
- Si no sabe algo, responde: "No tengo esa informacion, dejame conectarte con alguien del equipo."
Necesitas 4 cosas antes de empezar:
- Mac:
brew install pythono descarga de python.org - Windows: Descarga de python.org (marca "Add to PATH")
- Linux:
sudo apt install python3.11 - Verifica:
python3 --version
# Primero necesitas Node.js: https://nodejs.org
npm install -g @anthropic-ai/claude-code
# Autenticate (solo la primera vez)
claude- Ve a platform.anthropic.com
- Crea una cuenta o inicia sesion
- Ve a Settings → API Keys → Create Key
- Copia la key (empieza con
sk-ant-...)
| Proveedor | Dificultad | Costo | Mejor para |
|---|---|---|---|
| Whapi.cloud | Facil | Sandbox gratis | Empezar rapido, probar |
| Meta Cloud API | Media | Gratis por conversacion | Produccion seria |
| Twilio | Media | Pago por mensaje | Empresas, alta confiabilidad |
Si no estas seguro, empieza con Whapi.cloud. Es la opcion mas rapida — te registras, copias un token, y listo.
# 1. Clona el repositorio
git clone https://github.com/Hainrixz/whatsapp-agentkit.git
cd whatsapp-agentkit
# 2. Verifica tu entorno
bash start.sh
# 3. Abre Claude Code y construye tu agente
claude
# Escribe: /build-agentClaude Code te guia desde ahi. Solo responde las preguntas.
AgentKit soporta 3 proveedores. Tu eliges cual usar durante el setup.
- Registrate en whapi.cloud
- Tienen un sandbox gratuito (no necesitas verificar nada)
- Solo necesitas: 1 token
- Ideal para probar y para negocios pequenos
- Configura en developers.facebook.com
- Es la API oficial de WhatsApp (de Meta/Facebook)
- Necesitas: Access Token + Phone Number ID + Verify Token
- Requiere cuenta de Facebook Business verificada
- Gratis por conversacion (pagas solo por conversaciones iniciadas por ti)
- Registrate en twilio.com
- Muy confiable, excelente documentacion
- Necesitas: Account SID + Auth Token + Phone Number
- Tiene sandbox para probar gratis
- Pago por mensaje en produccion
| Tipo de negocio | Que hace el agente | Ejemplo |
|---|---|---|
| Restaurante | Responde sobre menu, horarios, ubicacion | "El platillo del dia es..." |
| Clinica/Salon | Agenda citas y reservaciones | "Tu cita quedo para el martes a las 3pm" |
| Inmobiliaria | Califica leads y envia info de propiedades | "Tenemos 3 departamentos en tu rango..." |
| Tienda online | Toma pedidos por WhatsApp | "Tu pedido de 2 pasteles quedo confirmado" |
| SaaS/Software | Soporte tecnico post-venta | "Para resetear tu contrasena, sigue estos pasos..." |
| Cualquier negocio | Responde preguntas frecuentes 24/7 | "Nuestro horario es..." |
# Probar el agente sin WhatsApp (chat en terminal)
python tests/test_local.py
# Arrancar el servidor localmente
uvicorn agent.main:app --reload --port 8000
# Build Docker para produccion
docker compose up --build
# Ver logs del agente
docker compose logs -f agentNo necesitas tocar codigo. Abre Claude Code y pidele cambios en lenguaje natural:
# Cambiar como responde el agente
claude "El agente esta siendo muy formal. Hazlo mas amigable y casual."
# Agregar informacion nueva
claude "Agregamos un nuevo servicio de delivery. Actualiza el agente."
# Agregar una herramienta
claude "Quiero que el agente pueda consultar disponibilidad de citas."
# Cambiar de proveedor de WhatsApp
claude "Quiero migrar de Whapi a Meta Cloud API."Para los curiosos, esto es lo que se usa por debajo:
| Componente | Tecnologia | Para que sirve |
|---|---|---|
| IA | Claude AI (claude-sonnet-4-6) | Genera las respuestas inteligentes |
| Servidor | FastAPI + Uvicorn | Recibe los webhooks de WhatsApp |
| Whapi.cloud / Meta / Twilio | Conecta con WhatsApp (tu eliges) | |
| Base de datos | SQLite (local) / PostgreSQL (prod) | Guarda historial de conversaciones |
| Deploy | Docker + Railway | Pone tu agente en internet |
| Config | python-dotenv + YAML | Maneja API keys y configuracion |
WhatsApp (cliente)
|
v
Proveedor (Whapi/Meta/Twilio) ←→ agent/providers/ (normaliza formato)
|
v
FastAPI (agent/main.py) ←→ agent/memory.py (historial SQLite)
|
v
Claude API (agent/brain.py) ←→ config/prompts.yaml (personalidad)
|
v
Respuesta enviada de vuelta por WhatsApp
El sistema usa un patron adaptador para proveedores de WhatsApp. Cada proveedor
(Whapi, Meta, Twilio) implementa la misma interfaz, asi que main.py no sabe ni le
importa cual estas usando. Solo llama proveedor.parsear_webhook() y
proveedor.enviar_mensaje().
Necesito saber programar? No. Claude Code escribe todo el codigo por ti. Tu solo respondes preguntas.
Cuanto cuesta?
- AgentKit es gratis y open source
- Claude API: pagas por uso (~$3/millon de tokens, muy barato para un bot)
- WhatsApp: depende del proveedor (Whapi tiene sandbox gratis)
- Railway: plan gratis disponible para proyectos pequenos
Puedo usar esto con mi negocio real? Si. Despues de las pruebas locales, lo subes a Railway y cualquier cliente que te escriba por WhatsApp sera atendido por tu agente.
Y si el agente no sabe algo? Responde algo como: "No tengo esa informacion, dejame conectarte con alguien de nuestro equipo." Nunca inventa datos.
Puedo tener multiples agentes? Si. Clona el repo varias veces, uno por negocio. Cada agente es independiente.
Puedo cambiar de proveedor de WhatsApp despues? Si. Abre Claude Code y dile: "Quiero cambiar de Whapi a Meta Cloud API." El regenerara los archivos necesarios.
Creado por Todo de IA — @soyenriquerocha
Construido con Claude Code para builders de LATAM.
MIT — Usa este proyecto como quieras, para lo que quieras.