by Hainrixz
Construye tu agente de WhatsApp con IA en menos de 30 minutos. Claude Code te entrevista y escribe todo el código. Zernio o Meta Cloud API. Sin saber programar.
# Add to your Claude Code skills
git clone https://github.com/Hainrixz/whatsapp-agentkitGuides for using ai agents skills like whatsapp-agentkit.
Last scanned: 8/20/2026
{
"issues": [
{
"file": "CLAUDE.md",
"line": 2014,
"type": "secret-exfiltration",
"message": "Instruction appears to send credentials/secrets to an external endpoint",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-08-20T04:35:27.719Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}whatsapp-agentkit is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Hainrixz. Construye tu agente de WhatsApp con IA en menos de 30 minutos. Claude Code te entrevista y escribe todo el código. Zernio o Meta Cloud API. Sin saber programar. It has 440 GitHub stars.
Yes. whatsapp-agentkit passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/Hainrixz/whatsapp-agentkit" and add it to your Claude Code skills directory (see the Installation section above).
whatsapp-agentkit is primarily written in Python. It is open-source under Hainrixz on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh whatsapp-agentkit against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
WhatsApp AgentKit convierte una conversación de 20 minutos en un agente de WhatsApp que atiende a tus clientes.
No es una plantilla que copias y adaptas. Es un sistema de instrucciones que Claude Code lee para entrevistarte sobre tu negocio y después escribir, probar y desplegar el agente completo por ti: el servidor, la conexión con WhatsApp, la memoria de cada cliente y el prompt que le da personalidad.
Tú no escribes código. Respondes preguntas.
Lo hicimos porque el 90% del trabajo de montar un agente de WhatsApp no es la IA — es la plomería: webhooks, firmas, tokens, reintentos, deploy. Esa parte ya está resuelta y auditada acá adentro. Lo que queda es lo único que solo tú sabes: cómo funciona tu negocio.
Es open source, licencia MIT, y está escrito en español porque se hizo para builders de LATAM.
git clone https://github.com/Hainrixz/whatsapp-agentkit.git
cd whatsapp-agentkit
bash start.sh
Después abre Claude Code y escribe el comando:
claude
# dentro de Claude Code:
/build-agent
Y ya. Claude Code te guía desde ahí.
start.sh solo verifica tu entorno. El sistema real arranca con /build-agent, que hace
que Claude Code lea CLAUDE.md y ejecute cinco fases.
Chequea Python 3.11+, crea las carpetas, instala las dependencias y prepara el .env.
Diez preguntas, una por una: cómo se llama tu negocio, a qué se dedica, para qué quieres el agente, cómo se va a llamar, qué tono debe tener, tu horario, tus archivos de precios o menú, tu API key de Anthropic, y con qué servicio vas a conectar WhatsApp.
Con tus respuestas escribe todo esto:
tu-proyecto/
├── agent/
│ ├── main.py Servidor que recibe los mensajes de WhatsApp
│ ├── brain.py Conexión con Claude — el cerebro
│ ├── memory.py Historial de cada cliente + deduplicación de eventos
│ ├── tools.py Herramientas específicas de tu negocio
│ └── providers/ Conexión con tu servicio de WhatsApp
│ ├── base.py Interfaz común
│ ├── __init__.py Elige el proveedor automáticamente
│ └── zernio.py Adaptador (o meta.py)
│
├── config/
│ ├── business.yaml Los datos de tu negocio
│ └── prompts.yaml El prompt que define la personalidad del agente
│
├── knowledge/ Tus archivos: menú, precios, políticas, FAQ
├── tests/test_local.py Simulador de chat en tu terminal
├── Dockerfile Para producción
├── docker-compose.yml
└── .env Tus API keys — nunca se sube a GitHub
Un chat en tu terminal donde tú escribes como si fueras un cliente:
Tu: Hola, qué horarios tienen?
Agente: Hola! Atendemos de lunes a viernes de 9am a 6pm.
Te ayudo con algo más?
Tu: Cuánto cuesta el americano?
Agente: El americano está en $45 pesos.
Quieres que te aparte uno?
Si algo no te gusta, se lo dices a Claude Code y lo ajusta ahí mismo.
Te guía para subirlo a GitHub, conectarlo con Railway, cargar las variables de entorno y configurar el webhook. Desde ese momento, cualquiera que te escriba por WhatsApp habla con tu agente.
Eliges uno de los dos durante el setup.
| Zernio | Meta Cloud API directo | |
|---|---|---|
| Qué es | Corre sobre la WhatsApp Cloud API de Meta y te resuelve la conexión | La API oficial de Meta, conectándote tú mismo |
| App de Facebook | No hace falta | Sí, tipo Business |
| App Review | No | Sí |
| Verificación de negocio | La haces desde el Embedded Signup | Cuenta de Facebook Business verificada |
| Costo | 2 cuentas conectadas gratis, sin tarjeta. En los dos casos las conversaciones se las pagas a Meta | Le pagas a Meta directo, sin intermediario |
| Probar sin número propio | Sí, número de pruebas compartido: 50 mensajes cada 24 h, gratis | Sí, Meta da un número de prueba, pero antes hay que crear la app |
| Para quién | Recomendado. Casi todo el mundo | Si ya tienes tu app de Meta armada |
Zernio (zernio.com) es el camino corto: creas la cuenta, conectas tu WhatsApp Business desde el dashboard, copias la API key y listo. Si todavía no tienes número de WhatsApp Business, su sandbox te deja ver el agente funcionando hoy mismo — respondes un mensaje desde tu celular y quedas activado.
Meta Cloud API (developers.facebook.com) te da control total sobre la integración. Es más trabajo de configuración inicial.
Cambiar de uno a otro después es una frase: abre Claude Code y dile "quiero migrar de Zernio a Meta Cloud API".
Un cliente escribe "Hola" por WhatsApp
│
▼
Tu proveedor (Zernio o Meta) recibe el mensaje
│
▼ webhook POST /webhook
main.py verifica la firma del webhook
│
▼
providers/ normaliza el mensaje a un formato común
│
▼
memory.py: ¿ya procesamos este evento? → si sí, se descarta
│
▼
main.py responde 200 AHORA y encola el trabajo
│
▼ ──────── fuera del ciclo del webhook ────────
memory.py busca el historial de ESE cliente
│
▼
brain.py llama a Claude con el system prompt + historial + mensaje
│
▼
providers/ envía la respuesta por WhatsApp
│
▼
El cliente recibe la respuesta en segundos
Tres decisiones de diseño que importan:
Responde primero, trabaja después. Los proveedores esperan una confirmación en unos 5 segundos y, si no la reciben, reintentan el mismo mensaje hasta 7 veces. Llamar a Claude tarda más que eso. Por eso el webhook confirma de inmediato y procesa en segundo plano — si no, el cliente recibiría la misma respuesta siete veces.
Deduplica por id de evento. La entrega es at-least-once: el mismo mensaje puede llegar dos veces. La base de datos garantiza que solo se responda una.
Verifica la firma. Cada webhook viene firmado con HMAC-SHA256 y el agente lo comprueba
antes de tocar el mensaje. Sin esa verificación, cualquiera que conozca tu URL podría
inyectarle mensajes a tu agente. Ojo: la comprobación necesita que hayas cargado
ZERNIO_WEBHOOK_SECRET (o META_APP_SECRET). Si lo dejas vacío el agente arranca igual
—para que puedas probar sin trabarte— pero avisa en los logs y deja pasar todo. Antes de
poner el agente a atender clientes de verdad, cárgalo.
Además: cada cliente tiene su propio historial. Si alguien te escribe hoy y vuelve mañana, el agente recuerda la conversación anterior. Y nunca inventa información — si no sabe algo, lo dice y ofrece pasar el contacto a una persona.
1. Python 3.11 o superior
brew install python o python.orgsudo apt install python3.11python3 --version2. Claude Code
# necesitas Node.js primero: https://nodejs.org
npm install -g @anthropic-ai/claude-code
claude # solo la primera vez, para autenticarte
3. API key de Anthropic
platform.anthropic.com → Settings →
API Keys → Create Key. Empieza con sk-ant-....
4. Una cuenta de WhatsApp API Zernio (recomendado) o Meta Cloud API.
AgentKit es gratis y open source. Lo que pagas es el uso, y conviene verlo con números reales en vez de un "es súper barato".
| Concepto | Costo real |
|---|---|
| AgentKit | Gratis, MIT |
| Zernio | Las primeras 2 cuentas conectadas son gratis, sin tarjeta. Si conectas tu propio número de WhatsApp Business, ahí termina el costo. Si necesitas que Zernio te dé un número, son entre $3 y $21 al mes según el país |
| Meta Cloud API | Las conversaciones que abre el cliente son gratis. Solo pagas las que inicias tú con plantilla |
| Claude API | Por uso. Ver el cálculo de abajo |
| Railway | Ya no hay plan gratuito de verdad: arrancas con $5 de crédito de prueba y después el plan Hobby son $5 al mes |
Se cambia con la variable ANTHROPIC_MODEL, sin tocar código.
| Modelo | ID | Precio por millón de tokens | Cuándo usarlo |
|---|---|---|---|
| Claude Opus 5 | claude-opus-5 |
$5 entrada / $25 salida | El agente razona sobre catálogos, agendas o reglas complejas |
| Claude Sonnet 5 | claude-sonnet-5 |
$3 / $15 | Default. El balance correcto para atención a clientes |
| Claude Haiku 4.5 | claude-haiku-4-5 |
$1 / $5 | Solo preguntas frecuentes y respuestas cortas |
El cálculo, sin trampa. Un chatbot no cobra por mensaje: cobra por token, y en cada turno se le v