> ## 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, butonlar

> WhatsApp şablon kategorileri, başlık biçimleri, buton 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, butonlar, değişkenler, gelişmiş şablon türleri ve gönderim yaşam döngüsü. Bir şablon oluşturma ve test etmenin adım adım anlatımı için bkz. [Şablonlar](/app/templates). Medya biçim limitleri için bkz. [Medya başlıkları](/app/media-in-template-headers).

## Kategoriler

Her şablonun, Meta'ya gönderirken belirlenen 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ı kademe; opt-in kurallarına tabidir                                   |
| **Hizmet**           | Sipariş güncellemeleri, hesap uyarıları, hatırlatmalar, kullanıcı başlatımlı bir akışın takipleri | Pazarlamadan daha ucuz; içerik belirli bir işlem veya talebe ilişkin olmalıdır |
| **Kimlik doğrulama** | Tek kullanımlık şifreler ve hesap doğrulama kodları                                               | Katı biçim; pazarlama içeriğine izin verilmez; en ucuz kademe                  |

Meta, şablonunuzun seçtiğiniz kategoriyle eşleşmediğini düşünürse, şablon **reddedilir** veya **yeniden kategorize edilir** — Hizmet olarak gönderilen Pazarlama içeriğinde 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 biçimleri

Bir şablonun başlığı isteğe bağlıdır. Mevcut olduğunda şunlardan biri olabilir:

* **TEXT** — kısa bir dize, bir değişken içerebilir.
* **IMAGE** — JPEG veya PNG, maks. 5 MB. Bkz. [Medya başlıkları](/app/media-in-template-headers).
* **VIDEO** — H.264/AAC ile MP4 veya 3GPP, maks. 16 MB.
* **DOCUMENT** — PDF (en güvenilir), Office biçimleri veya düz metin. Maks. 100 MB. Dosya adı alıcı tarafından görülebilir.
* **LOCATION** — enlem, boylam, ad ve adres. Mağaza ziyaretleri veya teslimat onayları için kullanışlıdır.

Medya başlıkları, **medya tutamacı** olarak (Meta'ya bir kez yüklenmiş) veya gönderim başına alınan bir **genel HTTPS URL'si** olarak eklenebilir. Avantajları ve dezavantajları için bkz. [Medya başlıkları](/app/media-in-template-headers).

## Gövde ve değişkenler

Gövde, ana mesaj metnidir. Değişkenler **1 tabanlı dizinli çift süslü parantezler** kullanır:

```text theme={null}
Merhaba {{1}}, {{2}} numaralı siparişiniz gönderildi. Buradan takip edin: {{3}}
```

Kurallar:

* Sayılar `{{1}}`'den başlayarak sıralı olmalıdır — dizinleri atlayamazsınız.
* Gönderirken 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ğerler olarak tutun. Uzun yapıştırılmış bloklar yaygın bir reddedilme nedenidir.

Aynı `{{n}}` sözdizimi **TEXT başlıklarında** ve **URL butonlarında** da 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:

* `*yıldız*` ile **kalın**
* `_alt çizgi_` ile **italik**
* `~tilde~` ile **üstü çizili**
* Üçlü ters tırnaklarla **tek aralıklı**

Biçimlendirmeyi dikkatli kullanın. Yoğun biçimlendirilmiş şablonlar genellikle spam görünümlü olarak reddedilir.

## Alt bilgi

Gövdeden sonra gösterilen isteğe bağlı düz metin. Değişken yok, biçimlendirme yok.

## Butonlar

Bir şablon, hızlı yanıt veya harekete geçirici mesaj olarak gruplanmış **toplam 10 butona 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:

| Buton türü       | İşlevi                                                     | Ö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**   | Bir kodu panoya kopyalar                                   | `SAVE20`                        | Kod için bir tane                    |
| **FLOW**         | Bir WhatsApp Akışı açar                                    | (bağlı Flow ID)                 | Akışın kendisi üzerinden değişkenler |
| **CATALOG**      | WhatsApp kataloğunuzu açar                                 | (bağlı katalog ID)              | Hayır                                |
| **MPM**          | Çok Ürünlü Mesaj başlatıcı                                 | (katalog ürünleri)              | Hayır                                |
| **VOICE\_CALL**  | Bir WhatsApp sesli aramayı başlatır (desteklenen yerlerde) | (işletme numaranız)             | Hayır                                |

Hızlı yanıt butonları, yapılandırılmış bir yanıt istediğinizde (analitik için iyi) kullanışlıdır. URL ve telefon butonları, alıcıları WhatsApp'tan yığınınıza yönlendirmek için kullanışlıdır. FLOW butonları, Flowella'nın uzmanlaştığı HubSpot-form-tabanlı Akışlara giden geçittir.

## Özel şablon türleri

Meta'nın temel yapıya ek işlevsellik ekleyen birkaç özel pazarlama şablon türü vardır.

### Carousel şablonları

Bir carousel şablonu, her biri kendi medyası, gövdesi ve butonları olan birden çok kartı yatay kaydırmada gösterir. Katalog vitrinleri, çok ürünlü teklifler veya özellik karşılaştırmaları için kullanışlıdır.

* Şablon başına **10 karta kadar**.
* Her kartın kendi görüntü veya video başlığı vardır (şablon başına bir medya türü — tümü görüntü veya tümü video, karışık değil).
* Her kart **2 butona kadar** sahip olabilir (Hızlı Yanıt, URL veya Telefon).
* Her kartın gövdesi 3 değişkene kadar içerebilir.

Onay şablon başınadır (kart başına değil), bu nedenle tüm kartlar seçilen kategoriye uymalıdır.

### Sınırlı süreli teklif (LTO) şablonları

LTO şablonları, gövdenin altında bir geri sayım sayacı oluşturur. Sayaç sona erdiğinde, teklif süresi dolmuş olarak gösterilir ve CTA'ya dokunmak bir şey yapmaz.

* Bir **anlaşma kodu** parametresi gereklidir ve kullanıcıya gösterilir.
* Bir **son kullanma epoch (saniye cinsinden)** gereklidir.
* CTA butonu genellikle bir Kodu Kopyala veya URL'dir.

Gerçek zaman sınırlı teklifler için en iyisidir — gerçekten sona ermeyen teklifler için LTO kullanmak kullanıcı şikayetlerine ve Pazarlama'dan uzakta yeniden kategorize edilmeye 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 yükseltildi).
* Kodu Kopyala butonu, **gönderim sırası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ı (toplu gönderimler için alıcı satırı başına bir tane) yazdığınız özel bir **Kupon kodu butonları** girdisi gösterir. Daha eski "Kodu kopyala" / "Kupon kodu butonlarını kopyala" etiketleri bu tek, tutarlı terimle değiştirilmiştir.

### Kimlik doğrulama şablonları

OTP teslimi için özel şablonlar. Üç alt tür:

* **Tek dokunuşla otomatik doldurma** — kullanıcı butona dokunduğunda OTP'yi otomatik olarak doldurmak için Android'in otomatik doldurma API'sini kullanır. Desteklenen yerlerde en iyi UX.
* **Kodu kopyala** — bir Kopyala butonu gösterir; kullanıcı kodu uygulamanıza yapıştırır. Her yerde çalışır.
* **Sıfır dokunuş** — güvenilir göndericiler için, OTP herhangi bir dokunma olmadan teslim edilebilir (WhatsApp istemcisinden uygulamanıza otomatik bir API geri çağrısı). Katı uygunluk.

Kimlik doğrulama şablonları en ucuz mesaj başına fiyata sahiptir ancak en katı içerik kurallarına sahiptir: pazarlama içeriği yok, kodun kendisi dışında ekstra gövde metni yok.

### Konum şablonları

Başlıkta bir konum noktası taşır; 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ığı**

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

* Editörde yazdığınız değerler (`_flowellaEditor.headerLocationPreview` altında) 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 girdileri olarak gösterir.
* HubSpot'un [WhatsApp Şablonu Gönder](/hubspot/workflow-actions#send-whatsapp-template) eylemi, bir iş akışının iğneyi alıcıya göre kişiselleştirebilmesi için dört değeri `headerLocation` üzerinden geçirir.

Gönderim sırasında dörtten herhangi birini atlarsanız, Flowella bu alan için editör önizleme değerine geri döner.

## Gönderim yaşam döngüsü

Flowella'dan bir şablon gönderdiğinizde, şu durumlardan geçer:

<Steps>
  <Step title="DRAFT">
    Flowella'ya kaydedildi ancak henüz Meta'ya gönderilmedi.
  </Step>

  <Step title="PENDING">
    Meta'ya gönderildi ve incelemede. Çoğu şablon, Meta'nın otomatik incelemesini dakikalar içinde geçer, ancak bazıları insan incelemesine yönlendirilir. Flowella'nın editörü size 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.
  </Step>

  <Step title="APPROVED">
    Yayında ve kullanılabilir. Gelen kutusundan, API'den ve HubSpot iş akışlarından gönderebilirsiniz.
  </Step>

  <Step title="REJECTED">
    Meta şablonu reddetti. Reddetme nedeni şablon sayfasında görünür. Düzenleyin ve yeniden gönderin.
  </Step>

  <Step title="FLAGGED">
    Meta kalite geri bildirimini incelemiş ve şablonu işaretlemiştir. Genellikle PAUSED'in habercisidir.
  </Step>

  <Step title="PAUSED">
    Meta, genellikle alıcı geri bildirimi veya düşük kalite nedeniyle şablonun gönderilmesini geçici olarak kısıtladı. Kalite düzelirse otomatik olarak geri gelir.
  </Step>

  <Step title="DISABLED">
    Meta şablonu kalıcı olarak kısıtladı. İçeriği tekrar kullanmak istiyorsanız yeni bir şablon olarak (genellikle yeniden kategorize edilmiş) yeniden gönderilmelidir.
  </Step>
</Steps>

## Kalite derecesi

Onaylandıktan sonra, her şablon kendi kalite derecesini oluşturur — [telefon numarası kalite derecesinden](/meta/quality-score) ayrı. Şablon düzeyindeki derece aynı Yeşil/Sarı/Kırmızı ölçeğini kullanır ve çoğunlukla şunlarla yönlendirilir:

* Alıcılar arasında engelleme oranı
* WhatsApp'taki "Bildir" eylemlerinin sıklığı
* Sürekli düşük etkileşim (yanıt yok, bağlantı tıklaması yok)

Sarı ve Kırmızı şablon dereceleri, telefon numarasının kendi derecesi Yeşil olsa bile Meta'nın şablonu duraklatmasına neden olabilir. Sayı düzeyindeki dereceyle birlikte şablon kalitesini **Flowella → Şablonlar** içinde izleyin.

## Yaşam süresi (TTL)

Şablonlar, Meta'nın vazgeçmeden önce ne kadar süre teslim deneyeceğini kontrol eden bir **yaşam süresine** sahip 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ın eskidikten sonra değeri kalmaz.
* **Özel TTL:** bazı şablon türleri için gönderim başına ayarlanabilir.

Bir şablon teslimden önce sona ererse (alıcı telefonu çevrimdışı, hesap duraklatılmış vb.), faturalama için bir gönderim olarak sayılır ancak müşteriye asla ulaşmaz.

## Yaygın reddedilme nedenleri

* **Hizmet olarak gönderilen promosyon içerik.** Pazarlama olarak yeniden gönderin.
* **Gövdeyle eşleşmeyen değişken örnekleri** — örneğin, gövdenin haklı çıkarmadığı bağlantılar içeren örnekler.
* **Spam görünümlü gövde veya başlık metni** — aşırı büyük harf, "Buraya tıklayın", "Bedava!!!", birden çok ünlem işareti.
* **Bozuk veya erişilemeyen medya başlık URL'leri.**
* **Gövdeyle çelişen alt bilgi metni.**
* **Herkes tarafından gönderilebilecek genel şablonlar** — `Merhaba {{1}}, sizin için özel teklif` özellikler olmadan pazarlama onayı için fazla geneldir.
* **Yanlış bağlamda değişkenler** — Meta'nın izin vermediği bir yerde bir değişken kullanmak (örn. bazı buton türleri).
* Şablon içeriğinin **markasıyla eşleşmeyen görünen ad**. WABA'nın görünen adı "Acme" ise ve şablon "Beta Co"yu tanıtıyorsa, reddedilir.

<Tip>
  Meta değişiklikleri incelerken çalışan bir sürümü korumak için orijinali değil, ONAYLANMIŞ bir şablonun bir kopyasını düzenleyin. Flowella'nın **Şablonlar → Çoğalt** özelliği bunu sizin için yapar.
</Tip>

## İlgili kılavuzlar

* [Şablonlar](/app/templates) — bir şablon oluşturmanın adım adım anlatımı
* [Medya başlıkları](/app/media-in-template-headers) — medya biçim referansı
* [Şablon reddedildi](/troubleshooting/template-rejected) — reddetmelerin tanılanması
* [Kalite puanı](/meta/quality-score) — telefon numarası kalitesinin şablon kalitesiyle nasıl etkileşime girdiği
* [Mesajlaşma limitleri](/meta/messaging-limits) — kaç şablon gönderebileceğinizi kısıtlayan kademe sistemi