Langsung ke konten utama
GOWA membaca konfigurasi dari tiga tempat:
  • Flag baris perintah pada whatsapp rest (jalankan ./whatsapp rest --help untuk daftar lengkap).
  • Variabel lingkungan.
  • Berkas .env di direktori kerja (src/.env saat dijalankan dari kode sumber; salin src/.env.example).
Berkas .env hanya mengisi variabel yang belum ditetapkan di lingkungan.
Dalam kode saat ini, variabel lingkungan (termasuk .env) diterapkan setelah flag diurai, sehingga variabel yang ditetapkan akan menimpa flag yang sesuai. Pengaturan OAuth MCP, --allow-unauthenticated, --trusted-origins, --chatwoot-webhook-allow-unsigned, dan --webhook-all-device-receipts merupakan pengecualian: flag eksplisitnya diutamakan. Tetapkan setiap opsi hanya di satu tempat. Misalnya, WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY=true menimpa --webhook-insecure-skip-verify=false.
Boolean menerima true/false. Durasi menggunakan sintaks Go (30s, 5m, 3h). Nilai daftar dipisahkan dengan koma.

Perintah

Server

Dasbor

MCP

Lihat Server MCP.

Penyimpanan

Penyimpanan chat (chat, pesan, jadwal) selalu berada di storages/chatstorage.db dan tidak dapat dikonfigurasi. Basis data SQLite untuk sesi, penyimpanan chat, dan OAuth dibuat dengan izin 0600. Direktori yang dibuat GOWA untuk berkas tersebut menggunakan 0700. Izin direktori yang sudah ada tetap dipertahankan. Perubahan izin yang tidak didukung sistem berkas dicatat sebagai peringatan. Untuk penyimpanan sesi dan kunci PostgreSQL, sslmode yang tidak disertakan atau kosong menggunakan nilai bawaan verify-full untuk target koneksi jarak jauh. localhost, IP loopback, dan socket Unix menggunakan nilai bawaan disable. Pengaturan URI eksplisit, PGSSLMODE, dan konfigurasi layanan tetap berlaku. Entri PGSERVICE dapat menimpa host URI dan mode TLS. Untuk PostgreSQL terkelola, berikan sslmode=verify-full dan konfigurasi CA yang diperlukan secara eksplisit.

Perilaku WhatsApp

Webhook

Lihat Webhook.

Chatwoot

Filter peristiwa dan opsi penarikan pesan satu arah tersedia pada main GOWA setelah v9.9.0. Lihat integrasi Chatwoot untuk perilaku dan contoh.

Batas tetap

Batas ini ditetapkan saat kompilasi dan tidak dapat diubah melalui konfigurasi:

Unduhan URL media

Permintaan pengiriman yang mengambil media, dokumen, atau pratinjau tautan menerima URL HTTP dan HTTPS. Pengambilan URL publik menolak tujuan loopback, privat, link-local, metadata, multicast, dan yang dicadangkan. Pengalihan dan alamat yang benar-benar dihubungi diperiksa. Unduhan ini terhubung langsung dan tidak menggunakan HTTP_PROXY atau HTTPS_PROXY. GOWA dapat membaca URL /statics miliknya sendiri dari disk. Unduhan lampiran Chatwoot dapat menggunakan tujuan Chatwoot yang dikonfigurasi atau host yang diizinkan, termasuk host internal jika dipercaya melalui integrasi tersebut. Pengecualian ini tidak berlaku untuk URL sembarang yang dikirim ke API pengiriman. Gunakan unggahan berkas jika sumbernya privat.

Tidak digunakan

src/.env.example mencantumkan WHATSAPP_WEBHOOK_INCLUDE_OUTGOING dan WHATSAPP_CHAT_STORAGE, tetapi kode saat ini tidak membaca keduanya. Menetapkannya tidak berpengaruh.

Contoh

.env
Flag yang setara: