Saltar al contenido principal

1. Iniciar el servidor

El comando predeterminado de la imagen es rest, así que no se necesitan argumentos. La misma imagen se publica como ghcr.io/aldinokemal/go-whatsapp-web-multidevice.
Compruebe que ha terminado:
El oyente no loopback por defecto requiere credenciales completas APP_BASIC_AUTH. Para un desarrollo local no autenticado, vincula APP_HOST=127.0.0.1. Un proxy de autenticación inversa puede usar la anulación explícita APP_ALLOW_UNAUTHENTICATED=true. Vea authentication.

2. Crear un dispositivo

Cada cuenta de WhatsApp vive en una ranura de dispositivo. Crea una y dale un ID que reutilizará:
Omita device_id para obtener un UUID generado.

3. Emparejar la cuenta

Abre results.qr_link en un navegador y escanéalo desde WhatsApp → Dispositivos enlazados → Vincula un dispositivo. El código expira después de results.qr_duration segundos; solicite uno nuevo si se repite.
Confirma que el dispositivo está conectado (results.is_logged_in debe ser true):

4. Enviar un mensaje

phone toma un número con código de país y sin + o espacios, o un JID completo como 628123456789@s.whatsapp.net o 120363025246125486@g.us para un grupo. Con solo un dispositivo registrado, X-Device-Id es opcional.

5. Recibir mensajes

Reinicia con un webhook URL y GOWA POST cada evento a él:
Guarde el secreto de webhook generado y configure el mismo valor en su receptor. Reutilizarlo después de reiniciar. Ver Webhooks para cargas útiles y comprobaciones de firmas.

Siguientes pasos

Instalación

Docker Compose, proxy inverso, PostgreSQL.

Referencia de configuración

Cada bandera y variable de entorno.

Multi-dispositivo

Ejecutar varias cuentas en un servidor.

Referencia API

Todos los extremos.