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

# Medya İşleme

> Medya yükleyip gönderin, boyut sınırlarını ve dönüştürmeleri öğrenin, gelen mesajlardaki medyayı indirin.

## Sınırlar

| Tür | Varsayılan üst sınır |
| - | - |
| Görüntü | 20 MB |
| Belge (`/send/file`) | 50 MB |
| Video | 100 MB |
| İndirilen medya (gelen) | 500 MB |

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:

```bash theme={null}
# upload
curl -u admin:changeme -X POST http://localhost:3000/send/image \
  -H "X-Device-Id: my-device" \
  -F phone=628123456789 -F image=@photo.jpg

# URL
curl -u admin:changeme -X POST http://localhost:3000/send/image \
  -H "X-Device-Id: my-device" \
  -F phone=628123456789 -F image_url=https://example.com/photo.jpg
```

İ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).

| Seçenek | Uç nokta | Etkisi |
| - | - | - |
| `compress` | image (varsayılan `true`), video (varsayılan `false`) | Göndermeden önce yeniden kodlar. |
| `hd` | image, video | Büyütmeden HD olarak gönderir: görüntülerde uzun kenar en fazla 2560 px; videoda en fazla 1280×1280 H.264. `compress` ayarını geçersiz kılar. |
| `view_once` | image, video | Alıcı yalnızca bir kez açabilir. |
| `gif_playback` | video | Döngüde oynatılan GIF olarak oynatır. |
| `ptt` | audio | Sesli mesaj olarak gönderir (bas konuş). FFmpeg ile dönüştürülür. |
| (otomatik) | sticker | JPG, PNG, WebP veya GIF, 512×512 WebP çıkartmaya dönüştürülür. Animasyonlu WebP, WhatsApp'ın çıkartma sınırlarına uymalıdır. |

`/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](https://gowa-docs.mintlify.site/tr/examples/interactive-messages.md) 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:

```json theme={null}
{
  "image": "statics/media/1752404751-ad9e37ac-c658-4fe5-8d25-ba4a3f4d58fd.jpeg"
}
```

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

```bash theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/message/3EB0C127D7BACC83D6A3/download?phone=628987654321@s.whatsapp.net"
```

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ı](https://gowa-docs.mintlify.site/tr/integrations/chatwoot.md#ge%C3%A7mi%C5%9Fi-i%C3%A7e-aktarma) 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.

| Yol | İçerik |
| - | - |
| `statics/media/` | Sohbet/tarih alt dizinleri dahil, indirilen webhook medyası ve açıkça istenen indirmeler. |
| `storages/<timestamp>-<uuid>[.<extension>]` | Otomatik indirmeler etkinken gelen görüntü işleyicisinin kaydettiği ek kopyalar. |
| `storages/scheduled/` | Zamanlanmış gönderimler için tutulan ekler. Bunları zamanlayıcının yönetmesine izin verin. |
| `storages/history-*.json` | Medya indirmelerinden bağımsız geçmiş dökümleri. |

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.

```bash theme={null}
find ./statics/media -type f -mtime +30 -print
find ./storages -maxdepth 1 -type f -mtime +30 \
  -name '[0-9]*-????????-????-????-????-????????????*' -print
```

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](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/media-storage.md) 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

| Sorun | Çözüm |
| - | - |
| `413` veya gövde sınırı hatası | Dosya 100 MB'ı aşıyor; bunun yerine bağlantı gönderin. |
| Sesli mesaj başarısız oluyor veya dosya olarak oynatılıyor | FFmpeg'i kurun; `ptt=true` ayarını yapın. |
| Çıkartma dönüştürme başarısız oluyor | libwebp araçlarını kurun (`cwebp`, `dwebp`, `webpmux`). |
| URL medyası başarısız oluyor | URL herkese açık olmalı, dosyayı doğrudan döndürmeli (HTML sayfası olmamalı) ve boyut sınırına uymalıdır. |


## Related topics

- [Mesaj Gönderme](https://gowa-docs.mintlify.site/tr/examples/sending-messages.md)
- [Hata İşleme](https://gowa-docs.mintlify.site/tr/advanced/error-handling.md)
- [Mesaj alma](https://gowa-docs.mintlify.site/tr/examples/receiving-messages.md)
- [Mesajdan medya indir](https://gowa-docs.mintlify.site/tr/api-reference/message/mesajdan-medya-indir.md)
- [Bir bülten mesajındaki medyayı indir](https://gowa-docs.mintlify.site/tr/api-reference/newsletter/bir-bülten-mesajındaki-medyayı-indir.md)


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