> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Praktik Terbaik untuk Produksi

> Jalankan GOWA dengan aman di produksi: keamanan, penyimpanan, pencadangan, reverse proxy, pemantauan, dan praktik pengiriman.

## Keamanan

* **Atur `APP_BASIC_AUTH`** dengan kata sandi acak yang panjang. Bind ke alamat non-loopback memerlukan kredensial, kecuali `APP_ALLOW_UNAUTHENTICATED=true` secara eksplisit menonaktifkan pemeriksaan tersebut. Loopback dapat berjalan tanpa kredensial untuk pengembangan lokal.
* **Atur `WHATSAPP_WEBHOOK_SECRET` secara eksplisit.** Tanpanya, GOWA membuat kunci acak yang berubah setiap kali dimulai ulang. Verifikasi `X-Hub-Signature-256` terhadap body permintaan mentah. Tetap aktifkan verifikasi TLS untuk webhook keluar.
* **Lakukan terminasi TLS** di reverse proxy; GOWA sendiri menggunakan HTTP biasa.
* **Batasi `/statics`.** Kode QR dan media yang diunduh di `/statics/*` disajikan **tanpa** Basic Auth. Blokir atau lindungi jalur tersebut di proxy jika media bersifat sensitif, dan bersihkan `statics/media` secara rutin.
* **Jangan mengekspos `/chatwoot/webhook` tanpa `CHATWOOT_WEBHOOK_SECRET`** saat Chatwoot diaktifkan.
* **Atur `APP_CORS_ALLOWED_ORIGINS`** jika browser memanggil API secara langsung; CORS wildcard tidak memberikan izin operasi tulis dari browser atau akses `/ws`. Konfigurasikan origin tertentu di `APP_TRUSTED_ORIGINS` atau daftar izin CORS. Lihat [Autentikasi](https://gowa-docs.mintlify.site/id/api-reference/authentication.md).
* **Bind ke alamat privat** (`APP_HOST=127.0.0.1` atau jaringan privat) jika hanya layanan lokal yang memerlukan akses.
* Batasi laju percobaan login yang gagal di proxy; GOWA tidak memiliki [pembatasan laju](https://gowa-docs.mintlify.site/id/advanced/rate-limiting.md) bawaan.

## Penyimpanan dan pencadangan

| Jalur | Isi | Perlu dicadangkan? |
| - | - | - |
| `storages/whatsapp.db` (atau `DB_URI`) | Sesi dan kunci WhatsApp | Ya. Jika hilang, semua perangkat harus ditautkan ulang. |
| `storages/chatstorage.db` | Chat, pesan, jadwal, dan status GOWA lainnya | Ya |
| `storages/oauth.db` | Klien MCP OAuth dan hash token | Jika OAuth digunakan |
| `statics/` | Kode QR, media yang diunduh, dan media terjadwal | Opsional |

* Gunakan PostgreSQL untuk `DB_URI` jika Anda menginginkan pencadangan terkelola; penyimpanan chat selalu menggunakan SQLite.
* Buat cadangan saat GOWA dihentikan, atau gunakan tool pencadangan online database Anda.
* Simpan cadangan dalam bentuk terenkripsi: database sesi setara dengan akun yang sudah login.
* **Jalankan satu instance GOWA per penyimpanan.** Dua proses yang berbagi sesi menyebabkan koneksi terputus dan konflik. GOWA tidak mendukung penskalaan horizontal.

## Docker

```bash theme={null}
docker run -d --name gowa --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v gowa-storages:/app/storages \
  -v gowa-statics:/app/statics \
  -e APP_BASIC_AUTH=admin:a-long-random-password \
  -e WHATSAPP_WEBHOOK=https://example.com/wa-hook \
  -e WHATSAPP_WEBHOOK_SECRET=another-long-random-secret \
  aldinokemal2104/go-whatsapp-web-multidevice:v9.9.0 rest
```

* Gunakan tag versi tertentu alih-alih `latest`, dan baca catatan rilis sebelum melakukan upgrade.
* Container berjalan sebagai pengguna non-root (UID 20001); pastikan volume yang di-mount dapat ditulis.
* Image menetapkan `TZ=UTC`. Jadwal menggunakan `timezone` yang Anda berikan, sehingga pengaturan ini tidak memengaruhinya.

## Reverse proxy

* Atur `APP_TRUSTED_PROXIES` ke rentang alamat proxy Anda agar IP klien dibaca dengan benar.
* Izinkan upgrade WebSocket pada `/ws`.
* Naikkan batas body menjadi setidaknya 100 MB (`client_max_body_size 100m;` di nginx).
* Atur timeout proxy lebih lama dari timeout permintaan GOWA yang sebesar 45 detik.
* Untuk deployment pada subjalur, gunakan `APP_BASE_PATH`; `/health` tetap berada di root.

Lihat [Instalasi](https://gowa-docs.mintlify.site/id/installation.md#di-belakang-reverse-proxy) untuk contoh nginx.

## Pemantauan

* **Liveness:** `GET /health` mengembalikan `200 OK` jika proses dan penyimpanan berjalan. Ini tidak memeriksa WhatsApp.
* **Konektivitas WhatsApp:** periksa `GET /devices/{device_id}/status` secara berkala dan kirim peringatan jika `is_logged_in` bernilai `false`.
* **Event:** berlangganan webhook dan kirim peringatan jika tidak ada lalu lintas pada nomor yang biasanya aktif.
* **Log:** kumpulkan stdout container; gunakan `APP_DEBUG=true` hanya saat menelusuri masalah.

GOWA tersambung kembali secara otomatis saat dimulai dan memeriksa koneksi setiap 5 menit. Perangkat yang dikeluarkan dari akun melalui ponsel harus ditautkan ulang.

`GET /app/metrics` mengembalikan metrik proses, memori, disk, dan perangkat dengan autentikasi, tanpa perlu memilih perangkat. Lihat [Metrik server](https://gowa-docs.mintlify.site/id/api-reference/metrics.md). Kirim peringatan untuk webhook `device.logged_out`, `device.temporary_ban`, dan `device.reachout_timelock`.

## Penerima webhook

* Balas dengan `2xx` dalam 10 detik; proses pekerjaan secara asinkron.
* Hilangkan duplikat berdasarkan perangkat, jenis event, dan pengenal event. ID pesan saja tidak membedakan edit, reaksi, atau status tanda terima berikutnya.
* Setelah 5 percobaan gagal, event dibuang. Gunakan `GET /chats` dan `GET /chat/{jid}/messages` untuk mengambil data yang tertinggal setelah gangguan.

## Praktik pengiriman

* Kirim pesan kepada orang yang telah menyetujui atau menghubungi lebih dahulu.
* Atur laju pengiriman dengan jeda dan variasi acak; hindari teks massal yang identik.
* Hentikan pengiriman saat menerima `WA_REACHOUT_TIMELOCK`.
* Tetap aktifkan `WHATSAPP_ACCOUNT_VALIDATION=true` agar nomor yang tidak terdaftar segera ditolak.
* WhatsApp mengizinkan hingga empat perangkat pendamping tertaut per akun, dan memutus tautan perangkat pendamping setelah sekitar 14 hari jika ponsel tetap offline.


## Related topics

- [Menerima pesan](https://gowa-docs.mintlify.site/id/examples/receiving-messages.md)
- [Referensi Konfigurasi](https://gowa-docs.mintlify.site/id/configuration.md)
- [Sesi & Siklus Koneksi](https://gowa-docs.mintlify.site/id/concepts/sessions.md)
- [Tolak permintaan peserta untuk bergabung ke grup](https://gowa-docs.mintlify.site/id/api-reference/group/tolak-permintaan-peserta-untuk-bergabung-ke-grup.md)
- [Setujui permintaan peserta untuk bergabung ke grup](https://gowa-docs.mintlify.site/id/api-reference/group/setujui-permintaan-peserta-untuk-bergabung-ke-grup.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.