Ana içeriğe atla
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.
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

Sunucu

Kontrol paneli

MCP

MCP sunucusuna bakın.

Depolama

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ışı

Webhook’lar

Webhook’lara bakın.

Chatwoot

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 bakın.

Sabit sınırlar

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

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

.env
Eşdeğer bayraklar: