
whatsapp rest.
Requisitos
Plataformas soportadas: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL recomendado).
Doctor
Las imágenes se publican en Docker Hub y GHCR:aldinokemal2104/go-whatsapp-web-multideviceghcr.io/aldinokemal/go-whatsapp-web-multidevice
/app/storagescontiene las bases de datos SQLite (sesiones, historial de chat, programas, OAuth). Perderlas desemparejan cada dispositivo./app/staticscontiene imágenes QR, subidas y medios descargados.- El comando predeterminado es
rest. Pasar las banderas después de ella, por ejemplo... go-whatsapp-web-multidevice rest --autoreply="Away". - El punto de entrada corrige la propiedad del volumen y deja caer los privilegios a
gowauser(UID 20001, GID 20000). - El tiempo del contenedor es UTC (
TZ=UTC). ReemplazaTZsi necesitas marcas de tiempo de registro locales.
Componer Docker
docker-compose.yml
openssl rand -hex 32 y establece WHATSAPP_WEBHOOK_SECRET en tu shell o Componer .env antes de comenzar este ejemplo.
El propio repositorio docker-compose.yml construye la imagen desde docker/golang.Dockerfile y lee src/.env. Úsalo cuando quieras construir localmente: cp src/.env.example src/.env && docker compose up -d --build.
Liberar binario
Descarga un archivo de GitHub Releases. Los archivos se llamanwhatsapp_<version>_<os>_<arch>.zip, por ejemplo:
checksums.txt de la misma versión. ./whatsapp version imprime la versión; ./whatsapp --help muestra cada bandera.
Desde la fuente
export CGO_CFLAGS_ALLOW="-Xpreprocessor" antes de construir.
ARM sin una toolchain C
La etiqueta de construcciónpurego selecciona un controlador pure-Go SQLite para que pueda compilar de forma cruzada con CGO deshabilitado:
Almacenamiento
Por defecto todo es SQLite bajostorages/:
DB_URI también acepta PostgreSQL, por ejemplo postgres://user:pass@host:5432/gowa?sslmode=verify-full. La sesión remota PostgreSQL almacena por defecto la verificación de certificados cuando no se ha establecido ningún modo TLS efectivo. La URI explícita, el entorno o la configuración TLS del servicio PostgreSQL siguen aplicándose. Vea configuración de almacenamiento.
GOWA crea archivos SQLite con permisos 0600 de solo propietario y nuevos directorios padres con 0700. Los directorios existentes mantienen sus permisos. Copia de seguridad storages/ (o PostgreSQL más storages/) para mantener emparejados dispositivos a través de reconstrucciones. Trata estas copias de seguridad como credenciales.
Beind a un proxy inverso
Sirve GOWA bajo una subruta conAPP_BASE_PATH, y confía en las cabeceras reenviadas por el proxy con APP_TRUSTED_PROXIES:
/health permanece en la raíz (/health, no /gowa/health) así que las sondas funcionan independientemente del camino base.
El protector de origen del navegador necesita el host público. Preservar Host como arriba, o enviar X-Forwarded-Host desde un proxy de confianza. Un dashboard alojado por separado necesita su origen exacto en APP_TRUSTED_ORIGINS o APP_CORS_ALLOWED_ORIGINS. Un comodín no autoriza mutaciones o WebSockets. Sirve el dashboard sobre HTTP o HTTPS, porque las páginas file:// tienen un origen null no confiable.
El oyente por defecto se niega a iniciar sin las credenciales completas de Auth Básica. Sólo habilita APP_ALLOW_UNAUTHENTICATED=true cuando el proxy autentifica llamadas y los clientes no pueden eludirlas. Para desarrollo local sin autenticación, vincula APP_HOST=127.0.0.1.
Verificar
/health devuelve OK una vez inicializado el almacenamiento. No reporta si alguna cuenta de WhatsApp está conectada; usa GET /devices/{device_id}/status para eso.
Actualizando
Copia de seguridadstorages/, tira la nueva imagen o binario, y reinicia. Lee las notas de lanzamiento para romper los cambios primero. Unos notables: v6 hizo obligatorio el subcomando rest, v7 movió binarios a archivos GoReleaser, v8 agregado multidispositivo (las llamadas con ámbito de dispositivo necesitan X-Device-Id una vez más de un dispositivo existe), y el modo independiente whatsapp mcp (:8080/sse) fue reemplazado por el punto final /mcp en el servidor REST.