Cómo instalar GOWA con Imagen Docker

Cómo instalar GOWA con Docker y Documentación Básica de la API

Guía paso a paso para desplegar la API multidevice de WhatsApp usando la imagen precompilada y referencia de uso básico.

En este artículo veremos cómo realizar una instalación limpia de GOWA (Go WhatsApp Web Multidevice) utilizando la imagen oficial de Docker Hub, configurando almacenamiento persistente, autenticación básica y revisando los endpoints principales para su consumo.

Estructura de Directorios

/home/docker/gowa/
├── docker-compose.yml # Definición del servicio y comandos
└── storages/ # Almacenamiento persistente para sesiones de WhatsApp

Paso 1: Limpieza e Inicialización

Eliminá contenedores previos y prepará la estructura de directorios en tu servidor:

cd /home/docker
docker rm -f whatsapp whatsapp_go gowa 2>/dev/null || true
rm -rf /home/docker/gowa

mkdir -p /home/docker/gowa/storages
cd /home/docker/gowa

Paso 2: Crear el archivo docker-compose.yml

Creamos el archivo de configuración utilizando la imagen oficial y asignando las credenciales de acceso por Basic Auth:

nano docker-compose.yml

Pegá el siguiente contenido:

services:
  whatsapp:
    image: aldinokemal2104/go-whatsapp-web-multidevice
    container_name: gowa
    restart: unless-stopped
    ports:
      - "3001:3000"
    volumes:
      - ./storages:/app/storages
    command:
      - rest
      - --basic-auth=admin:TuContraseñaSegura
      - --port=3000

Importante: Recordá cambiar admin:TuContraseñaSegura por tus credenciales definitivas antes de iniciar el servicio.

Paso 3: Iniciar el Contenedor

Descargá la imagen y levantá el servicio en segundo plano:

docker compose pull
docker compose up -d

Verificá el estado del contenedor y revisá los registros:

docker ps
docker logs --tail 50 gowa

Documentación Básica de GOWA

Una vez que el servicio esté corriendo, podés acceder directamente mediante la IP del servidor o tu proxy inverso en el puerto configurado (ej: http://IP_SERVIDOR:3001). El sistema solicitará las credenciales configuradas en el comando --basic-auth.

Endpoints Principales de la API REST

Método	Endpoint	Descripción
GET	/app/login	Genera y muestra el código QR para vincular la sesión de WhatsApp.
GET	/app/logout	Cierra la sesión actual y elimina las credenciales vinculadas.
POST	/send/message	Envía un mensaje de texto plano a un número específico.
POST	/send/image	Envía una imagen adjunta con leyenda opcional.

Ejemplo de Solicitud HTTP (Enviar Mensaje de Texto)

Para interactuar con la API mediante herramientas como curl, debés incluir la cabecera de autenticación básica:

curl -X POST http://localhost:3001/send/message \
  -u admin:TuContraseñaSegura \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "595981123456",
    "message": "Hola desde GOWA API!"
  }'

Nota de Persistencia: Todos los datos de sesión, claves de encriptación y estados de conexión se almacenan de manera segura en el directorio montado ./storages, evitando tener que reescanear el código QR cada vez que se reinicie el contenedor.