> ## 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.

# Referensi Konfigurasi

> Semua variabel lingkungan dan flag baris perintah GOWA, beserta nilai bawaannya.

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.

> [!WARNING]
>
> 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

| Perintah | Deskripsi |
| - | - |
| `whatsapp rest` | Jalankan REST API, dasbor, WebSocket, dan endpoint MCP. Wajib sejak v6; `whatsapp` tanpa subperintah tidak menjalankan server. |
| `whatsapp version` | Tampilkan versi lalu keluar. |
| `whatsapp --help` | Tampilkan daftar perintah dan flag. |

## Server

| Variabel | Flag | Bawaan | Deskripsi |
| - | - | - | - |
| `APP_PORT` | `--port`, `-p` | `3000` | Port HTTP. |
| `APP_HOST` | `--host`, `-H` | `0.0.0.0` | Alamat bind. |
| `APP_DEBUG` | `--debug`, `-d` | `false` | Pencatatan log terperinci. |
| `APP_OS` | `--os` | `GOWA` | Nama perangkat yang ditampilkan dalam daftar **Perangkat tertaut** WhatsApp. |
| `APP_BASIC_AUTH` | `--basic-auth`, `-b` | — | Pasangan `user:pass` lengkap, dipisahkan dengan koma. Wajib untuk listener non-loopback kecuali pengaturan eksplisit untuk mengizinkan akses tanpa autentikasi ditetapkan. |
| `APP_ALLOW_UNAUTHENTICATED` | `--allow-unauthenticated` | `false` | Izinkan listener non-loopback tanpa Basic Auth. Gunakan hanya di belakang proxy yang melakukan autentikasi, dengan akses langsung dibatasi. |
| `APP_TRUSTED_ORIGINS` | `--trusted-origins` | — | Origin browser tambahan yang harus cocok persis dan diizinkan mengubah status serta membuka WebSocket. Host permintaan dan origin CORS tertentu juga dipercaya. |
| `APP_BASE_PATH` | `--base-path` | — | Sajikan di bawah subpath, misalnya `/gowa`. `/health` tetap di root. |
| `APP_TRUSTED_PROXIES` | `--trusted-proxies` | — | Rentang IP proxy yang header terusan-nya dipercaya, misalnya `10.0.0.0/8`. |
| `APP_CORS_ALLOWED_ORIGINS` | `--cors-allowed-origins` | — (semua origin) | Origin CORS. Origin tertentu juga lolos pemeriksaan origin browser. Wildcard tidak memberikan izin untuk mutasi atau WebSocket. |

## Dasbor

| Variabel | Flag | Bawaan | Deskripsi |
| - | - | - | - |
| `APP_UI_ENABLED` | `--ui-enabled` | `true` | Sajikan dasbor gowa-ui di `/`. |
| `APP_UI_AUTO_UPDATE` | `--ui-auto-update` | `true` | Unduh rilis dasbor terbaru saat startup dan secara berkala. Nonaktifkan untuk host tanpa koneksi jaringan luar yang cache `storages/ui`-nya telah diisi sebelumnya. |
| `APP_UI_REPO` | `--ui-repo` | `aldinokemal/gowa-ui` | Repositori GitHub sumber unduhan. |
| `APP_UI_ASSET_NAME` | `--ui-asset-name` | `gowa-ui.html` | Aset rilis yang akan diunduh. |
| `APP_UI_UPDATE_INTERVAL` | `--ui-update-interval` | `3h` | Interval antarpemeriksaan pembaruan. |
| `APP_UI_GITHUB_TOKEN` | — | — | Token GitHub untuk batas laju API yang lebih tinggi. |
| `APP_UI_ASSET_SHA256` | `--ui-asset-sha256` | — | Hanya sajikan dasbor dengan SHA-256 ini. |

## MCP

| Variabel | Flag | Bawaan | Deskripsi |
| - | - | - | - |
| `MCP_ENABLED` | `--mcp-enabled` | `true` | Sajikan endpoint MCP di `/mcp`. |
| `MCP_OAUTH_ENABLED` | `--mcp-oauth-enabled` | `false` | Aktifkan OAuth 2.1 untuk `/mcp`. Memerlukan `APP_BASIC_AUTH`. |
| `MCP_OAUTH_ISSUER_URL` | `--mcp-oauth-issuer-url` | — | URL HTTPS publik penerbit. Wajib jika menggunakan OAuth. |
| `MCP_OAUTH_RESOURCE_URL` | `--mcp-oauth-resource-url` | penerbit + base path + `/mcp` | URL MCP publik kanonis. |
| `MCP_OAUTH_DB_URI` | `--mcp-oauth-db-uri` | `file:storages/oauth.db` | Penyimpanan SQLite untuk klien OAuth dan hash token. |

Lihat [Server MCP](https://gowa-docs.mintlify.site/id/integrations/mcp.md).

## Penyimpanan

| Variabel | Flag | Bawaan | Deskripsi |
| - | - | - | - |
| `DB_URI` | `--db-uri` | `file:storages/whatsapp.db` | Penyimpanan sesi: SQLite (`file:...`) atau PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | `--db-keys-uri` | sama dengan `DB_URI` | Penyimpanan terpisah opsional untuk cache kunci enkripsi. Hindari penyimpanan dalam memori di produksi. |
| `CHAT_STORAGE_MAX_OPEN_CONNS` | — | `5` | Jumlah maksimum koneksi SQLite untuk penyimpanan chat. Naikkan jika pengiriman mengalami timeout saat beban pesan masuk tinggi. |

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

| Variabel | Flag | Bawaan | Deskripsi |
| - | - | - | - |
| `WHATSAPP_AUTO_REPLY` | `--autoreply` | — | Balasan tetap yang dikirim untuk setiap pesan masuk. |
| `WHATSAPP_AUTO_MARK_READ` | `--auto-mark-read` | `false` | Tandai pesan masuk sebagai telah dibaca. |
| `WHATSAPP_AUTO_DOWNLOAD_MEDIA` | `--auto-download-media` | `true` | Simpan media masuk ke `statics/media`. |
| `WHATSAPP_IGNORE_STATUS_MEDIA` | `--ignore-status-media` | `false` | Lewati pengunduhan media status. |
| `WHATSAPP_AUTO_REJECT_CALL` | `--auto-reject-call` | `false` | Tolak panggilan masuk. |
| `WHATSAPP_ACCOUNT_VALIDATION` | `--account-validation` | `true` | Periksa apakah penerima terdaftar di WhatsApp sebelum mengirim. |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `--presence-on-connect` | `unavailable` | Status kehadiran yang dikirim saat terhubung: `available`, `unavailable`, atau `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `--presence-pulse-enabled` | `true` | Secara berkala online sejenak, lalu offline kembali. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `--presence-pulse-interval` | `24h` | Waktu antaraktivasi kehadiran. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `--presence-pulse-duration` | `5m` | Durasi online setiap aktivasi kehadiran. |
| `WHATSAPP_PROXY` | `--whatsapp-proxy` | — | Proxy untuk koneksi WhatsApp: `socks5://`, `http://`, atau `https://`. `HTTP_PROXY` tidak berlaku untuk koneksi ini. |

## Webhook

| Variabel | Flag | Bawaan | Deskripsi |
| - | - | - | - |
| `WHATSAPP_WEBHOOK` | `--webhook`, `-w` | — | URL webhook, dipisahkan dengan koma. |
| `WHATSAPP_WEBHOOK_SECRET` | `--webhook-secret` | acak per proses | Kunci HMAC untuk `X-Hub-Signature-256`. Tetapkan kunci tetap yang dihasilkan. Nilai kosong, `secret`, `super-secret-key`, dan `your-private-key` akan menghasilkan kunci sementara sebagai gantinya. |
| `WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY` | `--webhook-insecure-skip-verify` | `false` | Lewati verifikasi TLS (hanya untuk pengembangan). |
| `WHATSAPP_WEBHOOK_EVENTS` | `--webhook-events` | — (semua) | Daftar peristiwa yang diizinkan, misalnya `message,message.ack`. |
| `WHATSAPP_WEBHOOK_IGNORE_JIDS` | `--webhook-ignore-jids` | — | JID atau wildcard (`@g.us`, `@s.whatsapp.net`, `@lid`) yang tidak diteruskan. |
| `WHATSAPP_WEBHOOK_DEVICE_MERGE_GLOBAL` | `--webhook-device-merge-global` | `false` | Kirim peristiwa perangkat ke URL global sekaligus ke webhook perangkat itu sendiri. |
| `WHATSAPP_WEBHOOK_ALL_DEVICE_RECEIPTS` | `--webhook-all-device-receipts` | `false` | Teruskan tanda terima dari perangkat tertaut kontak serta perangkat utamanya. Dapat menghasilkan beberapa konfirmasi untuk satu pesan. |

Lihat [Webhook](https://gowa-docs.mintlify.site/id/concepts/webhooks.md).

## Chatwoot

| Variabel | Flag | Bawaan |
| - | - | - |
| `CHATWOOT_ENABLED` | `--chatwoot-enabled` | `false` |
| `CHATWOOT_URL` | — | — |
| `CHATWOOT_API_TOKEN` | — | — |
| `CHATWOOT_ACCOUNT_ID` | — | — |
| `CHATWOOT_INBOX_ID` | — | — |
| `CHATWOOT_DEVICE_ID` | `--chatwoot-device-id` | — |
| `CHATWOOT_ALLOWED_HOSTS` | `--chatwoot-allowed-hosts` | — |
| `CHATWOOT_IMPORT_MESSAGES` | `--chatwoot-import-messages` | `false` |
| `CHATWOOT_DAYS_LIMIT_IMPORT_MESSAGES` | `--chatwoot-days-limit-import-messages` | `3` |
| `CHATWOOT_IMPORT_DB_URI` | `--chatwoot-import-db-uri` | — |
| `CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE` | `--chatwoot-import-placeholder-media-message` | `true` |
| `CHATWOOT_IMPORT_MEDIA_WITH_REST` | `--chatwoot-import-media-with-rest` | `false` |
| `CHATWOOT_AUTO_CREATE` | `--chatwoot-auto-create` | `false` |
| `CHATWOOT_INBOX_NAME` | `--chatwoot-inbox-name` | `WhatsApp` |
| `CHATWOOT_WEBHOOK_URL` | `--chatwoot-webhook-url` | — |
| `CHATWOOT_WEBHOOK_SECRET` | `--chatwoot-webhook-secret` | — |
| `CHATWOOT_WEBHOOK_ALLOW_UNSIGNED` | `--chatwoot-webhook-allow-unsigned` | `false` |
| `CHATWOOT_WEBHOOK_SIGNATURE_TOLERANCE` | `--chatwoot-webhook-signature-tolerance` | `5m` |
| `CHATWOOT_REOPEN_CONVERSATION` | `--chatwoot-reopen-conversation` | `true` |
| `CHATWOOT_CONVERSATION_PENDING` | `--chatwoot-conversation-pending` | `false` |
| `CHATWOOT_IGNORE_JIDS` | `--chatwoot-ignore-jids` | — |
| `CHATWOOT_SIGN_MSG` | `--chatwoot-sign-msg` | `false` |
| `CHATWOOT_SIGN_DELIMITER` | `--chatwoot-sign-delimiter` | `\n\n` |
| `CHATWOOT_FORWARD_EDITS` | `--chatwoot-forward-edits` | `true` |
| `CHATWOOT_FORWARD_DELETES` | `--chatwoot-forward-deletes` | `true` |
| `CHATWOOT_EVENTS` | `--chatwoot-events` | Mengikuti `WHATSAPP_WEBHOOK_EVENTS` jika kosong |
| `CHATWOOT_MESSAGE_READ` | `--chatwoot-message-read` | `false` |
| `CHATWOOT_MESSAGE_DELETE` | `--chatwoot-message-delete` | `false` |
| `CHATWOOT_REVOKE_ON_DELETE` | `--chatwoot-revoke-on-delete` | `false` |

Filter peristiwa dan opsi penarikan pesan satu arah tersedia pada `main` GOWA setelah v9.9.0. Lihat [integrasi Chatwoot](https://gowa-docs.mintlify.site/id/integrations/chatwoot.md#konfigurasi) untuk perilaku dan contoh.

## Batas tetap

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

| Batas | Nilai |
| - | - |
| Unggahan gambar | 20 MB |
| Unggahan dokumen | 50 MB |
| Unggahan video dan body permintaan HTTP | 100 MB |
| Unduhan media masuk | 500 MB |
| Timeout permintaan | 45 s (`504 GATEWAY_TIMEOUT`) |
| Pengiriman webhook | 10 s per percobaan, 5 percobaan |

## 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

```bash .env theme={null}
APP_PORT=3000
APP_OS=MyCompany
APP_BASIC_AUTH=admin:a-long-random-password
APP_TRUSTED_PROXIES=10.0.0.0/8
DB_URI=postgres://gowa:replace-with-password@db.example.com:5432/gowa?sslmode=verify-full
WHATSAPP_WEBHOOK=https://example.com/wa-hook
WHATSAPP_WEBHOOK_SECRET=another-long-random-secret
WHATSAPP_WEBHOOK_EVENTS=message,message.ack
WHATSAPP_AUTO_MARK_READ=false
```

Flag yang setara:

```bash theme={null}
./whatsapp rest --port=3000 --os=MyCompany \
  --basic-auth=admin:a-long-random-password \
  --webhook=https://example.com/wa-hook \
  --webhook-secret=another-long-random-secret \
  --webhook-events=message,message.ack
```


## Related topics

- [Mulai Cepat](https://gowa-docs.mintlify.site/id/quickstart.md)
- [Integrasi Chatwoot](https://gowa-docs.mintlify.site/id/integrations/chatwoot.md)
- [Dapatkan konfigurasi Chatwoot perangkat](https://gowa-docs.mintlify.site/id/api-reference/chatwoot/dapatkan-konfigurasi-chatwoot-perangkat.md)
- [Hapus konfigurasi Chatwoot perangkat](https://gowa-docs.mintlify.site/id/api-reference/chatwoot/hapus-konfigurasi-chatwoot-perangkat.md)
- [Referensi API](https://gowa-docs.mintlify.site/id/api-reference/introduction.md)


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