WhatsApp AgentKit

No necesitas saber programar. Le contestas 10 preguntas a Claude sobre tu negocio y el construye el agente completo: codigo, conexion a WhatsApp y base de conocimiento incluidos.

Treinta minutos. Un agente funcionando. Listo para atender clientes.

---

Que es

Un kit de arranque que usa Claude Code para generar un agente de WhatsApp personalizado a tu negocio. Vos contestas las preguntas, Claude escribe el codigo.

Sirve para cualquier negocio que quiera automatizar la atencion por WhatsApp:

• Restaurantes (menu, reservas, horarios)
• Clinicas y peluquerias (turnos, precios, disponibilidad)
• Inmobiliarias (propiedades, consultas, contacto)

---

Requisitos

Antes de empezar necesitas tener instalado:

• Python 3.11+
• Claude Code — npm install -g @anthropic-ai/claude-code
• API Key de Anthropic — la conseguis en platform.anthropic.com
• Cuenta de WhatsApp API — cualquiera de estas tres funciona: Whapi.cloud, Meta Cloud API, o Twilio

---

Instalacion

git clone https://github.com/benjaminromero5631/whatsapp-agentkit.git
cd whatsapp-agentkit
bash start.sh

Cuando termina el setup, abris Claude Code en esa carpeta y ejecutas:

/build-agent

---

El proceso de configuracion

Claude te va a hacer 10 preguntas sobre tu negocio. No te saltes ninguna, determinan como va a responder el agente.

Pregunta	Para que sirve
Nombre del negocio	Identidad del agente
Industria	Contexto para las respuestas
Proposito del agente	Que puede y que no puede hacer
Tono de comunicacion	Formal, casual, amigable
Horarios de atencion	Cuando esta disponible
Archivos del negocio	Menu, catalogo, precios, FAQ
API Key de Anthropic	Para conectar con Claude
Credenciales de WhatsApp	Para conectar al numero
Proveedor de WhatsApp	Whapi, Meta, o Twilio
Flujos especiales	Derivacion a humano, formularios

Al terminar, Claude genera todo el codigo en la carpeta agent/.

---

Probar localmente

Antes de subir a produccion, proba que funciona:

python tests/test_local.py

O con el servidor local:

uvicorn agent.main:app --reload --port 8000

Manda un mensaje al numero configurado y ves la respuesta en tiempo real.

---

Despliegue

Opcion A — Docker

docker compose up --build

Ideal si tenes un servidor propio o VPS.

Opcion B — Railway

1. Conecta el repositorio en railway.app
2. Railway detecta el Dockerfile automaticamente
3. Agrega las variables de entorno desde el .env.example
4. Deploy automatico con cada push

---

Personalizar el agente

Una vez funcionando, modificas el comportamiento con lenguaje natural desde Claude Code:

agrega un flujo para tomar reservas con nombre, fecha y hora

cuando el cliente pregunte por precios, muestrale la tabla del catalogo

Claude edita el codigo directamente. No necesitas tocar ningun archivo a mano.

---

Como funciona por dentro

WhatsApp → webhook → servidor → historial de conversacion → Claude API → respuesta → WhatsApp

Cada mensaje del cliente pasa por el webhook, Claude lee el historial para mantener contexto y devuelve la respuesta. El servidor maneja la cola y los reintentos.

---

Preguntas frecuentes

Necesito saber programar? No. Claude Code genera y modifica todo el codigo. Solo necesitas poder correr comandos en la terminal.

Cuanto cuesta usar la API de Claude? Aproximadamente $3 por millon de tokens. Un agente activo en un negocio chico gasta entre $5 y $20 por mes dependiendo del volumen.

Puedo usarlo en un negocio real? Si. Esta pensado para produccion. El despliegue en Railway tiene uptime de 99.9%.

Puedo tener varios agentes para distintos numeros? Si. Cada instancia del proyecto corre de forma independiente. Clona el repo de nuevo para cada numero.

Se puede migrar de proveedor de WhatsApp? Si, la arquitectura esta desacoplada. Cambia las credenciales en el .env y el proveedor en la configuracion del agente.