Langsung ke konten utama
GOWA hanya mendukung HTTP Basic Auth: REST API tidak menggunakan API key, bearer token, atau JWT. (MCP juga dapat menerima token OAuth; lihat Server MCP.)

Konfigurasi

Setiap pasangan user:pass yang dipisahkan koma merupakan kredensial login yang valid. Setiap entri harus berisi nama pengguna dan kata sandi. Listener pada alamat non-loopback tidak akan dijalankan tanpa kredensial lengkap. Gunakan APP_HOST=127.0.0.1 untuk pengembangan lokal tanpa autentikasi. Gunakan APP_ALLOW_UNAUTHENTICATED=true hanya jika reverse proxy mengautentikasi pemanggil dan akses langsung ke GOWA dibatasi.

Mengirim kredensial

Kredensial yang salah atau tidak disertakan menghasilkan 401 Unauthorized.

Rute publik

WebSocket

Browser tidak dapat mengatur header pada koneksi WebSocket, sehingga /ws juga menerima /ws?device_id=my-device&authorization=<base64 user:pass>. Gunakan wss:// dan samarkan kredensial dalam log proxy. WebSocket dan rute HTTP yang mengubah status menolak origin browser yang tidak tepercaya. Tetapkan origin dasbor secara persis di APP_TRUSTED_ORIGINS atau APP_CORS_ALLOWED_ORIGINS. Origin CORS wildcard tidak memberikan akses ini, dan origin null dari halaman file:// ditolak. Perubahan melalui HTTP dari origin yang tidak tepercaya menghasilkan 403 CROSS_SITE_REQUEST_BLOCKED. Lihat konfigurasi akses browser.

Header perangkat

Basic Auth mengidentifikasi pemanggil API, bukan akun WhatsApp. Setiap panggilan yang terikat pada perangkat juga memerlukan X-Device-Id jika terdapat lebih dari satu perangkat. Lihat Multiperangkat.
Basic Auth mengirimkan kredensial pada setiap permintaan. Selalu gunakan HTTPS di depan GOWA jika diakses dari luar jaringan tepercaya.