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

# Mulai Cepat

> Jalankan GOWA, tautkan akun WhatsApp, dan kirim pesan pertama Anda dalam beberapa menit.

## 1. Jalankan server

> [tab] Docker
>
> ```bash theme={null}
> docker run -d --name gowa \
>   -p 3000:3000 \
>   -v gowa_storages:/app/storages \
>   -v gowa_statics:/app/statics \
>   -e APP_BASIC_AUTH=admin:changeme \
>   aldinokemal2104/go-whatsapp-web-multidevice:latest
> ```
>
> Perintah bawaan image adalah `rest`, sehingga tidak perlu argumen tambahan. Image yang sama diterbitkan sebagai `ghcr.io/aldinokemal/go-whatsapp-web-multidevice`.

> [tab] Biner
>
> Unduh arsip untuk platform Anda dari [rilis stabil terbaru](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest). Contoh ini menggunakan arsip Linux amd64 v9.9.0. Sesuaikan nama berkas dengan yang Anda unduh.
>
> ```bash theme={null}
> unzip whatsapp_9.9.0_linux_amd64.zip
> chmod +x whatsapp
> ./whatsapp rest --basic-auth=admin:changeme
> ```
>
> Instal FFmpeg dan libwebp (`cwebp`) terlebih dahulu; GOWA menggunakannya untuk konversi media.

> [tab] Dari kode sumber
>
> Memerlukan Go 1.26+, FFmpeg, dan libwebp.
>
> ```bash theme={null}
> git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
> cd go-whatsapp-web-multidevice/src
> go run . rest --basic-auth=admin:changeme
> ```

Pastikan server berjalan:

```bash theme={null}
curl http://localhost:3000/health
# OK
```

> [!NOTE]
>
> Listener non-loopback bawaan memerlukan kredensial `APP_BASIC_AUTH` yang lengkap. Untuk pengembangan lokal tanpa autentikasi, gunakan alamat bind `APP_HOST=127.0.0.1`. Reverse proxy yang melakukan autentikasi dapat menggunakan pengaturan eksplisit `APP_ALLOW_UNAUTHENTICATED=true`. Lihat [autentikasi](https://gowa-docs.mintlify.site/id/authentication.md).

## 2. Buat perangkat

Setiap akun WhatsApp menempati satu slot perangkat. Buat slot dan tetapkan ID yang akan Anda gunakan kembali:

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/devices \
  -H "Content-Type: application/json" \
  -d '{"device_id": "my-device"}'
```

Hilangkan `device_id` untuk mendapatkan UUID yang dibuat otomatis.

## 3. Tautkan akun

> [tab] Kode QR
>
> ```bash theme={null}
> curl -u admin:changeme http://localhost:3000/devices/my-device/login
> ```
>
> Buka `results.qr_link` di browser dan pindai melalui WhatsApp → **Perangkat tertaut** → **Tautkan perangkat**. Kode kedaluwarsa setelah `results.qr_duration` detik; minta kode baru jika masa berlakunya habis.

> [tab] Kode penautan
>
> ```bash theme={null}
> curl -u admin:changeme -X POST \
>   "http://localhost:3000/devices/my-device/login/code?phone=628123456789"
> ```
>
> Masukkan `results.pair_code` di ponsel melalui **Perangkat tertaut** → **Tautkan dengan nomor telepon saja**.

> [tab] Dasbor
>
> Buka `http://localhost:3000/`, masukkan kredensial Basic Auth saat diminta browser, lalu tautkan perangkat melalui antarmuka.

Pastikan perangkat sudah login (`results.is_logged_in` seharusnya bernilai `true`):

```bash theme={null}
curl -u admin:changeme http://localhost:3000/devices/my-device/status
```

## 4. Kirim pesan

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" \
  -H "X-Device-Id: my-device" \
  -d '{"phone": "628123456789", "message": "Hello from GOWA"}'
```

```json theme={null}
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
    "status": "Message sent to 628123456789 (server timestamp: ...)"
  }
}
```

`phone` menerima nomor dengan kode negara tanpa `+` atau spasi, atau JID lengkap seperti `628123456789@s.whatsapp.net` atau `120363025246125486@g.us` untuk grup. Jika hanya satu perangkat terdaftar, `X-Device-Id` bersifat opsional.

## 5. Terima pesan

Jalankan ulang dengan URL webhook dan GOWA akan mengirim setiap peristiwa ke URL tersebut melalui POST:

```bash theme={null}
export WHATSAPP_WEBHOOK_SECRET="$(openssl rand -hex 32)"
./whatsapp rest --basic-auth=admin:changeme --webhook=https://example.com/wa-hook
```

Simpan secret webhook yang dihasilkan dan konfigurasikan nilai yang sama pada penerima Anda. Gunakan kembali setelah server dijalankan ulang. Lihat [Webhook](https://gowa-docs.mintlify.site/id/concepts/webhooks.md) untuk payload dan pemeriksaan tanda tangan.

## Langkah selanjutnya

> [card] [Instalasi](https://gowa-docs.mintlify.site/id/installation.md)
>
> Docker Compose, reverse proxy, PostgreSQL.

> [card] [Referensi konfigurasi](https://gowa-docs.mintlify.site/id/configuration.md)
>
> Semua flag dan variabel lingkungan.

> [card] [Multi-perangkat](https://gowa-docs.mintlify.site/id/concepts/multidevice.md)
>
> Jalankan beberapa akun pada satu server.

> [card] [Referensi API](https://gowa-docs.mintlify.site/id/api-reference/introduction.md)
>
> Semua endpoint.


## Related topics

- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/id/index.md)
- [Batas Pengiriman](https://gowa-docs.mintlify.site/id/advanced/rate-limiting.md)
- [Kirim kehadiran chat (indikator mengetik)](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-kehadiran-chat-indikator-mengetik.md)
- [Login perangkat dengan kode QR](https://gowa-docs.mintlify.site/id/api-reference/device/login-perangkat-dengan-kode-qr.md)
- [Login perangkat dengan kode pemasangan](https://gowa-docs.mintlify.site/id/api-reference/device/login-perangkat-dengan-kode-pemasangan.md)


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