01 Qué es y qué problema resuelve
En muchos negocios el cliente escribe por WhatsApp fuera de horario, nadie responde hasta el día siguiente y la venta se enfría. Y cuando sí se responde, lo hablado no queda registrado en ningún sitio: ni etapa, ni resumen, ni siguiente paso.
Este kit no es una aplicación lista para instalar. Es un blueprint: un repositorio con instrucciones por fases, contratos JSON, pruebas y un script de auditoría. Lo clonas, abres Claude Code dentro de la carpeta y Claude escribe el código del agente en tu máquina, adaptado a tu sistema operativo y a las versiones fijadas en PINES.md.
Califica
Evalúa presupuesto, urgencia y encaje de cada contacto antes de proponer nada.
Responde objeciones
Solo con los argumentos de tu playbook. Las objeciones nuevas las detecta y te las deja anotadas.
Agenda
Ofrece huecos reales de Google Calendar y crea el evento cuando el cliente acepta.
Registra
Escribe etapa, resumen y próximo paso en la tabla de leads (Supabase).
Escala
Pasa la conversación a una persona si detecta enfado, un precio fuera de rango o una palabra clave, y avisa por Slack.
02 Cómo trabaja: seis pasos y tres con permiso
-
1
Recibe y contextualiza
Lee el mensaje entrante, transcribe los audios con Whisper y entiende las imágenes con el propio modelo de Anthropic.
-
2
Detecta intención y califica
Decide qué quiere el contacto y si encaja con tu oferta.
-
3
Redacta la respuesta
Con tu tono de marca y proponiendo horarios disponibles. Es el primer paso que escribe a una persona.
-
4
Agenda y confirma
Crea la cita en el calendario.
-
5
Actualiza el CRM
Añade o actualiza la fila del contacto; nunca borra ni reordena.
-
6
Escala a un humano
Corta la conversación cuando toca y deja de responder, ni siquiera para despedirse.
03 Qué necesitas antes de empezar
- ✓Claude Code instalado y funcionando en tu ordenador.
- ✓Python entre 3.11 y 3.14 (el rango exacto está en PINES.md).
- ✓Una clave de la API de Anthropic: hace falta siempre, también en modo demo.
- ✓Para producción: la API de WhatsApp Business Cloud de Meta o la pasarela Zernio, con un número que no esté en uso en la app de WhatsApp.
- ✓Opcional: Google Calendar (mejor con cuenta de servicio), Supabase como CRM, una clave de OpenAI para transcribir audios y un webhook de Slack para los avisos.
- ✓Tu catálogo con precios y tus objeciones habituales, aunque sea en la cabeza: el kit te los pregunta.
04 Instalación paso a paso
El repositorio se clona; no se instala como plugin. Los comandos leen las carpetas blueprint/, scripts/ y pruebas/ del propio clon, así que instalado como plugin apuntarían al proyecto equivocado.
git clone https://github.com/Hainrixz/whatsapp-closer-agentkit
cd whatsapp-closer-agentkit
claude
# ya dentro de Claude Code:
/start/start revisa tu entorno, te explica qué va a construir, te entrevista sobre el negocio y despliega en local o en Railway. Si prefieres preparar el entorno a mano, estos son los tres comandos del README:
python3 -m venv .venv
cp plantillas/infra/requirements.txt requirements.txt
.venv/bin/python -m pip install -r requirements.txt| Comando | Para qué sirve |
|---|---|
| /start | Primera ejecución completa: entrevista, construcción y despliegue. |
| /seguir | Retoma una construcción que quedó a medias. |
| /configurar | Catálogo, rango de precios, disponibilidad y reglas de escalado. |
| /playbook | Escribe o ajusta las objeciones y el tono. |
| /probar | Simulador de chat en la terminal contra el proveedor demo, sin credenciales. |
| /revisar | Ejecuta la auditoría antes de publicar. |
| /publicar | Despliega y registra el webhook con tu proveedor. |
| /bandeja | Revisa los borradores uno a uno y aprueba, rechaza o corrige. |
05 Probar sin credenciales y publicar
El proveedor demo reproduce mensajes reales grabados, con su firma, sin pedir credenciales de WhatsApp. Es la forma de ver el agente trabajando el mismo día. Cuando todo cuadre, pasa la auditoría: scripts/auditar.py ejecuta 23 comprobaciones sin conexión a internet y devuelve PASS, FAIL o PARCIAL. Un parcial significa que algo que debía ejecutarse no se ejecutó, y en ese estado no se publica.
.venv/bin/python scripts/auditar.py
.venv/bin/python -m pytest pruebas -qVamos a preparar el playbook de objeciones para el agente de WhatsApp. Mi negocio es [describe tu negocio] y vendo [productos o servicios con precios]. Hazme preguntas de una en una para sacar: las 8 objeciones más frecuentes que oigo, cómo respondo hoy a cada una, qué cosas no debo prometer nunca y en qué casos quiero que la conversación pase a una persona. Al final, ordénalo en el formato que espera /playbook.06 Uso en el día a día
Las primeras semanas, trabaja desde /bandeja: revisa cada borrador con su razonamiento y apruébalo, recházalo o corrígelo. El resumen de la bandeja lista las objeciones que han aparecido y no están en tu playbook, que es justo lo que necesitas para mejorarlo. Cuando las cifras de aciertos te convenzan, suelta primero el paso de respuesta y deja la agenda y el CRM en borrador un tiempo más.
07 Límites y seguridad
- ✓No inicia conversaciones ni hace envíos masivos: solo responde a quien escribe, lo que protege tu número frente a Meta.
- ✓Fuera de las 24 horas desde el último mensaje del cliente, WhatsApp solo permite plantillas aprobadas; los recordatorios de cita las necesitan.
- ✓No inventa precios ni promociones que no estén en tu catálogo, ni negocia fuera de rango.
- ✓El recordatorio de 24 horas funciona con SQLite; con Postgres el propio repositorio lo documenta como pendiente.
- ✓Una auditoría en verde no prueba la conexión con Meta: revisa PENDIENTES.md para lo que debes comprobar tú.
- ✓Nunca pegues tokens ni claves en un issue público; si ocurre, rótalos.
Preguntas frecuentes
No para seguir los pasos, porque Claude Code escribe el código. Sí conviene manejarte con la terminal y entender qué son una variable de entorno y un webhook.
La API de WhatsApp Business requiere un número que no esté activo en la app de WhatsApp. Si lo está, tendrás que darlo de baja allí, con la pérdida de historial que eso implica.
Meta es la API oficial de WhatsApp Business Cloud. Zernio es una pasarela que trabaja sobre ella y simplifica parte del alta. El kit soporta ambos y el modo demo para pruebas.
En tu propio ordenador o servidor de la oficina, o en Railway, que es la opción por defecto del blueprint. Lo eliges tú durante la instalación.
El kit no gestiona por ti el RGPD. Informa a tus clientes de que hablan con un asistente automatizado, define la base legal del tratamiento y revisa dónde se alojan la base de datos y los proveedores.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.