Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iletiniz.com/llms.txt

Use this file to discover all available pages before exploring further.

Şablon, mesaj gövdesini parametrelendirip merkezi olarak yönetmenizi sağlar. Aynı template anahtarıyla yapılan gönderimler:
  • Şablon raporlamasına dahil olur (her şablonun delivery rate’i, hacmi, son kullanım tarihi).
  • İçerik düzenlemeleri kod deploy’u gerektirmez — dashboard’dan şablon body’sini değiştirip canlıya alabilirsiniz.
  • Her sağlayıcı için operatör onayı süreçleri (içerik denetimi) merkezi olarak takip edilir.

​
Şablon Modeli

Bir şablon iki temel alan içerir:
AlanAçıklama
keyŞablonun stabil kimliği. ^[a-z0-9_]{1,64}$ regex’ine uyar. API çağrılarında bu kullanılır.
bodyMesaj gövdesi. {{degisken}} syntax’ı ile interpolation noktaları tanımlar.

​
Değişken Syntax’ı

Şablon body’sinde {{ad}} veya {{musteri_kodu}} gibi yer tutucular kullanılır. Türkçe karakterli değişken adları ({{müşteri_kodu}}) kabul edilmez — değişken adı [A-Za-z0-9_] ile sınırlıdır. Değerlerde Türkçe karakter serbesttir.

​
Örnek Şablon

AlanDeğer
keysiparis_kargoda
bodyMerhaba {{isim}}, siparişiniz kargoda. Takip: {{kargo_takip}}
API çağrısında bu şablonu kullanmak için: 
{
  "to": "+905551234567",
  "template": "siparis_kargoda",
  "variables": {
    "isim": "Mehmet",
    "kargo_takip": "TR1234567890"
  },
  "sender": "FIRMA"
}
Sağlayıcıya gönderilen son metin: 
Merhaba Mehmet, siparişiniz kargoda. Takip: TR1234567890

​
Şablon Yönetimi

CRUD operasyonları API üzerinden değil, dashboard üzerinden yapılır: Kontrol Paneli → workspace seç → Şablonlar
  • Yeni şablon oluştur
  • Düzenle (yalnızca yeni gönderimleri etkiler; geçmiş mesajlar değişmez)
  • Sil (geçmiş mesaj kayıtları korunur; yalnızca key ile sonraki çağrılar 404 döner)

​
Doğrulama Kuralları

API tarafı:
  • Şablon yok: 404 Not Found, error: template_not_found.
  • Eksik değişken: Şablon body’sinde geçen bir değişken variables’ta yoksa 400 Bad Request, error: missing_template_variables, ve missing: ["..."] listesi.
  • Boş değer: variables içinde bir değişken boş string ise eksik sayılır.
  • Fazla değişken: Şablon body’sinde geçmeyen bir değişken variables’ta varsa sessizce yok sayılır.

​
Hangi Uç Noktaları Kullanmalıyım?

​
Şablon Bazlı Raporlama

Her şablon gönderimi template_key ile damgalanır, böylece dashboard’da kırılımlı metrikler görüntülenir:
  • Şablon başına delivery rate
  • Son 7/30 günlük gönderim hacmi
  • Son kullanım zamanı
  • Operatör tarafı reject oranları
Bu metrikler, hangi şablonların operatör tarafında sorun yaşadığını veya İYS yönünden engellendiğini hızlıca tespit etmenize yardımcı olur.