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

# Yapılandırma başvurusu

> Varsayılan değerleriyle tüm GOWA ortam değişkenleri ve komut satırı bayrakları.

GOWA yapılandırmayı üç yerden okur:

* `whatsapp rest` üzerindeki **komut satırı bayrakları** (tam liste için `./whatsapp rest --help` çalıştırın).
* **Ortam değişkenleri**.
* Çalışma dizinindeki bir **`.env` dosyası** (kaynak koddan çalıştırırken `src/.env`; `src/.env.example` dosyasını kopyalayın).

`.env` dosyası yalnızca ortamda henüz ayarlanmamış değişkenleri doldurur.

> [!WARNING]
>
> Mevcut kodda ortam değişkenleri (`.env` dahil), bayraklar ayrıştırıldıktan **sonra** uygulanır; bu nedenle ayarlanmış bir değişken ilgili bayrağı geçersiz kılar. MCP OAuth ayarları, `--allow-unauthenticated`, `--trusted-origins`, `--chatwoot-webhook-allow-unsigned` ve `--webhook-all-device-receipts`, açıkça belirtilen bayrakların öncelikli olduğu istisnalardır. Her seçeneği yalnızca tek bir yerde ayarlayın. Örneğin `WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY=true`, `--webhook-insecure-skip-verify=false` değerini geçersiz kılar.

Boole değerleri `true`/`false` kabul eder. Süreler Go sözdizimini kullanır (`30s`, `5m`, `3h`). Liste değerleri virgülle ayrılır.

## Komutlar

| Komut | Açıklama |
| - | - |
| `whatsapp rest` | REST API, kontrol paneli, WebSocket ve MCP uç noktasını başlatır. v6’dan beri zorunludur; tek başına `whatsapp` sunucuyu başlatmaz. |
| `whatsapp version` | Sürümü yazdırır ve çıkar. |
| `whatsapp --help` | Komutları ve bayrakları listeler. |

## Sunucu

| Değişken | Bayrak | Varsayılan | Açıklama |
| - | - | - | - |
| `APP_PORT` | `--port`, `-p` | `3000` | HTTP bağlantı noktası. |
| `APP_HOST` | `--host`, `-H` | `0.0.0.0` | Dinleme adresi. |
| `APP_DEBUG` | `--debug`, `-d` | `false` | Ayrıntılı günlük kaydı. |
| `APP_OS` | `--os` | `GOWA` | WhatsApp’ın **Bağlı cihazlar** listesinde gösterilen cihaz adı. |
| `APP_BASIC_AUTH` | `--basic-auth`, `-b` | — | Virgülle ayrılmış, eksiksiz `user:pass` çiftleri. Kimlik doğrulamasız çalışmaya açıkça izin verilmedikçe geri döngü dışı dinleyici için zorunludur. |
| `APP_ALLOW_UNAUTHENTICATED` | `--allow-unauthenticated` | `false` | Geri döngü dışı dinleyicinin Basic Auth olmadan çalışmasına izin verir. Yalnızca doğrudan erişimin kısıtlandığı, kimlik doğrulaması yapan bir vekilin arkasında kullanın. |
| `APP_TRUSTED_ORIGINS` | `--trusted-origins` | — | Durum değiştirmesine ve WebSocket açmasına izin verilen ek tarayıcı kaynaklarının tam değerleri. İsteğin ana makinesine ve belirli CORS kaynaklarına da güvenilir. |
| `APP_BASE_PATH` | `--base-path` | — | Bir alt yolda sunar; örneğin `/gowa`. `/health` kökte kalır. |
| `APP_TRUSTED_PROXIES` | `--trusted-proxies` | — | İlettikleri başlıklara güvenilen vekil IP aralıkları; örneğin `10.0.0.0/8`. |
| `APP_CORS_ALLOWED_ORIGINS` | `--cors-allowed-origins` | — (tüm kaynaklar) | CORS kaynakları. Belirli kaynaklar tarayıcı kaynak denetimlerini de geçer. Joker karakter, durum değişikliklerine veya WebSocket bağlantılarına izin vermez. |

## Kontrol paneli

| Değişken | Bayrak | Varsayılan | Açıklama |
| - | - | - | - |
| `APP_UI_ENABLED` | `--ui-enabled` | `true` | gowa-ui kontrol panelini `/` yolunda sunar. |
| `APP_UI_AUTO_UPDATE` | `--ui-auto-update` | `true` | Başlangıçta ve belirli aralıklarla kontrol panelinin en son sürümünü indirir. `storages/ui` önbelleği önceden doldurulmuş, ağdan yalıtılmış makinelerde devre dışı bırakın. |
| `APP_UI_REPO` | `--ui-repo` | `aldinokemal/gowa-ui` | İndirmenin yapılacağı GitHub deposu. |
| `APP_UI_ASSET_NAME` | `--ui-asset-name` | `gowa-ui.html` | İndirilecek sürüm dosyası. |
| `APP_UI_UPDATE_INTERVAL` | `--ui-update-interval` | `3h` | Güncelleme denetimleri arasındaki süre. |
| `APP_UI_GITHUB_TOKEN` | — | — | Daha yüksek API istek sınırı için GitHub belirteci. |
| `APP_UI_ASSET_SHA256` | `--ui-asset-sha256` | — | Yalnızca bu SHA-256 değerine sahip kontrol panelini sunar. |

## MCP

| Değişken | Bayrak | Varsayılan | Açıklama |
| - | - | - | - |
| `MCP_ENABLED` | `--mcp-enabled` | `true` | MCP uç noktasını `/mcp` yolunda sunar. |
| `MCP_OAUTH_ENABLED` | `--mcp-oauth-enabled` | `false` | `/mcp` için OAuth 2.1’i etkinleştirir. `APP_BASIC_AUTH` gerektirir. |
| `MCP_OAUTH_ISSUER_URL` | `--mcp-oauth-issuer-url` | — | Genel erişime açık HTTPS sağlayıcı URL’si. OAuth ile zorunludur. |
| `MCP_OAUTH_RESOURCE_URL` | `--mcp-oauth-resource-url` | sağlayıcı + temel yol + `/mcp` | Genel erişime açık kurallı MCP URL’si. |
| `MCP_OAUTH_DB_URI` | `--mcp-oauth-db-uri` | `file:storages/oauth.db` | OAuth istemcileri ve belirteç özetleri için SQLite deposu. |

[MCP sunucusuna](https://gowa-docs.mintlify.site/tr/integrations/mcp.md) bakın.

## Depolama

| Değişken | Bayrak | Varsayılan | Açıklama |
| - | - | - | - |
| `DB_URI` | `--db-uri` | `file:storages/whatsapp.db` | Oturum deposu: SQLite (`file:...`) veya PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | `--db-keys-uri` | `DB_URI` ile aynı | Şifreleme anahtarı önbelleği için isteğe bağlı ayrı depo. Üretimde bellek içi depolardan kaçının. |
| `CHAT_STORAGE_MAX_OPEN_CONNS` | — | `5` | Sohbet deposu için en fazla SQLite bağlantısı. Yoğun gelen trafik altında gönderimler zaman aşımına uğrarsa artırın. |

Sohbet deposu (sohbetler, mesajlar, zamanlamalar) her zaman `storages/chatstorage.db` dosyasında bulunur ve yapılandırılamaz.

Oturumlar, sohbet deposu ve OAuth için SQLite veritabanları `0600` izinleriyle oluşturulur. GOWA’nın bu dosyalar için oluşturduğu dizinlerde `0700` kullanılır. Mevcut dizinler izinlerini korur. Dosya sisteminin desteklemediği izin değişiklikleri uyarı olarak günlüğe kaydedilir.

PostgreSQL oturum ve anahtar depolarında, `sslmode` belirtilmediğinde veya boş olduğunda uzak bağlantı hedefleri için varsayılan `verify-full` olur. `localhost`, geri döngü IP’leri ve Unix soketleri için varsayılan `disable` olur. Açıkça belirtilen URI ayarları, `PGSSLMODE` ve hizmet yapılandırması geçerli kalır. Bir `PGSERVICE` girdisi URI ana makinesini ve TLS modunu geçersiz kılabilir. Yönetilen PostgreSQL için `sslmode=verify-full` ve gerekli CA yapılandırmasını açıkça belirtin.

## WhatsApp davranışı

| Değişken | Bayrak | Varsayılan | Açıklama |
| - | - | - | - |
| `WHATSAPP_AUTO_REPLY` | `--autoreply` | — | Gelen her mesaja gönderilen sabit yanıt. |
| `WHATSAPP_AUTO_MARK_READ` | `--auto-mark-read` | `false` | Gelen mesajları okundu olarak işaretler. |
| `WHATSAPP_AUTO_DOWNLOAD_MEDIA` | `--auto-download-media` | `true` | Gelen medyayı `statics/media` dizinine kaydeder. |
| `WHATSAPP_IGNORE_STATUS_MEDIA` | `--ignore-status-media` | `false` | Durum medyasını indirmeyi atlar. |
| `WHATSAPP_AUTO_REJECT_CALL` | `--auto-reject-call` | `false` | Gelen aramaları reddeder. |
| `WHATSAPP_ACCOUNT_VALIDATION` | `--account-validation` | `true` | Göndermeden önce alıcıların WhatsApp kullanıp kullanmadığını kontrol eder. |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `--presence-on-connect` | `unavailable` | Bağlantı sırasında gönderilen çevrimiçi durum bilgisi: `available`, `unavailable` veya `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `--presence-pulse-enabled` | `true` | Belirli aralıklarla kısa süreliğine çevrimiçi olur, ardından tekrar çevrimdışı olur. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `--presence-pulse-interval` | `24h` | Çevrimiçi olma döngüleri arasındaki süre. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `--presence-pulse-duration` | `5m` | Her döngüde çevrimiçi kalma süresi. |
| `WHATSAPP_PROXY` | `--whatsapp-proxy` | — | WhatsApp bağlantısı için vekil: `socks5://`, `http://` veya `https://`. `HTTP_PROXY` buna uygulanmaz. |

## Webhook’lar

| Değişken | Bayrak | Varsayılan | Açıklama |
| - | - | - | - |
| `WHATSAPP_WEBHOOK` | `--webhook`, `-w` | — | Virgülle ayrılmış webhook URL’leri. |
| `WHATSAPP_WEBHOOK_SECRET` | `--webhook-secret` | her süreç için rastgele | `X-Hub-Signature-256` için HMAC anahtarı. Oluşturulmuş kalıcı bir anahtar ayarlayın. Boş değer, `secret`, `super-secret-key` ve `your-private-key` bunun yerine geçici bir anahtar üretir. |
| `WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY` | `--webhook-insecure-skip-verify` | `false` | TLS doğrulamasını atlar (yalnızca geliştirme için). |
| `WHATSAPP_WEBHOOK_EVENTS` | `--webhook-events` | — (tümü) | İzin verilen olaylar listesi; örneğin `message,message.ack`. |
| `WHATSAPP_WEBHOOK_IGNORE_JIDS` | `--webhook-ignore-jids` | — | İletilmeyen JID’ler veya joker karakterler (`@g.us`, `@s.whatsapp.net`, `@lid`). |
| `WHATSAPP_WEBHOOK_DEVICE_MERGE_GLOBAL` | `--webhook-device-merge-global` | `false` | Cihaz olaylarını kendi webhook’una ek olarak genel URL’lere de gönderir. |
| `WHATSAPP_WEBHOOK_ALL_DEVICE_RECEIPTS` | `--webhook-all-device-receipts` | `false` | Kişilerin ana cihazlarının yanı sıra bağlı cihazlarından gelen alındı bildirimlerini de iletir. Tek bir mesaj için birden fazla onay üretebilir. |

[Webhook’lara](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md) bakın.

## Chatwoot

| Değişken | Bayrak | Varsayılan |
| - | - | - |
| `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` | Boş olduğunda `WHATSAPP_WEBHOOK_EVENTS` değerini izler |
| `CHATWOOT_MESSAGE_READ` | `--chatwoot-message-read` | `false` |
| `CHATWOOT_MESSAGE_DELETE` | `--chatwoot-message-delete` | `false` |
| `CHATWOOT_REVOKE_ON_DELETE` | `--chatwoot-revoke-on-delete` | `false` |

Olay filtresi ve tek yönlü geri alma seçeneği, v9.9.0 sonrasında GOWA `main` dalında kullanılabilir. Davranış ve örnekler için [Chatwoot entegrasyonuna](https://gowa-docs.mintlify.site/tr/integrations/chatwoot.md#yap%C4%B1land%C4%B1rma) bakın.

## Sabit sınırlar

Bunlar derleme sırasında belirlenir ve yapılandırmayla değiştirilemez:

| Sınır | Değer |
| - | - |
| Görsel yükleme | 20 MB |
| Belge yükleme | 50 MB |
| Video yükleme ve HTTP istek gövdesi | 100 MB |
| Gelen medya indirme | 500 MB |
| İstek zaman aşımı | 45 s (`504 GATEWAY_TIMEOUT`) |
| Webhook teslimi | Deneme başına 10 s, 5 deneme |

## Medya URL’sinden indirme

Medya, belge veya bağlantı önizlemesi getiren gönderim istekleri HTTP ve HTTPS URL’lerini kabul eder. Genel URL’lerden veri getirme işlemleri geri döngü, özel, bağlantı yerel, meta veri, çok noktaya yayın ve ayrılmış hedefleri reddeder. Yönlendirmeler ve gerçekten bağlantı kurulan adres denetlenir. Bu indirmeler doğrudan bağlanır ve `HTTP_PROXY` veya `HTTPS_PROXY` kullanmaz.

GOWA kendi `/statics` URL’lerini diskten okuyabilir. Chatwoot ek indirmeleri, bu entegrasyon üzerinden güvenildiğinde dahili bir ana makine de dahil olmak üzere yapılandırılan Chatwoot hedefini veya izin verilen ana makineleri kullanabilir. Bu istisna, gönderim API’sine iletilen herhangi bir URL için geçerli değildir. Kaynak özel olduğunda dosya yüklemelerini kullanın.

## Kullanılmayanlar

`src/.env.example`, `WHATSAPP_WEBHOOK_INCLUDE_OUTGOING` ve `WHATSAPP_CHAT_STORAGE` değişkenlerini listeler ancak mevcut kod bunların hiçbirini okumaz. Ayarlanmaları hiçbir etki yaratmaz.

## Örnek

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

Eşdeğer bayraklar:

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

- [Hızlı başlangıç](https://gowa-docs.mintlify.site/tr/quickstart.md)
- [Chatwoot Entegrasyonu](https://gowa-docs.mintlify.site/tr/integrations/chatwoot.md)
- [Bir cihazın Chatwoot yapılandırmasını sil](https://gowa-docs.mintlify.site/tr/api-reference/chatwoot/bir-cihazın-chatwoot-yapılandırmasını-sil.md)
- [Bir cihazın Chatwoot yapılandırmasını getir](https://gowa-docs.mintlify.site/tr/api-reference/chatwoot/bir-cihazın-chatwoot-yapılandırmasını-getir.md)
- [Cihaz webhook yapılandırmasını ayarla](https://gowa-docs.mintlify.site/tr/api-reference/device/cihaz-webhook-yapılandırmasını-ayarla.md)


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