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

# Hızlı başlangıç

> GOWA’yı çalıştırın, bir WhatsApp hesabını eşleştirin ve birkaç dakika içinde ilk mesajınızı gönderin.

## 1. Sunucuyu başlatın

> [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
> ```
>
> İmajın varsayılan komutu `rest` olduğundan argüman gerekmez. Aynı imaj `ghcr.io/aldinokemal/go-whatsapp-web-multidevice` adıyla da yayımlanır.

> [tab] Çalıştırılabilir dosya
>
> Platformunuza uygun arşivi [en son kararlı sürümden](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest) indirin. Bu örnekte v9.9.0 Linux amd64 arşivi kullanılır. Dosya adını indirdiğiniz dosyanın adıyla değiştirin.
>
> ```bash theme={null}
> unzip whatsapp_9.9.0_linux_amd64.zip
> chmod +x whatsapp
> ./whatsapp rest --basic-auth=admin:changeme
> ```
>
> Önce FFmpeg ve libwebp (`cwebp`) kurun; GOWA bunları medya dönüştürmek için kullanır.

> [tab] Kaynak koddan
>
> Go 1.26+, FFmpeg ve libwebp gerektirir.
>
> ```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
> ```

Çalıştığını kontrol edin:

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

> [!NOTE]
>
> Varsayılan, geri döngü dışı dinleyici eksiksiz `APP_BASIC_AUTH` kimlik bilgileri gerektirir. Kimlik doğrulamasız yerel geliştirme için `APP_HOST=127.0.0.1` adresine bağlayın. Kimlik doğrulaması yapan bir ters vekil, açıkça belirtilen `APP_ALLOW_UNAUTHENTICATED=true` geçersiz kılma ayarını kullanabilir. [Kimlik doğrulamaya](https://gowa-docs.mintlify.site/tr/authentication.md) bakın.

## 2. Bir cihaz oluşturun

Her WhatsApp hesabı bir cihaz yuvasında bulunur. Bir yuva oluşturun ve daha sonra da kullanacağınız bir kimlik verin:

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

Otomatik oluşturulmuş bir UUID almak için `device_id` alanını belirtmeyin.

## 3. Hesabı eşleştirin

> [tab] QR kodu
>
> ```bash theme={null}
> curl -u admin:changeme http://localhost:3000/devices/my-device/login
> ```
>
> `results.qr_link` adresini tarayıcıda açın ve WhatsApp → **Bağlı cihazlar** → **Cihaz bağla** yolundan tarayın. Kodun süresi `results.qr_duration` saniye sonra dolar; süresi dolarsa yeni bir kod isteyin.

> [tab] Eşleştirme kodu
>
> ```bash theme={null}
> curl -u admin:changeme -X POST \
>   "http://localhost:3000/devices/my-device/login/code?phone=628123456789"
> ```
>
> Telefonda **Bağlı cihazlar** → **Bunun yerine telefon numarasıyla bağla** bölümüne `results.pair_code` değerini girin.

> [tab] Kontrol paneli
>
> `http://localhost:3000/` adresini açın, tarayıcı istediğinde Basic Auth kimlik bilgilerinizi girin ve cihazı arayüzden eşleştirin.

Cihazda oturum açıldığını doğrulayın (`results.is_logged_in` değeri `true` olmalıdır):

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

## 4. Bir mesaj gönderin

```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`, ülke kodunu içeren, `+` veya boşluk içermeyen bir numara ya da `628123456789@s.whatsapp.net` veya bir grup için `120363025246125486@g.us` gibi tam bir JID kabul eder. Yalnızca bir cihaz kayıtlıysa `X-Device-Id` isteğe bağlıdır.

## 5. Mesajları alın

Bir webhook URL’siyle yeniden başlatın; GOWA her olayı bu adrese POST ile gönderecektir:

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

Oluşturulan webhook gizli anahtarını kaydedin ve alıcınızda aynı değeri yapılandırın. Yeniden başlatmalardan sonra da bu anahtarı kullanın. Yükler ve imza denetimleri için [Webhook’lara](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md) bakın.

## Sonraki adımlar

> [card] [Kurulum](https://gowa-docs.mintlify.site/tr/installation.md)
>
> Docker Compose, ters vekil, PostgreSQL.

> [card] [Yapılandırma başvurusu](https://gowa-docs.mintlify.site/tr/configuration.md)
>
> Tüm bayraklar ve ortam değişkenleri.

> [card] [Çoklu cihaz](https://gowa-docs.mintlify.site/tr/concepts/multidevice.md)
>
> Tek sunucuda birden fazla hesap çalıştırın.

> [card] [API başvurusu](https://gowa-docs.mintlify.site/tr/api-reference/introduction.md)
>
> Tüm uç noktalar.


## Related topics

- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/tr/index.md)
- [Kurulum](https://gowa-docs.mintlify.site/tr/installation.md)
- [Kimlik doğrulama](https://gowa-docs.mintlify.site/tr/authentication.md)
- [Yapılandırma başvurusu](https://gowa-docs.mintlify.site/tr/configuration.md)
- [Gönderim Sınırları](https://gowa-docs.mintlify.site/tr/advanced/rate-limiting.md)


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