# Instrucciones para el agente: 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](https://waha.devlike.pro/docs/overview/quick-start/):

```bash
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

```bash
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.