Ana içeriğe atla

Sınırlar

HTTP istek gövdesi sınırı, video sınırına (100 MB) eşittir; bu nedenle hiçbir yükleme bu sınırı aşamaz. Güncel değerleri GET /app/info (max_image_size, max_file_size, max_video_size) ile sorgulayın. Bu sınırlar derleme sırasında belirlenen varsayılan değerlerdir; bunlar için ortam değişkeni yoktur.

Medya sağlamanın iki yolu

Her medya uç noktası, multipart dosya veya GOWA’nın sunucu tarafında aldığı bir URL kabul eder:
İkisinden birini gönderin, ikisini birden göndermeyin. Uzak medya URL’leri HTTP veya HTTPS kullanmalı ve genel adreslere çözümlenmelidir. GOWA; geri döngü, özel, bağlantı yerel ve diğer ayrılmış hedefleri, yönlendirme hedefleri dahil engeller. Dahili bir URL kullanmak yerine yerel dosyaları multipart verisi olarak yükleyin.

İşleme

GOWA’nın ana makinede FFmpeg ve libwebp’ye ihtiyacı vardır (ikisi de Docker imajında bulunur). /send/file, belgeleri dönüştürmeden gönderir. Görüntü işleme, kod çözmeden önce başlıktaki boyutları kontrol eder. Kabul edilen en uzun kenar 32,768 pikseldir. JPEG olmayan görüntüler için 40 milyon piksel sınırı vardır. JPEG’lerde 80 milyon piksel üst sınırının yanı sıra kod çözme için 320 MiB bellek sınırı vardır; bu nedenle bazı büyük aşamalı veya CMYK JPEG’ler piksel üst sınırının altında olsa bile reddedilir. Kod çözme sınırı aşıldığında özgün görüntü gönderimlerinde küçük resimler atlanabilir. Etkileşimli karusel görüntülerinin Etkileşimli mesajlar bölümünde belirtilen ayrı ve daha düşük sınırları vardır.

Gelen medya

WHATSAPP_AUTO_DOWNLOAD_MEDIA=true olduğunda (varsayılan), GOWA gelen mesajlardaki medyayı statics/media/ dizinine indirir ve göreli yolu webhook yüküne ekler:
http://<host>:3000/statics/media/<file> adresinden alın. Durum güncellemelerindeki medyayı atlamak için WHATSAPP_IGNORE_STATUS_MEDIA=true ayarını yapın. Otomatik indirme kapalıyken yük, bunun yerine bir WhatsApp CDN URL’si taşır. Dosyanın şifresini çözen GOWA üzerinden indirin:
WhatsApp, medyayı sunucularında sınırlı bir süre tutar. İhtiyacınız olanları gecikmeden indirin. v9.9.0 sonrasındaki GOWA main dalında, açıkça istenen indirme ve iletme işlemleri telefondan süresi dolmuş medyayı yeniden yüklemesini isteyebilir. Telefon çevrimiçi olmalı ve dosya hâlâ telefonda bulunmalıdır. GOWA yanıt için en fazla 30 saniye bekler. Bu, MCP download_media ve forward eylemleri ile Chatwoot geçmiş içe aktarımları için de geçerlidir.

Depolama ve temizleme

Yollar işlem dizinine görelidir; bu dizin kaynak koddan çalıştırmada genellikle src/, Docker’da ise /app olur. Compose, deponun storages/ ve statics/ dizinlerini /app içine bağlar. Yaşa dayalı medya saklama ayarı veya temizleme uç noktası yoktur. Bir görüntünün hem storages/ hem de statics/media/ içinde kopyaları bulunabilir. Medya alanını geri kazanmak için storages/ dizininin tamamını asla kaldırmayın. GOWA’yı ve dosya yazan diğer süreçleri duraklatın, gerekli dosyaları yedekleyin, ardından kaldırılacak dosyaları önizleyin. Bu GNU find örnekleri dağıtım dizininden çalıştırılır ve en az 31 tam günlük dosyaları seçer.
Her yolu inceledikten sonra aynı komutlarda -print yerine -delete yazın. Veritabanı dosyalarını, SQLite -wal ve -shm yardımcı dosyalarını, zamanlanmış ekleri ve özel dosyaları koruyun. Ardından GOWA’yı yeniden başlatın. Silinen yollar ve statik URL’ler çalışmaz hale gelir; medyanın kaldırılması sohbet geçmişini temizlemez. WHATSAPP_AUTO_DOWNLOAD_MEDIA=false, sonraki otomatik indirmeleri ve ek görüntü kopyalarını durdurur. Eski dosyaları kaldırmaz veya açıkça istenen REST ya da MCP indirmelerini engellemez. Tam medya depolama ve temizleme kılavuzuna bakın. /statics herkese açık kalır. Saklanan HTML, SVG, betikler ve diğer belgeler, application/octet-stream ve nosniff ile ek olarak sunulur. Görüntü önizleme yollarındaki desteklenen görüntü baytları satır içinde görüntülenebilir. Bu içerik korumaları, dosyayı kimlerin indirebileceğini kısıtlamaz. Hassas medyayı ters proxy’de koruyun.

Sorun giderme