WhatsApp 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

Paso 1: Clona el repositorio

Esto descarga el proyecto a tu computadora. Abre tu terminal y copia este comando:

Paso 2: Ejecuta el script de inicio

Este script prepara todo automáticamente — instala dependencias y configura el entorno:

Paso 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:

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.

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.

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.

Opció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.

1. Sube tu proyecto a GitHub (Claude Code puede hacerlo por ti)
2. Entra a railway.app y conecta tu cuenta de GitHub
3. Selecciona tu repositorio de whatsapp-agentkit
4. Railway detecta el Dockerfile y despliega automáticamente
5. Agrega una base de datos: New → Database → Add PostgreSQL
6. Carga las variables de entorno del servicio de tu agente: tus API keys, el secreto del webhook (ZERNIO_WEBHOOK_SECRET o META_APP_SECRET) y la base de datos. Railway no conecta la base sola: escribe literal, con las llaves dobles, DATABASE_URL = ${{Postgres.DATABASE_URL}} — y si le pusiste otro nombre al servicio de la base, usa ese nombre en vez de Postgres.
7. Pídele el dominio público: tu servicio → Settings → Networking → Generate Domain. Te queda algo como tu-app.up.railway.app — esa es la URL que configuras como webhook: en Zernio va con el Secret que inventaste, y en Meta con tu META_VERIFY_TOKEN (que no es lo mismo que el App Secret)

No necesitas tocar código. Abre Claude Code y pide cambios con lenguaje natural:

Cuando un cliente envía un mensaje a tu WhatsApp, esto es lo que pasa:

1. El mensaje llega al proveedor de WhatsApp (Zernio o Meta)
2. El proveedor lo envía a tu servidor via webhook
3. Tu servidor revisa la firma y descarta el aviso si ya lo había recibido antes
4. Contesta "recibido" de inmediato, y sigue trabajando por su cuenta
5. Busca el historial de esa conversación y se lo envía a Claude junto con el mensaje y la información de tu negocio
6. Claude genera la respuesta y se envía de vuelta por WhatsApp

Tres detalles que explican el porqué

• Primero revisa la firma, luego lee el mensaje. Cada aviso que llega viene firmado por el proveedor, y si la firma no cuadra el agente lo tira — sin ese chequeo, cualquiera que descubra la dirección de tu servidor podría meterle mensajes falsos. Ojo: esa revisión solo ocurre si cargaste el secreto del webhook, y viene vacío de fábrica para que puedas probar sin trabarte. Mientras esté vacío el agente arranca, te avisa en los registros y deja pasar todo. Cárgalo antes de atender clientes de verdad.
• Ignora los repetidos. Cada mensaje trae su propio identificador. Si el mismo llega dos veces, el agente responde una sola vez.
• Contesta "recibido" de inmediato y piensa después. El proveedor espera respuesta en unos 5 segundos y pensar tarda más que eso. Si no la recibe, reintenta el mismo mensaje hasta 7 veces — y tu cliente vería la misma respuesta siete veces.