Watch16.5kFork43.9k
GUIA.md4 secciones · 5 prompts

WhatsApp en tu sistema, sin perder el número

Instalá WA-AKG, un panel gratuito para manejar WhatsApp desde tu propia computadora, y configuralo para no quemar tu número.

01Instalalo con Claude Code

Abrí Claude Code en cualquier carpeta y pegale este prompt. El link del repo va adentro, por si el prompt viaja solo.

Repositorio oficial en GitHub
github.com/mrifqidaffaaditya/WA-AKG
Abrir en GitHub ↗

Este es el link que le pasás a Claude, no el de esta página.

Pegar en Claude Code
Quiero instalar WA-AKG en esta computadora para manejar WhatsApp desde un panel propio. Repo: https://github.com/mrifqidaffaaditya/WA-AKG

Hacelo vos, paso a paso, y frená cada vez que necesites algo mío.

1. Revisá si tengo Git, Node.js 20 o superior (ideal 22) y Docker. Si falta algo, decime qué instalar y esperá.
2. Cloná el repo en una carpeta nueva llamada wa-akg e instalá las dependencias.
3. Levantá MySQL 8 en un contenedor de Docker, con un volumen para que los datos no se pierdan al reiniciar. La app la corrés con Node, no con el docker-compose del repo.
4. Creá el .env a partir de .env.example:
- DATABASE_URL apuntando a esa base MySQL.
- AUTH_SECRET aleatorio, de 32 caracteres o más.
- TZ y LOCALE con mi zona horaria y mi país (preguntame).
- NEXT_PUBLIC_SWAGGER_PASSWORD: cambiala por una aleatoria.
- BAILEYS_LOG_LEVEL en "error".
5. Corré npm run db:push para crear las tablas.
6. Pedime un email y una contraseña y creá el administrador con npm run make-admin.
7. Arrancá el servidor y comprobá vos que el panel abre en http://localhost:3000 y que puedo iniciar sesión.
8. Si estoy en Windows: el script "start" del package.json usa sintaxis de Linux. Buscá la forma equivalente.
9. Al final, explicame cómo volver a prenderlo después de reiniciar la PC.

No conectes ningún número de WhatsApp: eso lo hago yo desde el panel.
No actives el envío masivo ni toques la configuración anti-spam.

Solo funciona con la compu prendida

WA-AKG corre en tu máquina. Si la apagás, deja de responder. Para que conteste las 24 horas hace falta subirlo a un servidor, y eso también se lo podés pedir a Claude Code.

02Conectalo y ponelo a trabajar

El número lo conectás vos desde el panel. Lo demás se lo podés pedir a Claude Code, que usa la API de WA-AKG.

Conectar el número

En el panel, entrá a Sessions / QR y creá una sesión nueva.

En el celular: WhatsApp → Dispositivos vinculados → Vincular un dispositivo, y escaneá el QR.

En Webhooks & API copiá tu API key: Claude Code la necesita para lo que sigue.

Respuestas automáticas a las preguntas de siempre

Pedido a Claude Code
WA-AKG corre en http://localhost:3000 y mi API key es [pegala acá]. Para mi sesión, creá respuestas automáticas por palabra clave: si escriben "horario", respondé [tu horario]; si escriben "precios", respondé [tu texto]. Que funcionen solo en chats privados, no en grupos.

Recordatorios a clientes que ya te escribieron

Pedido a Claude Code
Con la API de WA-AKG, programá para mañana a las 9:00 un recordatorio de turno a [número], que ya es cliente y me escribió antes. Mostrame cómo quedó en el Scheduler.

Conectarlo con n8n

Pedido a Claude Code
Instalá en mi n8n el nodo comunitario n8n-nodes-wa-akg y armame un flujo: cuando entra un

03Cómo no perder el número

WA-AKG no usa la API oficial de WhatsApp: se conecta igual que WhatsApp Web, con una librería no oficial. Nada garantiza que no te bloqueen. Lo que sigue baja el riesgo , no lo elimina.

Qué activar y qué dejar apagado

Respuestas automáticasActivarContestás a alguien que te escribió primero. Es el uso más seguro.
Mensajes programadosActivar, con cuidadoSolo a quien ya es cliente o te escribió antes. Nunca a números nuevos.
Webhooks y n8nActivarLeen lo que entra. No mandan nada por su cuenta.
Anti-Ban ProtectionActivarViene apagada . Está en Bot Settings → Enable Anti-Spam Delay.
Broadcast (envío masivo)Dejar apagadoMandar el mismo texto a muchos que no te escribieron es lo que hace que te reporten. La demora aleatoria no lo arregla.

El número principal del negocio no va acá

Si lo bloquean, perdés el número y el historial de conversaciones con tus clientes. Para ese número, la opción segura es la API oficial de WhatsApp Business. WA-AKG va con un número que puedas perder.

Las reglas

Empezá con un número de prueba. Uno que no te duela perder, hasta saber cómo se comporta.

Si el número es nuevo, usalo a mano unos días antes de automatizarlo. Un número recién creado que de entrada manda mensajes automáticos es el patrón más sospechoso.

Respondé, no salgas a buscar. Que la conversación la empiece siempre la otra persona.

Lo que más pesa son los reportes. Cada vez que alguien te bloquea o te marca como spam, el número pierde confianza. Si no te esperaban, no les escribas.

Variá los textos. El mismo mensaje idéntico a muchos números es la firma del spam.

Un número, un solo sistema. No lo conectes en WA-AKG y en otra herramienta parecida al mismo tiempo.

Si igual vas a usar el envío masivo

Solo a contactos que te escribieron o aceptaron recibir mensajes, en tandas chicas, y con la demora del panel al máximo (15 segundos). Ojo: la que viene por defecto es de 2 segundos.

Pedido a Claude Code
En WA-AKG, activá la protección anti-spam de mi sesión (Bot Settings → Enable Anti-Spam Delay) con un límite de 3 mensajes cada 60 segundos y una demora aleatoria de entre 8 y 20 segundos. Después mostrame la configuración guardada.

04Lo que encontramos en el código

Revisamos el repo antes de recomendarlo. No lo instalamos con un número real, así que esto sale de leer el código y los issues abiertos, no de usarlo.

El envío "seguro" es más rápido de lo que dice

El README promete demoras aleatorias de 10 a 30 segundos. En el código, la demora por defecto es de 2 segundos más hasta un 50 % : entre 2 y 3 segundos por mensaje.

La protección anti-spam viene apagada

Y aunque la actives, sus valores de fábrica son de 1 a 3 segundos de demora. Por eso la sección 03 te dice qué valores poner.

Con Docker, el administrador no se crea solo

El comando que crea el usuario dentro del contenedor tiene un error de sintaxis, y hay issues abiertos de que la imagen no arranca. Por eso el prompt corre la app con Node y usa Docker solo para la base de datos.

Un envío masivo puede decir "enviado" y no llegar

Hay un issue abierto que lo reporta. Si mandás algo importante, revisá en el celular que haya llegado.

¿Lo querés a medida para tu negocio?

Armo sistemas y agentes de IA, y doy consultorías y asesorías para equipos en Latinoamérica y España.

Trabajar conmigo
Seguí con estos
RecursosTrabajar conmigo

¿Qué estás precisando ahora mismo?

Automatizar procesos en mi negocio.
→
Aprender de IA.consultorías y asesorías
→
Un proyecto más grande. Tengo presupuesto.agentes, sistemas, una construcción completa
→

Se abre WhatsApp con el mensaje ya escrito. Lo hablamos por ahí y coordinamos una llamada.