> ## 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 kullanımı > WhatsApp şablon başlıklarında kabul edilen medya formatları ve boyutları, YouTube bağlantılarının neden gömülmediği ve Flowella ile yükleme. Bir WhatsApp şablonu, başlığında bir medya parçası taşıyabilir: bir resim, bir video veya bir belge. İyi kullanıldığında, yalnızca metin içeren bir mesajın açılma ve etkileşim oranlarını iki katına çıkarır. Kötü kullanıldığında - yanlış format, 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 Flowella aracılığıyla medyanın nasıl kullanılacağına ilişkin pratik bir referanstır. ## Desteklenen formatlar ve limitler Bunlar, Meta'nin şablon başlıklarında (ve WhatsApp Business Platform iletilerinin başka yerlerinde) medyaya uyguladığı biçimler ve boyut sınırlarıdır. ### Görüntüler | Biçim | Uzantı | MIME türü | Maksimum 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 etiket 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 mektup kutusuna alınır. ### Videolar | Biçim | Uzantı | MIME türü | Maksimum boyut | | ----- | ------ | ------------ | -------------- | | 3GPP | `.3gp` | `video/3gpp` | 16 MB | | MP4 | `.mp4` | `video/mp4` | 16 MB | Videolar **H.264 video codec** ve **AAC ses codec** kullanmalı, **tek ses akışı olmalı veya ses olmamalıdır**. H.264 **"Yüksek" profil ve B-çerçeveleri** ile kodlanan videolar Android WhatsApp istemcileri tarafından desteklenmez. H.264 **"B-çerçeveleri olmayan Ana" profil** veya **"Temel" profil** ile kodlayın (veya yeniden kodlayın) ve daha geniş uyumluluk için `moov` kutularını `mdat` kutularının önüne yerleştirin. Eğer ffmpeg kullanıyorsanız, `-movflags faststart` bayrağı `moov`/`mdat` sıralamasını yönetir. ### Belgeler | Biçim | Uzantı | MIME türü | Maksimum 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şlenenlerdir. Office belgeleri çalışır ancak alıcının uyumlu bir uygulama yüklemiş olması gerekir; iş amaçlı olmayan bir cep telefonunda genellikle önizleme olarak açılırlar. ## Ne işe yaramıyor Bir şablon başlığına YouTube veya Vimeo videosu yerleştiremezsiniz. Başlık, Meta'nin getirip barındırabileceği bir MP4 veya 3GPP dosyası olmalıdır. Bir YouTube videosu göndermek istiyorsanız, iki seçeneğiniz vardır: 1. \*\*YouTube bağlantısını gövdeye veya bir URL düğmesine yerleştirin \*\*Buna dokunulduğunda YouTube uygulaması veya tarayıcısı açılır. WhatsApp'de 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, bu da genellikle kendi videonuz olması gerektiği anlamına gelir. İkincisi, gerçek bir konuşma içi video önizlemesi elde etmenin yoludur. Animasyonlu GIF'ler (`.gif`) desteklenenler listesinde değildir. WhatsApp, tüketici uygulamasında eşler arası paylaşıldığında bunları sunucu tarafında dönüştürür, ancak İş Platformu dönüştürmez. GIF'i MP4 olarak yeniden kodlayın (WhatsApp'nin mobil istemcileri GIF'i gösterdikleri gibi otomatik oynatma ve ses olmadan oynatırlar). WebP görüntüleri yalnızca etiket mesajları için geçerlidir, şablon başlıkları için geçerli değildir. Başlık resmi olarak kullanmadan önce JPEG veya PNG'ye dönüştürün. iPhone'lar varsayılan olarak fotoğrafları desteklenenler listesinde olmayan HEIC formatında kaydeder. Ya iPhone ayarını JPEG olarak yakalayacak şekilde değiştirin ya da yüklemeden önce HEIC'i JPEG'e dönüştürün. 6 MB'lık bir resim, 18 MB'lık bir video veya 110 MB'lık bir PDF reddedilecektir. Yüklemeden önce sıkıştırın. Görüntüler için, WhatsApp istemcisi ekranda da yeniden sıkıştırma yapar, bu nedenle 4 MB'lık bir fotoğraf telefon ekranında 1 MB'lık bir fotoğraftan anlamlı bir şekilde daha iyi görünmeyecektir. ## Bir şablona medya eklemenin iki yolu Meta, medyayı bir şablona almak için iki modeli destekler: ### Desen 1: Medya tutacağı (önerilir) Dosyayı Meta'nin Medya API'si aracılığıyla yükleyin, bir **medya tanıtıcısı** geri alın ve şablonu gönderirken tanıtıcıya referans verin. Varsayılan olarak Flowella tarafından kullanılır. Avantajlar: * Meta dosyayı barındırır, böylece gönderme sırasında kırık URL hataları olmaz. * Meta harici bir URL'den almak zorunda olmadığı için daha hızlı teslimat. * Yukarıdaki tam boy limitler için çalışır. Tanıtıcı 30 gün boyunca geçerlidir. Şablonunuz aynı medya ile tekrar tekrar gönderiliyorsa, Flowella süresi dolmadan önce tanıtıcıyı otomatik olarak yeniler. ### Desen 2: Genel HTTPS URL'si Herkesin erişebileceği bir dosyaya URL sağlayın. Meta bunu gönderme zamanında alır. Bu şu durumlarda yararlıdır: * Medya alıcıya göre değişir (kişiselleştirilmiş bir PDF, sipariş başına bir kargo etiketi). * Medya anında oluşturulur ve gönderim başına yükleme yapmak istemezsiniz. Uyarılar: * URL **genel olarak erişilebilir** (auth yok) olmalı ve **HTTPS ile geçerli bir sertifika** kullanmalıdır. * URL bir hata döndürürse veya yavaşsa, gönderme başarısız olur. * Meta getirilen dosyayı bir süreliğine önbelleğe alır; URL'deki dosyanın güncellenmesi gönderilen dosyanın yenilenmesini gerektirmez. ## Flowella medya yüklemeyi nasıl işler? Çoğu kullanım durumunda, Flowella sizin için medya kolunu yönetir: Şablonlar → Oluştur\*\* bölümünde, başlık türü olarak **Görüntü**, **Video** veya **Belge** seçin, ardından dosyayı yükleme alanına sürükleyin. Biçim, boyut ve MIME türü gönderilmeden önce kontrol edilir. Dosya desteklenmiyorsa, Meta'nin şablonu reddetmesini beklemek yerine hemen bir hata görürsünüz. Dosya, Meta'nin Medya API'si aracılığıyla yüklenir. Döndürülen tanıtıcı şablona kaydedilir. Şablon onay için gönderildiğinde, Meta gerçek medyayı görür (URL değil), böylece inceleme süreci görselleri onayın bir parçası olarak değerlendirebilir. Şablonun başlık ortamı değişene kadar, her gönderim aynı tanıtıcıyı kullanır. Tutamaçlar süre dolmadan önce otomatik olarak yenilenir. Alıcı başına medya (kişiselleştirilmiş PDF'ler, kargo etiketleri) için şablon oluşturucuda **Public URL** seçeneğini kullanın ve bir iş akışından veya API'den gönderimi tetiklerken URL'yi değişken olarak iletin. Bakınız [İş Akışı Eylemleri](/tr/hubspot/workflow-actions). ## WhatsApp görüntü alanı için tasarım Meta'nin teknik özelliklerinde görünmeyen ancak pratikte önemli olan birkaç tasarım notu: * Resimlerdeki metinleri büyük ve yüksek kontrastlı tutun. WhatsApp görüntüyü kabaca mobil ekran genişliğinde gösterir, bu nedenle yaklaşık 14 px'den küçük herhangi bir şey okunamaz hale gelir. * Güvenli alan.\*\* WhatsApp kırpabilir veya letterbox yapabilir; kritik içeriği görüntünün %80'inin ortasında tutun. * Marka tutarlılığı.\*\* Başlık resmi ve WhatsApp görünen adı ve profil fotoğrafı birbirine yakın durur - görsel olarak tutarlı olmalarını sağlayın. * Bir videonun ilk karesi.\*\* WhatsApp, video oynatılmadan önce hareketsiz önizleme olarak ilk kareyi kullanır. Siyah bir çerçeve veya kurumsal bir logo sıçraması ile açmayın; anlamlı bir görüntü ile başlayın. * Belge dosya adı.\*\* Bir PDF veya başka bir belge gönderirken, **dosya adı** alıcı tarafından görülebilir. `attachment.pdf` değil, `Acme-Order-12345-Receipt.pdf` gibi net ve 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`'yi dönüştürmeden `.pdf` olarak yeniden adlandırdığında meydana gelir. Düzeltme: dosyayı inceleyin (macOS/Linux'ta: `file -I yourfile.png`) ve ya doğru formatta yeniden dışa aktarın ya da uzantıyı eşleşecek şekilde değiştirin. Ses codec'i AAC dışında bir şeydir veya birden fazla ses akışı vardır. 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 Yüksek profil ve B kareleri ile kodlanmıştır. Main veya Baseline profili ile yeniden kodlayın. Meta URL'ye ulaşamıyor. Yaygın nedenler: URL kimlik doğrulaması gerektirir, sertifika geçersizdir, sunucu yavaş yanıt verir (zaman aşımı) veya URL dosya yerine bir yönlendirme döndürür. Düzeltme: Doğru içerik türüyle 200 döndürdüğünü ve sertifikanın doğrulandığını onaylamak için URL'yi `curl -I` ile test edin. Sonra tekrar deneyin. Kaynak düşük çözünürlüklü veya yükseltilmiş. WhatsApp keskinlik için yeniden işlem yapmaz; yüklediğiniz şey gösterilir. Düzeltme: 1.91:1 görüntü için uzun kenarda en az 800 piksel yükleyin ve küçük bir kaynağı yükseltmeyin. ## İlgili kılavuzlar * [Şablon referansı](/tr/app/template-reference) - bu medyanın içine yerleştirildiği tam şablon yapısı * [Templates](/tr/app/templates) - Flowella'de 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