WAHA: conecta automatizaciones con WhatsApp por HTTP

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

• Dificultad: principiante
• Proyecto: https://github.com/devlikeapro/waha (licencia Apache-2.0)
• Guía completa: https://lab.wisd.ai/hub/waha-whatsapp

Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Preparación

Comprueba Docker en ejecución, puerto 3000 libre y una cuenta WhatsApp de ensayo en el teléfono. Abre una carpeta vacía para credenciales y sesiones. Esta ruta usa la imagen publicada, sin Node local. La guía web actual añade una inicialización que el README antiguo omite.

Paso 1: prepara las credenciales

En macOS/Linux, desde esa carpeta, sigue el inicio rápido oficial:

docker pull devlikeapro/waha
docker run --rm -v "$(pwd)":/app/env devlikeapro/waha init-waha /app/env

En ARM usa la variante devlikeapro/waha:arm indicada allí y su etiqueta local antes de continuar. La inicialización escribe .env con credenciales propias; consérvalas privadas.

Paso 2: inicia y vincula

docker run -it --env-file "$(pwd)/.env" -v "$(pwd)/sessions:/app/.sessions" --rm -p 3000:3000 --name waha devlikeapro/waha

Abre http://localhost:3000/dashboard. Entra con WAHA_DASHBOARD_USERNAME y WAHA_DASHBOARD_PASSWORD generados y conecta el servidor con WAHA_API_KEY. Inicia la sesión default; cuando indique SCAN_QR, abre la cámara del panel y escanea desde Dispositivos vinculados de WhatsApp. Espera WORKING.

Paso 3: comprueba un envío propio

En Swagger, http://localhost:3000/#/chatting, autoriza con esa API key y abre POST /api/sendText. Usa session=default, tu propio número internacional sin + terminado en @c.us como chatId, y el texto «Prueba WAHA». Ejecuta una vez y comprueba recepción en ese destino.

Comprobación

Exige estado WORKING, respuesta correcta del envío y recepción real. Vincular el dispositivo por sí solo no verifica la API de mensajes. Detén el contenedor con Ctrl+C al terminar; las sesiones quedan en la carpeta montada.

Si algo falla

Revisa autenticación y estado de la sesión. Si el QR pide recarga, detén e inicia la sesión según la guía. Esta es la ruta inicial de pruebas; para alojarlo sigue la documentación de instalación del proyecto.