> ## 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 referansı: kategoriler, başlıklar, düğmeler
> WhatsApp şablon kategorileri, başlık formatları, düğme türleri, değişken sözdizimi, kupon ve konum şablonları ve gönderim yaşam döngüsü için referans.
Bu sayfa, bir WhatsApp şablonunun yapı taşları için bir referanstır — kategoriler, başlıklar, gövde, düğmeler, değişkenler, gelişmiş şablon türleri ve gönderim yaşam döngüsü. Bir şablon oluşturma ve test etme adım adım kılavuzu için [Şablonlar](/tr/app/templates)'a bakın. Medya format sınırları için [Medya başlıkları](/tr/app/media-in-template-headers)'na bakın.
## Kategoriler
Her şablonun, Meta'ya gönderdiğinizde ayarlanan tam olarak bir kategorisi vardır. Kategori, **fiyatlandırmayı** ve **hangi içeriğe izin verildiğini** yönlendirir.
| Kategori | Kullanım amacı | Notlar |
| - | - | - |
| **Pazarlama** | Promosyonlar, teklifler, etkinlik davetleri, yeniden etkileşim | En pahalı katman; kabul kurallarına tabidir |
| **Yardımcı** | Sipariş güncellemeleri, hesap uyarıları, hatırlatıcılar, kullanıcı tarafından başlatılan bir akışa yanıt | Pazarlamadan daha ucuz; içerik belirli bir işlem veya istekle ilişkili olmalıdır |
| **Kimlik doğrulama** | Tek seferlik şifreler ve hesap doğrulama kodları | Kesin format; pazarlama içeriğine izin verilmez; en ucuz katman |
Meta, şablonunuzun seçtiğiniz kategoriyle eşleşmediğini düşünürse, **reddedilir** veya **yeniden kategorize edilir** — Yardımcı olarak gönderilen Pazarlama içeriğiyle yaygındır. Kategori, Meta kullanım kalıplarını gözlemledikçe otomatik olarak da değişebilir ve bu da size uygulanan ücreti değiştirir.
## Başlık formatları
Şablonun başlığı isteğe bağlıdır. Mevcut olduğunda şunlardan biri olabilir:
* **METİN** — kısa dize, bir değişken içerebilir.
* **RESİM** — JPEG veya PNG, maksimum 5 MB. [Medya başlıkları](/tr/app/media-in-template-headers)'na bakın.
* **VİDEO** — H.264/AAC ile MP4 veya 3GPP, maksimum 16 MB.
* **BELGE** — PDF (en güvenilir), Office formatları veya düz metin. Maksimum 100 MB. Düzenleyicinin, yüklenen dosyadan varsayılan olarak alınan bir **Belge dosya adı** alanı vardır; burada belirlediğiniz değer, alıcının WhatsApp belge baloncuğunda gördüğüdür, bu yüzden `Acme-Order-12345-Receipt.pdf` gibi açıklayıcı bir şey seçin.
* **KONUM** — enlem, boylam, ad ve adres. Mağaza ziyaretleri veya teslimat onayları için kullanışlıdır.
Medya başlıkları, ya bir **medya tanıtıcısı** olarak (Meta'ya bir kez yüklenir) ya da gönderim başına alınan bir **genel HTTPS URL'si** olarak eklenebilir. Ödünleşimler için [Medya başlıkları](/tr/app/media-in-template-headers)'na bakın.
## Gövde ve değişkenler
Gövde, ana mesaj metnidir. Değişkenler, **1 tabanlı bir indeksle çift kaşlı ayraçlar** kullanır:
```text theme={null}
Merhaba {{1}}, siparişiniz {{2}} gönderildi. Buradan takip edin: {{3}}
```
Kurallar:
* Sayılar `{{1}}` ile başlayarak sıralı olmalıdır — indeksleri atlayamazsınız.
* Gönderdiğinizde her değişken için bir örnek değer sağlayın. Meta, şablonu değerlendirmek için örnekleri kullanır.
* Değişkenleri kısa, öngörülebilir değerlerde tutun. Uzun yapıştırılmış bloklar yaygın bir reddedilme nedenidir.
Aynı `{{n}}` sözdizimi **METİN başlıklarında** ve **URL düğmelerinde** de kullanılır (aşağıya bakın).
### Gövdede biçimlendirme
WhatsApp, şablon gövdelerinde sınırlı bir satır içi biçimlendirme kümesini destekler:
* **Kalın** için `*yıldız işaretleri*`
* **İtalik** için `_alt çizgiler_`
* **Üstü çizili** için `~tilde işaretleri~`
* **Tek aralıklı** için üçlü ters kesme işaretleri
Biçimlendirmeyi az kullanın. Ağır biçimlendirmeye sahip şablonlar genellikle spam gibi göründüğü için reddedilir.
## Alt bilgi
Gövdenin ardından gösterilen isteğe bağlı düz metin. Değişken yok, biçimlendirme yok.
## Düğmeler
Bir şablon, hızlı yanıtlar veya harekete geçirici mesajlar olarak gruplandırılmış olarak toplam **10 düğmeye** kadar içerebilir. Meta'nın izin verdiği kombinasyonlar Cloud API sürümleri arasında değişmiştir; en güvenilir kalıplar:
| Düğme türü | Ne yapar | Örnek | Değişken? |
| - | - | - | - |
| **QUICK\_REPLY** | İşletmenize önceden ayarlanmış bir metin yanıtı gönderir | `Evet, benim` | Hayır |
| **URL** | Bir web sayfası açar | `https://acme.com/orders/{{1}}` | URL'de bir tane |
| **PHONE** | Bir telefon numarasını arar | `+44 20 7946 0000` | Hayır |
| **COPY\_CODE** | Panoya bir kod kopyalar | `SAVE20` | Kod için bir tane |
| **FLOW** | Bir WhatsApp Akışı açar | (bağlı Akış ID'si) | Akışın kendisi aracılığıyla değişkenler |
| **CATALOG** | WhatsApp kataloğunuzu açar | (bağlı katalog ID'si) | Hayır |
| **MPM** | Çoklu Ürün Mesajı başlatıcısı | (katalog ürünleri) | Hayır |
| **VOICE\_CALL** | Bir WhatsApp sesli araması başlatır (desteklenen yerlerde) | (işletme numaranız) | Hayır |
Hızlı yanıt düğmeleri, yapılandırılmış bir yanıt istediğinizde kullanışlıdır (analiz için iyidir). URL ve telefon düğmeleri, alıcıları WhatsApp'tan yığınınıza yönlendirmek için kullanışlıdır. FLOW düğmeleri, Flowella'nın uzmanlaştığı HubSpot form odaklı Akışlara giriş kapısıdır.
## Özel şablon türleri
Meta'nın, temel yapının üzerine ek işlevsellik paketleyen çeşitli özel pazarlama şablonu türleri vardır.
### Karusel şablonları
Bir karusel şablonu (Meta buna medya kartı karuseli der), bir mesaj balonunun ardından yatay kaydırmada en fazla 10 kart gönderir. Her kartın kendi medyası, isteğe bağlı gövde metni ve düğmeleri vardır. Karuselleri katalog gösterimleri, çoklu ürün teklifleri veya özellik karşılaştırmaları için kullanın.
* **Yalnızca Pazarlama.** Karusel şablonları yalnızca **Pazarlama** kategorisini kullanabilir.
* Şablon başına **2 ila 10 kart**.
* **Mesajda başlık veya altbilgi yoktur.** Mesajın yalnızca bir gövdesi vardır. Bunun yerine her kart kendi medya başlığını taşır ve mesajın kendisinde düğme olamaz.
* **Şablon başına bir medya türü.** Her kart bir resim başlığı veya her kart bir video başlığı kullanır. Bunları karıştıramazsınız.
* **Kart gövdesi isteğe bağlıdır, en fazla 160 karakter.** Bir kartta gövde metni varsa her kartta gövde metni olmalıdır.
* **Kart başına en fazla 2 düğme** (Hızlı yanıt, URL veya Telefon numarası).
* **Her kartta aynı düğme yapısı.** Her kartta aynı sayıda, aynı türde ve aynı sırada düğme bulunur. Düğme etiketleri, URL'ler ve telefon numaraları karta göre farklılık gösterebilir.
Onay, şablon başınadır (kart başına değil), bu nedenle tüm kartlar Pazarlama kategorisine uygun olmalıdır. Tam belirtim için Meta'nın [medya kartı karusel şablonları](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/media-card-carousel-templates) belgelerine bakın. Flowella'da bir tane oluşturmak için bkz. [Karusel şablonu oluşturma](/tr/app/templates#build-a-carousel-template).
### Sınırlı süreli teklif (LTO) şablonları
LTO şablonları, gövdenin altında bir geri sayım sayacı görüntüler. Sayaç sona erdiğinde, teklif süresi dolmuş olarak gösterilir ve CTA'ya dokunmak hiçbir şey yapmaz.
* Bir **anlaşma kodu** parametresi gereklidir ve kullanıcıya gösterilir.
* Bir **son kullanma zamanı (saniye cinsinden epoch)** gereklidir.
* CTA düğmesi genellikle bir Kod Kopyala veya URL'dir.
Gerçek zamanla sınırlı teklifler için en iyisidir — gerçekte süresi dolmayan teklifler için LTO kullanmak kullanıcı şikayetlerine ve Pazarlamadan uzaklaşan kategori yeniden kategorizasyonuna neden olur.
### Kupon kodu şablonları
LTO gibi ancak geri sayım olmadan — sadece kullanıcının tek dokunuşla kopyalayabileceği bir kod.
* Kod **20 karaktere kadar** olabilir (yakın zamanda 15'ten artırıldı).
* Kod Kopyala düğmesi, **gönderim zamanında** sağlanan değeri kopyalar — şablonun `example` alanı yalnızca bir yer tutucudur ve asla gönderilmez.
* **Şablonlar → Gönder sekmesinde** ve **gelen kutusu şablon iletişim kutusunda**, kupon kodu şablonları, gerçekten göndermek istediğiniz kodları yazdığınız özel bir **Kupon kodu düğmeleri** girişi ortaya çıkarır (toplu gönderimler için alıcı satırı başına bir tane). Eski "Kod kopyala" / "Kupon kodu düğmelerini kopyala" etiketleri, bu tek, tutarlı terimle değiştirilmiştir.
### Kimlik doğrulama şablonları
OTP teslimatı için özel şablonlar. Üç alt tür:
* **Tek dokunuşla otomatik doldurma** — kullanıcı düğmeye dokunduğunda OTP'yi otomatik olarak doldurmak için Android'in otomatik doldurma API'sini kullanır. Desteklendiği yerde en iyi UX.
* **Kod kopyalama** — bir Kopyala düğmesi gösterir; kullanıcı kodu uygulamanıza yapıştırır. Her yerde çalışır.
* **Sıfır dokunuş** — güvenilir gönderenler için, OTP herhangi bir dokunuş olmadan teslim edilebilir (WhatsApp istemcisinden uygulamanıza otomatik bir API geri çağrısı). Sıkı uygunluk.
Kimlik doğrulama şablonlarının mesaj başına en ucuz fiyatı vardır, ancak en katı içerik kurallarına sahiptir: pazarlama içeriği yok, kodun kendisinin ötesinde ek gövde metni yok.
### Konum şablonları
Başlıkta bir konum işareti taşırlar, mağaza ziyaretleri, teslimat onayları veya etkinlik mekanları için kullanışlıdır. Kullanıcı, konumu tek dokunuşla harita uygulamasında açabilir.
**Değişken olarak konum başlığı**
KONUM başlığı dört alana kadar taşır — **enlem**, **boylam**, **ad** ve **adres** — ve Flowella dördünü de normal şablon değişkenleri olarak ele alır.
* Düzenleyicide yazdığınız değerler (`_flowellaEditor.headerLocationPreview` altında), hiçbir geçersiz kılma sağlanmazsa gönderilen **varsayılan** olur.
* **Şablonu Test Et** ve gelen kutusu gönderim iletişim kutuları, dört alanı normal değişken girişleri olarak sunar.
* HubSpot'un [WhatsApp Şablonu Gönder](/tr/hubspot/workflow-actions#send-whatsapp-template) eylemi, dört değeri `headerLocation` aracılığıyla geçirir, böylece bir iş akışı, işareti alıcı başına kişiselleştirebilir.
Gönderim sırasında dördünden herhangi birini atlarsanız, Flowella o alan için düzenleyici önizleme değerine geri döner.
## Gönderim yaşam döngüsü
Flowella'dan bir şablon gönderdiğinizde, şu durumlardan geçer:
Flowella'da kaydedildi ancak henüz Meta'ya gönderilmedi.
Meta'ya gönderildi ve inceleme altında. Çoğu şablon, Meta'nın otomatik incelemesini dakikalar içinde geçer, ancak bazıları insan incelemesine yönlendirilir. Flowella'nın düzenleyicisi, onayın **12 saate kadar sürebileceğini** söyler ve durum değiştiği anda size **e-posta gönderir** — sürekli yenilemenize gerek yoktur.
Yayında ve kullanılabilir. Gelen kutusundan, API'den ve HubSpot iş akışlarından gönderebilirsiniz.
Meta şablonu reddetti. Red nedeni şablon sayfasında görünür. Düzenleyin ve yeniden gönderin.
Meta kalite geri bildirimini inceledi ve şablonu işaretledi. Genellikle DURAKLATILDI'nın öncüsüdür.
Meta, genellikle alıcı geri bildirimi veya düşük kalite nedeniyle şablonu göndermeyi geçici olarak kısıtladı. Kalite iyileşirse otomatik olarak geri döner.
Meta şablonu kalıcı olarak kısıtladı. İçeriği tekrar kullanmak istiyorsanız yeni bir şablon olarak yeniden gönderilmelidir (genellikle yeniden kategorize edilir).
## Kalite puanı
Onaylandıktan sonra, her şablon kendi kalite puanını oluşturur — [telefon numarası kalite puanından](/tr/meta/quality-score) ayrı. Şablon düzeyindeki puan aynı Yeşil/Sarı/Kırmızı ölçeğini kullanır ve çoğunlukla şunlar tarafından yönlendirilir:
* Alıcılar arasında engelleme oranı
* WhatsApp'ta "Şikayet Et" eylemlerinin sıklığı
* Sürekli düşük etkileşim (yanıt yok, bağlantı tıklaması yok)
Sarı ve Kırmızı şablon puanları, telefon numarasının kendi puanı Yeşil olsa bile Meta'nın şablonu duraklatmasına neden olabilir. Numara düzeyindeki puanın yanında **Flowella → Şablonlar**'da şablon kalitesini izleyin.
## Yaşam süresi (TTL)
Şablonların, vazgeçmeden önce Meta'nın teslimat için ne kadar deneyeceğini kontrol eden bir **yaşam süresi** olabilir. Flaş satış davetleri gibi zamana duyarlı gönderimler için kullanışlıdır.
* **Varsayılan:** Çoğu şablon için 30 gün.
* **OTP / kimlik doğrulama şablonları:** çok daha kısa (varsayılan olarak birkaç dakika), çünkü kodlar bayat kaldıklarında değersizdir.
* **Özel TTL:** bazı şablon türleri için gönderim başına ayarlanabilir.
Teslimattan önce bir şablonun süresi dolarsa (alıcı telefonu çevrimdışı, hesap duraklatılmış vb.), faturalandırma için bir gönderim olarak sayılır ancak müşteriye asla ulaşmaz.
## Yaygın red nedenleri
* **Yardımcı olarak gönderilen tanıtım içeriği.** Pazarlama olarak yeniden gönderin.
* **Gövdeyle eşleşmeyen değişken örnekleri** — örneğin, gövdenin gerekçelendirmediği bağlantılar içeren örnekler.
* **Spam gibi görünen gövde veya başlık metni** — aşırı büyük harf kullanımı, "Buraya tıklayın", "Ücretsiz!!!", birden çok ünlem işareti.
* **Bozuk veya erişilemez medya başlık URL'leri.**
* **Gövdeyle çelişen alt bilgi metni.**
* **Herkes tarafından gönderilebilecek genel şablonlar** — `Merhaba {{1}}, size özel teklif` gibi ayrıntılar olmadan pazarlama onayı için çok geneldir.
* **Yanlış bağlamda değişkenler** — Meta'nın izin vermediği bir yerde değişken kullanmak (örneğin, bazı düğme türleri).
* **Görünen adın, şablon içeriğinin markasıyla eşleşmemesi.** WABA'nın görünen adı "Acme" ise ve şablon "Beta Co"yu tanıtıyorsa, reddedilecektir.
Meta değişiklikleri incelerken çalışan bir sürümü korumak için ONAYLANMIŞ bir şablonun bir kopyasını orijinal yerine düzenleyin. Flowella'nın **Şablonlar → Çoğalt** işlevi bunu sizin için yapar ve başlık medyasını (RESİM, VİDEO veya BELGE) ve **Belge dosya adını** yeni taslağa kopyalar, böylece yayınlamadan önce yeniden yüklemeniz gerekmez. Flowella medyayı kopyalayamazsa (örneğin, orijinal örnek URL erişilemez olduğunda), düzenleyici bir uyarı gösterir ve dosyayı yeniden yükleyene kadar yayınlamayı engeller.
## İlgili kılavuzlar
* [Şablonlar](/tr/app/templates) — bir şablon oluşturmanın adım adım anlatımı
* [Medya başlıkları](/tr/app/media-in-template-headers) — medya format referansı
* [Şablon reddedildi](/tr/troubleshooting/template-rejected) — reddetmeleri teşhis etme
* [Kalite puanı](/tr/meta/quality-score) — telefon numarası kalitesinin şablon kalitesiyle nasıl etkileşime girdiği
* [Mesajlaşma sınırları](/tr/meta/messaging-limits) — kaç şablon gönderebileceğinizi kısıtlayan katman sistemi
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.