> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # WhatsApp şablon başlıklarında medya: görüntüler ve videolar > WhatsApp'ın şablon başlıklarında kabul ettiği medya biçimleri ve boyutları, YouTube bağlantılarının neden gömülmediği ve medyanın Flowella aracılığıyla nasıl yüklenip referans alınacağı. Bir WhatsApp şablonu, başlığında tek bir medya parçası taşıyabilir: bir görüntü, bir video veya bir belge. İyi kullanıldığında, aksi takdirde yalnızca metin olan bir mesajın açılma ve etkileşim oranlarını ikiye katlar. Kötü kullanıldığında — yanlış biçim, bozuk URL, uyumsuz MIME türü — gönderimin başarısız olmasına veya şablonun amatörce görünmesine neden olur. Bu sayfa; neyin işe yaradığı, neyin yaramadığı ve medyanın Flowella üzerinden nasıl aktarılacağına yönelik pratik referanstır. ## Desteklenen biçimler ve limitler Bunlar, Meta'nın şablon başlıklarındaki (ve WhatsApp Business Platformu mesajlarındaki diğer yerlerdeki) medyada uyguladığı biçimler ve boyut limitleridir. ### Görüntüler | Biçim | Uzantı | MIME türü | Maks. boyut | | - | - | - | - | | JPEG | `.jpeg` / `.jpg` | `image/jpeg` | 5 MB | | PNG | `.png` | `image/png` | 5 MB | Görüntüler **8 bit, RGB veya RGBA** olmalıdır. WebP şablon başlıklarında **kabul edilmez** (yalnızca ayrı bir mesaj türü olan sticker mesajlarında geçerlidir). **Önerilen boyutlar:** 1.91:1 en boy oranı, minimum 800×418 piksel. Kare (1:1) görüntüler de kabul edilebilir şekilde işlenir. Diğer en boy oranları WhatsApp istemcisi tarafından letterbox yapılır. ### Videolar | Biçim | Uzantı | MIME türü | Maks. boyut | | - | - | - | - | | 3GPP | `.3gp` | `video/3gpp` | 16 MB | | MP4 | `.mp4` | `video/mp4` | 16 MB | Videolar **H.264 video codec'i** ve **AAC ses codec'i** kullanmalı ve **tek bir ses akışı veya ses olmamalıdır**. H.264 **"High" profili ve B-kareler** ile kodlanmış videolar, Android WhatsApp istemcileri tarafından desteklenmez. Daha geniş uyumluluk için H.264 **B-kareler olmadan "Main" profili** veya **"Baseline" profili** ile kodlayın (veya yeniden kodlayın) ve `moov` kutularını `mdat` kutularından önce yerleştirin. ffmpeg kullanıyorsanız, `-movflags faststart` bayrağı `moov`/`mdat` sıralamasını halleder. ### Belgeler | Biçim | Uzantı | MIME türü | Maks. boyut | | - | - | - | - | | PDF | `.pdf` | `application/pdf` | 100 MB | | Microsoft Word | `.doc` / `.docx` | `application/msword` / `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | 100 MB | | Microsoft Excel | `.xls` / `.xlsx` | `application/vnd.ms-excel` / `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | 100 MB | | Microsoft PowerPoint | `.ppt` / `.pptx` | `application/vnd.ms-powerpoint` / `application/vnd.openxmlformats-officedocument.presentationml.presentation` | 100 MB | | Düz metin | `.txt` | `text/plain` | 100 MB | PDF'ler cihazlar arasında en güvenilir şekilde işlenendir. Office belgeleri çalışır ancak alıcının uyumlu bir uygulama yüklemesini gerektirir; iş amaçlı olmayan bir mobilde genellikle önizleme olarak açılır. ## Neler işe yaramaz Bir şablon başlığına YouTube veya Vimeo videosu yerleştiremezsiniz. Başlığın, Meta'nın alıp barındırabileceği bir MP4 veya 3GPP dosyası olması gerekir. Bir YouTube videosu göndermek isterseniz iki seçenek: 1. **YouTube bağlantısını gövdeye veya bir URL düğmesine koyun.** Ona dokunmak YouTube uygulamasını veya tarayıcısını açar. WhatsApp'ta gösterilen video önizlemesi statik bir küçük resim olacaktır. 2. **Videoyu indirin ve MP4 olarak yeniden yükleyin.** İçeriği yeniden dağıtma haklarınıza tabidir ve bu genellikle kendi videonuz olması gerektiği anlamına gelir. İkincisi, konuşma içi gerçek bir video önizlemesi elde etmenin yoludur. Animasyonlu GIF'ler (`.gif`) desteklenen listede değildir. WhatsApp bunları tüketici uygulamasında eşten eşe paylaşıldığında sunucu tarafında dönüştürür, ancak Business Platformu dönüştürmez. GIF'i bir MP4 olarak yeniden kodlayın (WhatsApp'ın mobil istemcileri, bir GIF gösterdikleri gibi otomatik oynatmayla ve sessiz olarak oynatır). WebP görüntüler yalnızca sticker mesajları için geçerlidir, şablon başlıkları için değil. Başlık görüntüsü olarak kullanmadan önce JPEG veya PNG'ye dönüştürün. iPhone'lar fotoğrafları varsayılan olarak desteklenen listede olmayan HEIC biçiminde kaydeder. Ya JPEG'de yakalamak için iPhone ayarını değiştirin ya da yüklemeden önce HEIC'i JPEG'e dönüştürün. 6 MB bir görüntü, 18 MB bir video veya 110 MB bir PDF reddedilir. Yüklemeden önce sıkıştırın. Görüntüler için, WhatsApp istemcisi görüntülemede yeniden sıkıştırır, bu nedenle 4 MB'lık bir fotoğraf bir telefon ekranında 1 MB'lık olandan anlamlı derecede daha iyi görünmeyecektir. ## Bir şablona medya eklemenin iki yolu Meta, medyayı bir şablona almanın iki desenini destekler: ### Desen 1: Medya tanıtıcısı (önerilir) Dosyayı Meta'nın Media API'si aracılığıyla yükleyin, bir **medya tanıtıcısı** geri alın ve şablonu gönderdiğinizde tanıtıcıya başvurun. Flowella tarafından varsayılan olarak kullanılır. Faydaları: * Meta dosyayı barındırır, bu nedenle gönderim sırasında bozuk URL hataları yoktur. * Meta'nın harici bir URL'den almasına gerek olmadığı için daha hızlı teslimat. * Yukarıdaki tam boyut limitleri için çalışır. Tanıtıcı 30 gün geçerlidir. Şablonunuz aynı medyayla tekrar tekrar gönderiliyorsa, Flowella tanıtıcıyı sona ermeden önce otomatik olarak yeniler. BELGE başlıkları için, Flowella yakın zamanda yüklenmiş belge medyasını mümkün olduğunda yeniden kullanır, böylece aynı şablonun yeniden gönderimleri dosyayı yeniden yüklemeye gerek duymaz. Meta yeniden kullanılan bir kimliği reddederse, Flowella tekrar yüklemeye geri döner. ### Desen 2: Genel HTTPS URL'si Genel olarak erişilebilir bir dosyaya URL sağlayın. Meta bunu gönderim sırasında alır. Bu şu durumlarda faydalıdır: * Medya alıcı başına değişir (kişiselleştirilmiş bir PDF, sipariş başına bir sevkiyat etiketi). * Medya anında oluşturulur ve gönderim başına yüklemek istemezsiniz. Uyarılar: * URL **genel olarak erişilebilir** olmalıdır (kimlik doğrulama yok) ve **geçerli bir sertifika ile HTTPS** kullanmalıdır. * URL bir hata döndürürse veya yavaşsa, gönderim başarısız olur. * Meta, alınan dosyayı bir süre önbelleğe alır; URL'deki dosyayı güncellemek, gönderilenin mutlaka yenilenmesini sağlamaz. ## Flowella medya yüklemeyi nasıl ele alır Çoğu kullanım durumu için, Flowella medya tanıtıcısını sizin için yönetir: **Şablonlar → Oluştur**'da, başlık türü olarak **Görüntü**, **Video** veya **Belge** seçin, ardından **dosyayı kesikli yükleme alanına sürükleyin** veya göz atmak için tıklayın. Sürükle ve bırak, üç başlık türü için de çalışır ve tıklamayla aynı yükleme yolunu kullanır. **Belge** başlıkları için, düzenleyici ayrıca yüklenen dosyadan varsayılan olan bir **Belge dosya adı** alanı gösterir — alıcıların WhatsApp belge baloncuğunda gördüğü adı kontrol etmek için düzenleyin. Biçim, boyut ve MIME türü, gönderimden önce kontrol edilir. Desteklenmeyen bir dosyayı bırakır veya seçerseniz, bir toast Meta'nın şablonu reddetmesini beklemek yerine size hemen neyin yanlış olduğunu (yanlış tür veya boyut limitinin üzerinde) söyler. Dosya, Meta'nın Media API'si aracılığıyla yüklenir. Döndürülen tanıtıcı şablona karşı kaydedilir. Şablon onay için gönderildiğinde, Meta gerçek medyayı (bir URL değil) görür, böylece inceleme süreci onaylama sürecinin bir parçası olarak görselleri değerlendirebilir. Şablonun başlık medyası değişene kadar, her gönderim aynı tanıtıcıyı kullanır. Tanıtıcılar sona ermeden önce otomatik olarak yenilenir. BELGE başlıkları için, düzenleyicide ayarladığınız **Belge dosya adı** taslakla birlikte kalıcı hale getirilir, Meta'nın onay ve yayımından geçer ve her gönderimde kullanılır — HubSpot iş akışı gönderimleri, test gönderimleri, toplu gönderimler ve gelen kutusu gönderimleri hepsi şablonun dahili adı yerine dosya adınızı gösterir. **Şablonlar → Kopyala**'yı kullandığınızda, Flowella başlık dosyasını ve **Belge dosya adını** yeni taslağa kopyalar. Kopya başarısız olursa, düzenleyici bir uyarı gösterir ve siz dosyayı yeniden yükleyene kadar yayımlamayı engeller. Alıcı başına medya (kişiselleştirilmiş PDF'ler, sevkiyat etiketleri) için, şablon oluşturucusundaki **Genel URL** seçeneğini kullanın ve bir iş akışından veya API'den gönderimi tetiklerken URL'yi bir değişken olarak geçirin. Bkz. [İş akışı eylemleri](/tr/hubspot/workflow-actions). ## WhatsApp görünüm alanı için tasarım Meta'nın spesifikasyonunda görünmeyen ancak pratikte önemli olan birkaç tasarım notu: * **Görüntülerdeki metin.** Büyük ve yüksek kontrast tutun. WhatsApp görüntüyü kabaca mobil ekran genişliğinde gösterir, bu nedenle yaklaşık 14 pikselden küçük her şey okunamaz şekilde işlenir. * **Güvenli alan.** WhatsApp kırpabilir veya letterbox yapabilir; kritik içeriği görüntünün merkez %80'inde tutun. * **Marka tutarlılığı.** Başlık görüntüsü, WhatsApp görünen adı ve profil fotoğrafı hepsi yakın oturur — bunları görsel olarak tutarlı tutun. * **Bir videonun ilk karesi.** WhatsApp, video oynamadan önce ilk kareyi hareketsiz önizleme olarak kullanır. Siyah bir kare veya bir kurumsal logo splash ile açmayın; anlamlı bir görüntüde başlayın. * **Belge dosya adı.** Bir PDF veya başka bir belge gönderirken, **dosya adı** alıcıya WhatsApp belge baloncuğunda görünür. Şablon düzenleyicisi BELGE başlığı yüklemesinin altında bir **Belge dosya adı** alanını açığa çıkarır; yüklenen dosyanın adından varsayılandır ve şablon gönderildiğinde alıcıların gerçekten gördüğüdür. `attachment.pdf` veya Meta CDN nesne adı değil, `Acme-Siparis-12345-Fatura.pdf` gibi net, açıklayıcı bir ad kullanın. ## Yaygın hatalar ve düzeltmeler Dosyanın gerçek MIME türü, beyan edilenle eşleşmiyor. Genellikle iPhone tarafından dışa aktarılan bir "JPEG" aslında HEIC olduğunda veya bir araç bir `.docx`'i dönüştürmeden `.pdf` olarak yeniden adlandırdığında gerçekleşir. Düzeltme: dosyayı inceleyin (macOS/Linux'ta: `file -I yourfile.png`) ve doğru biçimde yeniden dışa aktarın veya uzantıyı eşleşecek şekilde değiştirin. Ses codec'i AAC dışında bir şey veya birden fazla ses akışı var. Düzeltme: `ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4` ile yeniden kodlayın. H.264 High profili ve B-kareler ile kodlanmış. Main veya Baseline profili ile yeniden kodlayın. Meta URL'ye ulaşamıyor. Yaygın nedenler: URL kimlik doğrulama gerektiriyor, sertifika geçersiz, sunucu yanıt vermek için yavaş (zaman aşımı) veya URL dosya yerine bir yönlendirme döndürüyor. Düzeltme: `curl -I` ile URL'yi test ederek doğru içerik türüyle 200 döndürdüğünü ve sertifikanın doğrulandığını onaylayın. Ardından yeniden deneyin. Kaynak düşük çözünürlüklü veya ölçeklendirilmiş. WhatsApp keskinlik için yeniden işlemez; yüklediğiniz gösterilendir. Düzeltme: 1.91:1 bir görüntü için uzun kenarda en az 800 piksel yükleyin ve küçük bir kaynağı ölçeklemeyin. ## İlgili kılavuzlar * [Şablon referansı](/tr/app/template-reference) — bu medyanın oturduğu tam şablon yapısı * [Şablonlar](/tr/app/templates) — Flowella'da adım adım şablon oluşturma * [İş akışı eylemleri](/tr/hubspot/workflow-actions) — alıcı başına medya URL'lerini HubSpot iş akışlarından geçirme This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.