> ## Documentation Index
> Fetch the complete documentation index at: https://aiagenttr.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mesaj Şablonları — Oluşturma, Yönetim ve Senkronizasyon

> WhatsApp mesaj şablonları yönetimi. 24 saat kuralı, şablon kategorileri, durumları, bileşenleri, parametre kullanımı ve platform üzerinden senkronizasyon.

## Genel Bakış

WhatsApp mesaj şablonları, 24 saatlik müşteri hizmeti penceresi dışında müşterilere mesaj göndermenizi sağlayan, Meta tarafından onaylanmış mesaj yapılarıdır. Şablonlar, pazarlama kampanyaları, bildirimler ve kimlik doğrulama mesajları için kullanılır.

## 24 Saat Kuralı

WhatsApp Business API, mesajlaşma için **24 saatlik müşteri hizmeti penceresi** uygular:

* **Pencere içinde**: Müşteri son 24 saat içinde mesaj gönderdiyse, serbest formatta metin mesajı gönderebilirsiniz
* **Pencere dışında**: Müşteriye sadece **onaylanmış şablon mesajlar** ile ulaşabilirsiniz

<Warning>
  24 saatlik pencere, müşterinin son mesajından itibaren başlar. Bu pencere kapandıktan sonra, müşteriye ulaşmanın tek yolu onaylanmış şablon mesajlardır. Serbest formatta mesaj göndermeye çalıştığınızda Meta API hatası alırsınız.
</Warning>

## Şablon Durumları

Her şablon Meta tarafından incelenir ve aşağıdaki durumlardan birinde olabilir:

| Durum                     | Açıklama                             | Kullanım                                        |
| ------------------------- | ------------------------------------ | ----------------------------------------------- |
| **Approved** (Onaylı)     | Meta tarafından onaylandı            | ✅ Mesaj göndermede kullanılabilir               |
| **Pending** (Beklemede)   | Meta incelemesi devam ediyor         | ❌ Henüz kullanılamaz                            |
| **Rejected** (Reddedildi) | Meta tarafından reddedildi           | ❌ Kullanılamaz, düzeltilip yeniden gönderilmeli |
| **Paused** (Duraklatıldı) | Kalite sorunu nedeniyle duraklatıldı | ❌ Geçici olarak kullanılamaz                    |

<Note>
  Şablonlar **Meta Business Manager** üzerinden oluşturulur ve platforma senkronize edilir. Platform üzerinden doğrudan şablon oluşturulamaz.
</Note>

## Şablon Kategorileri

Meta, şablonları üç ana kategoride sınıflandırır:

<CardGroup cols={3}>
  <Card title="Pazarlama" icon="bullhorn">
    Promosyonlar, kampanyalar ve pazarlama mesajları. En yüksek maliyet kategorisi
  </Card>

  <Card title="Faydalı" icon="bell">
    Sipariş onayları, kargo bildirimleri, randevu hatırlatmaları gibi işlemsel mesajlar
  </Card>

  <Card title="Kimlik Doğrulama" icon="shield-check">
    OTP kodları ve doğrulama mesajları. Özel buton formatları için kullanılır
  </Card>
</CardGroup>

## Şablon Bileşenleri

Her şablon aşağıdaki bileşenlerden oluşabilir:

### Başlık (Header)

Şablonun üst kısmında görünen içerik. Desteklenen formatlar:

* **Metin** (TEXT) — Düz metin başlık
* **Görsel** (IMAGE) — Görsel başlık
* **Video** (VIDEO) — Video başlık
* **Belge** (DOCUMENT) — Belge başlık

### Gövde (Body)

Şablonun ana metin kısmı. Parametreler kullanılarak dinamik içerik eklenebilir.

### Altbilgi (Footer)

Şablonun alt kısmında görünen küçük metin.

### Butonlar (Buttons)

Şablona eklenebilen etkileşim elemanları:

* **Hızlı Yanıt** (quick\_reply) — Tek tıkla yanıt butonları
* **URL** (url) — Web sayfasına yönlendirme butonları

## Parametre Kullanımı

Şablonlarda iki tür parametre formatı desteklenir:

### Konumsal Parametreler (Positional)

Numaralı yer tutucular kullanır:

```
Merhaba {{1}}, siparişinizin durumu: {{2}}. Tahmini teslim: {{3}}.
```

* `{{1}}` → Müşteri adı
* `{{2}}` → Sipariş durumu
* `{{3}}` → Teslim tarihi

### İsimli Parametreler (Named)

Meta'nın yeni formatı olan isimli yer tutucular kullanır:

```
Merhaba {{first_name}}, siparişinizin durumu: {{order_status}}.
```

<Info>
  Platform, her iki parametre formatını da otomatik olarak algılar. Şablon senkronizasyonu sırasında parametre şeması otomatik olarak oluşturulur.
</Info>

## Platform Üzerinden Şablon Yönetimi

### Şablon Listesi

WhatsApp hesabınıza bağlı tüm şablonları görüntülemek için:

1. **WhatsApp** > **Hesap Detayı** > **Mesaj Şablonları** sayfasına gidin
2. Tüm şablonlar ad, dil, kategori, durum ve bileşenler ile listelenir

<Frame>
  <img src="https://mintcdn.com/aiagenttr/EsPj4y2_ld-gNsL8/images/whatsapp-templates-list.png?fit=max&auto=format&n=EsPj4y2_ld-gNsL8&q=85&s=7c03631ce951227b881450663737f101" alt="WhatsApp mesaj şablonları listesi" width="1358" height="821" data-path="images/whatsapp-templates-list.png" />
</Frame>

### Şablon Detayı

Bir şablonun üzerine tıkladığınızda detay sayfasında:

* Şablon adı, dili ve kategorisi
* Onay durumu
* Bileşenler (JSON görüntüleme)
* Parametre şeması

### Manuel Senkronizasyon

Meta Business Manager üzerinde şablon değişiklikleri yaptığınızda, bunları platforma senkronize etmeniz gerekir:

<Steps>
  <Step title="Şablonlar Sayfasına Gidin">
    WhatsApp hesap detayında **Mesaj Şablonları** bölümüne gidin
  </Step>

  <Step title="Senkronize Et Butonuna Tıklayın">
    Sayfa başındaki **Şablonları Senkronize Et** butonuna tıklayın

    <Frame>
      <img src="https://mintcdn.com/aiagenttr/EsPj4y2_ld-gNsL8/images/whatsapp-template-sync.png?fit=max&auto=format&n=EsPj4y2_ld-gNsL8&q=85&s=2ba6b5e5f6759af777bdc2a95a6d0643" alt="WhatsApp şablon senkronizasyon butonu" width="1358" height="821" data-path="images/whatsapp-template-sync.png" />
    </Frame>
  </Step>

  <Step title="Senkronizasyonu Bekleyin">
    Platform, Meta API üzerinden tüm şablonları çeker ve listeyi günceller. Çok sayıda şablon varsa bu işlem birkaç saniye sürebilir
  </Step>
</Steps>

<Tip>
  Şablonlar ilk kez hesap bağlandığında otomatik olarak senkronize edilir. Sonraki güncellemeler için **Manuel Senkronizasyon** kullanın.
</Tip>

### Meta WhatsApp Manager'a Yönlendirme

Yeni şablon oluşturmak veya mevcut şablonları düzenlemek için Meta WhatsApp Manager'a yönlendirilirsiniz. Platformdaki **Meta'da Düzenle** butonu sizi doğrudan ilgili sayfaya götürür.

## Agent'da Şablon Seçimi

AI Agent'ınız WhatsApp üzerinden 24 saat penceresi dışında müşteri ile iletişim başlatmak istediğinde, onaylanmış bir şablon seçilmesi gerekir. Bu ayar, agent yapılandırmasında yapılır.

Detaylı bilgi için [Ajan WhatsApp Yapılandırması](/docs/whatsapp/agent-configuration) sayfasına bakın.

## İlgili Makaleler

<CardGroup cols={2}>
  <Card title="AI Mesajlaşma" icon="robot" href="/docs/whatsapp/ai-messaging">
    Mesajlaşma akışı ve 24 saat penceresi
  </Card>

  <Card title="Desteklenen Mesaj Türleri" icon="messages" href="/docs/whatsapp/supported-message-types">
    Tüm mesaj türleri ve özellikleri
  </Card>

  <Card title="Ajan Yapılandırması" icon="gear" href="/docs/whatsapp/agent-configuration">
    Agent'ta şablon seçimi ve WhatsApp ayarları
  </Card>

  <Card title="Sorun Giderme" icon="wrench" href="/docs/whatsapp/troubleshooting">
    Şablon senkronizasyon sorunları
  </Card>
</CardGroup>