Saltar al contenido principal
GOWA soporta HTTP Basic Auth y nada más: no hay claves API, fichas portadoras o JWTs para la API REST. (MCP puede aceptar adicionalmente fichas de OAuth; vea Servidor MCP.)

Configurar

Cada par user:pass separado por comas es un inicio de sesión válido. Cada entrada debe contener un nombre de usuario y una contraseña. Un servidor que escucha en una dirección que no sea de bucle local se niega a iniciar sin credenciales completas. Configura APP_HOST=127.0.0.1 para el desarrollo local sin autenticación. Usa APP_ALLOW_UNAUTHENTICATED=true solo cuando un proxy inverso autentique a los clientes y el acceso directo a GOWA esté restringido.

Enviar credenciales

Credenciales incorrectas o faltantes devuelven 401 Unauthorized.

Rutas públicas

WebSocket

Los navegadores no pueden establecer encabezados en conexiones WebSocket, así que /ws también acepta /ws?device_id=my-device&authorization=<base64 user:pass>. Usa wss:// y redacta credenciales de registros proxy. Las rutas HTTP de WebSocket y cambiantes de estado rechazan los orígenes no confiables del navegador. Establece el origen exacto del tablero en APP_TRUSTED_ORIGINS o APP_CORS_ALLOWED_ORIGINS. Un comodín de origen CORS no concede este acceso, y los orígenes null de páginas file:// son rechazados. mutaciones HTTP de origen no confiable retorno 403 CROSS_SITE_REQUEST_BLOCKED. Vea configuración de acceso al navegador.

Encabezado del dispositivo

Auth Básica identifica a la llamada API, no a la cuenta de WhatsApp. Cada llamada con ámbito de dispositivo también necesita X-Device-Id cuando existe más de un dispositivo. Vea Multi-device.
Basic Auth envía credenciales en cada solicitud. Utilice siempre HTTPS frente a GOWA fuera de una red de confianza.