Şablonlar

Bildirimlerin konu ve gövde metinlerini dil karşılıklarıyla yönetin, yeni şablon oluşturun ve gönderimden önce önizleyin.

Şablonlar ekranı, müşterilere giden e-posta, SMS, çağrı ve push bildirimlerinin konu ve gövde metinlerini yönettiğiniz yerdir. Sipariş onayı, kargo bilgisi ya da doğrulama kodu gibi her bildirimin içeriği bir şablondan gelir; bir şablonu hangi olayda kime göndereceğinizi ise Olaylar ve süreçler ekranındaki süreçler belirler. Şablonlar varsayılan (Türkçe) metnin yanında başka diller için karşılıklar da taşıyabilir. Burada yaptığınız değişiklikler gerçek müşteri bildirimlerini etkiler.

Ekrana ulaşma

Menüden Bildirim & Log › Şablonlar yolunu izleyin. Olaylar ve süreçler ekranının Süreçler görünümündeki Şablonlar düğmesi ile bir süreç kaydındaki şablon bağlantısı da sizi buraya getirir. Menüde görmüyorsanız hesabınızın bu ekrana yetkisi yoktur.

Ekranın bölümleri

Başlık: Şablonlar ve altında "E-posta ve SMS gövdeleri; dil karşılıklarıyla birlikte." açıklaması.
Filtre kartı: Ad ve Görüntüleme dili alanları; Temizle, Detaylı filtrele ve Filtrele düğmeleri.
Liste kartı: Her sayfada seçimi, kayıt sayacı (Filtreleme sonucu), Yeni şablon düğmesi, yenile simgesi, Sütunlar menüsü, tablo ve sayfalama.

Filtreleme ve arama

Filtreler Filtrele düğmesine (ya da bir alandayken Enter'a) bastığınızda uygulanır. Temizle tüm filtreleri boşaltıp listeyi hemen yeniler.

Alan	Ne işe yarar	İpucu
Ad	Şablonu adıyla bulur. Her zaman görünür.	Alan tam adı arar; adın bir parçasını yazarsanız sonuç gelmez.
Görüntüleme dili	Listedeki konu metninin hangi dilde gösterileceğini seçer. Her zaman görünür.	Bu bir satır filtresi değildir; şablon sayısı değişmez. Seçilen dilde karşılığı olmayan şablonun varsayılan metni gösterilir. Boş bırakırsanız Varsayılan (Türkçe) kullanılır.
Mesaj tipi	Yalnızca seçilen mesaj tipindeki şablonları listeler.	Detaylı filtrele menüsünden eklenir.
OTP şablonu	Evet: yalnızca doğrulama kodu şablonları; Hayır: diğerleri.	Detaylı filtrele menüsünden eklenir. Adı "OTP" ile başlayan şablonlar OTP şablonu sayılır.

Liste

Kolon	Anlamı
Ad	Şablonun adı (bağlantı; tıklayınca şablon sayfası açılır) ve altında açıklaması. Bu kolon gizlenemez.
Konu	Şablonun konu metni; seçili görüntüleme dilinde.
Mesaj tipi	SMS, E-posta, Çağrı ya da Push.
Dil	Listenin hangi dilde gösterildiği: dil kodu ya da Varsayılan. Varsayılan olarak gizlidir.
OTP şablonu	Şablon bir doğrulama kodu şablonuysa Evet (sarı), değilse Hayır.

Sayfa boyutu 25, 50 ya da 100 olabilir. Bir satıra tıkladığınızda ya da satır sonundaki üç nokta menüsünden Detaya git'i seçtiğinizde şablonun sayfası açılır.

İşlemler

Yeni şablon oluşturma

Yeni bir bildirim türü için içerik hazırlamanız gerektiğinde kullanılır.

Liste kartındaki Yeni şablon düğmesine basın.
Açılan formu doldurun (alanlar aşağıdaki tabloda).
Kaydet'e basın. Eksik ya da hatalı alan varsa altında hata mesajı görünür ve kayıt yapılmaz: Ad boşsa ya da 200 karakteri aşıyorsa ve Mesaj tipi seçilmemişse Zorunlu alan, varsayılan gövde boşsa "Varsayılan gövde boş olamaz." yazar.
Onay penceresinde "Şablon GERÇEK müşteri bildirimlerinde kullanılır; değişiklik bir sonraki gönderimden itibaren geçerlidir." uyarısını ve şablon adıyla birlikte sorulan oluşturma sorusunu okuyun, Kaydet ile onaylayın. Vazgeç forma geri döner.

Kayıt başarılı olursa Kaydedildi bildirimi çıkar, form kapanır ve liste yenilenir. Kayıt reddedilirse hata bildirimi çıkar ve form açık kalır; düzeltip tekrar deneyebilirsiniz.

Alan	Zorunlu	Açıklama / kural
Ad	Evet	En fazla 200 karakter. Doğrulama kodu şablonlarının adı "OTP" ile başlar.
Mesaj tipi	Evet	SMS, E-posta, Çağrı ya da Push.
Render tipi	—	Yalnızca Scriban seçeneği vardır. Şablon değişkenleri bu kurala göre işlenir.
Üst şablon	Hayır	Gövdenin içine yerleştirileceği çerçeve şablon (ör. ortak üst bilgi ve alt bilgi taşıyan e-posta çerçevesi). Boş bırakılırsa Üst şablon yok.
Açıklama	Hayır	En fazla 1000 karakter. Listede adın altında görünür. Sınır aşılırsa alanın altında uyarı çıkmaz; onaydan sonra kayıt reddedilir ve hata bildirimi çıkar.
Konu · Varsayılan	Hayır	Varsayılan (Türkçe) konu metni. Tek satırlık alandır.
Gövde · Varsayılan	Evet	Varsayılan (Türkçe) gövde; çok satırlı alandır. Boşsa "Varsayılan gövde boş olamaz." hatası çıkar.

Yeni şablon formunda önizleme düğmesi yoktur; şablonu kaydettikten sonra şablon sayfasından önizleyebilirsiniz.

Dil karşılığı ekleme ve çıkarma

Konu ve Gövde bölümlerinin her birinde varsayılan metnin altında dil karşılıkları bulunur.

İlgili bölümde Dil karşılığı ekle'ye basın. Henüz kullanılmayan ilk dil otomatik seçilir.
Dil listesinden istediğiniz dili seçin ve metni yazın.
Bir karşılığı kaldırmak için yanındaki çöp kutusu simgesine (Dil karşılığını çıkar) basın.

Dil listesinde her dil adıyla ve kodu ile birlikte görünür (ör. İngilizce (en)). Seçilebilen diller: İngilizce, Fransızca, Almanca, Felemenkçe, İspanyolca, İtalyanca, Portekizce, Rusça, Sırpça, Arapça, Çince, Japonca, Korece, Hintçe ve Farsça. Türkçe varsayılan metindir, karşılık olarak eklenmez. Aynı dil bir bölümde iki kez seçilemez; seçilirse "Aynı dil birden fazla kez eklenemez." hatası görünür. Bütün diller eklendiğinde Dil karşılığı ekle pasif olur.

Bir dilde karşılık yoksa ya da karşılık boşsa, o dildeki alıcıya varsayılan metin gider.

Şablonu düzenleme

Şablonun sayfasını açın ve Şablonu düzenle'ye basın.
Form, kayıtlı değerlerle dolu açılır; alanlar yeni şablon formuyla aynıdır.
Değişikliklerinizi yapın. İsterseniz formun altındaki Önizleme ile kaydetmeden önce sonucu görün.
Kaydet'e basın. Onay penceresinde canlı kullanım uyarısını ve "Şablon güncellensin mi? Formda olmayan dil karşılıkları silinir." sorusunu okuyup Kaydet ile onaylayın.

Başarılı kayıttan sonra Kaydedildi bildirimi çıkar, form kapanır ve sayfa güncellenir. Kayıt reddedilirse Bir şeyler ters gitti bildirimi çıkar ve form açık kalır. Değişiklik bir sonraki gönderimden itibaren geçerli olur; daha önce gönderilmiş bildirimler değişmez. Kayıt geri alınamaz; eski metne dönmek için şablonu yeniden düzenlemeniz gerekir.

Dikkat edilecekler:

Formdan çıkardığınız dil karşılıkları kayıtta silinir.
Mesaj tipi ve varsayılan gövde düzenlemede de zorunludur.
Şablonun kayıtlı bir üst şablonu varsa üst şablon kaldırılamaz, yalnızca başka bir şablonla değiştirilebilir. Alanın altındaki ipucu bunu hatırlatır.
Şablon kendi üst şablonu olarak seçilemez.

Yeni şablon ve Şablonu düzenle düğmelerini görmüyorsanız hesabınızın şablon değiştirme yetkisi yoktur; şablonları yine de görüntüleyebilir ve önizleyebilirsiniz.

Önizleme

Şablonun alıcıya nasıl görüneceğini kontrol etmek için kullanılır. Önizleme hiçbir bildirim göndermez ve gerçek müşteri verisi kullanmaz.

Şablon sayfasında sağ üstteki Önizleme düğmesine basın. Belirli bir dili doğrudan açmak için Gövde sekmesindeki satırın Önizleme düğmesini kullanabilirsiniz.
Dil listesinden Varsayılan ya da şablonda karşılığı olan bir dili seçin.
Görünüm listesinden birini seçin:
- İşlenmiş (örnek modelle): Şablon değişkenleri örnek verilerle doldurulur, gövde üst şablonun içine yerleştirilir. Varsayılan görünümdür.
- Ham (değişkenler işlenmeden): Gövde üst şablona yerleştirilir ama değişkenler olduğu gibi gösterilir. Bu görünümde "Ham görünüm: gövde üst şablona yerleştirildi, şablon değişkenleri İŞLENMEDEN gösteriliyor." notu çıkar; sağdaki model paneli görünmez.
İşlenmiş görünümde sağdaki Model (JSON) alanında şablonun okuduğu alanlar için üretilmiş örnek değerleri görürsünüz. Değerleri değiştirip Modelle işle'ye basarak sonucu yeniden üretin; Örnek modele dön ile başlangıç değerlerine dönün. Sonuç örnek modelle üretildiyse altta "Örnek modelle işlendi." notu görünür.

Pencerenin üst kısmında gövdenin hangi üst şablona yerleştirildiği ya da "Üst şablon yok; gövde tek başına gösteriliyor." notu yazar. Seçilen dilde karşılığı olmayan metinler için varsayılan metin kullanılır; üst şablon da aynı dildeki karşılığıyla, yoksa varsayılanıyla gösterilir. E-posta şablonlarının gövdesi sayfa olarak, SMS, çağrı ve push şablonlarınınki düz metin olarak gösterilir.

İşlenmiş görünümde sağ panelde şunlar çıkabilir:

Bölüm	Anlamı	Ne yapmalı
İşleme hataları (bu parçalar gönderimde BOŞ gider)	Konu, gövde ya da üst şablonun bir parçası işlenemedi.	Hatalı parçayı şablonda düzeltin; düzeltilmezse bu parça gerçek gönderimde boş gider.
Modelde karşılığı olmayan alanlar	Şablonun kullandığı ama modelde bulunmayan alanlar.	Alan adında yazım hatası olup olmadığını kontrol edin ya da modele değer ekleyip yeniden işleyin.

Model alanına geçerli bir JSON nesnesi yazılmazsa "Model geçerli bir JSON nesnesi olmalı." hatası görünür. Önizleme servisine ulaşılamazsa "Şablon işleme servisi şu an kullanılamıyor; ham görünüm gösteriliyor." uyarısıyla ham görünüme geçilir. İşleme başka bir nedenle başarısız olursa "Önizleme işlenemedi." uyarısı ve Tekrar dene düğmesi çıkar.

Düzenleme formundaki Önizleme kaydedilmemiş metninizi gösterir; pencerede "Kaydedilmemiş değişiklikler önizleniyor; üst şablon kayıtlı olandır." notu yer alır.

Şablon sayfası

Şablon sayfasının başlığında şablon adı, altında açıklama ve mesaj tipi görünür. OTP şablonlarında sağ üstte OTP şablonu rozeti bulunur. Sağ üstte Önizleme ve (yetkiniz varsa) Şablonu düzenle düğmeleri vardır. Şablonlara dön tarayıcıdaki bir önceki sayfaya döner; listeden geldiyseniz listeye dönersiniz.

Sekmeler:

Sekme	İçerik
Özet	Ad, Açıklama, Mesaj tipi, Render tipi, Üst şablon (tıklanınca üst şablonun sayfası açılır), Oluşturulma ve Kimlik.
Konu	Dil ve Metin kolonlu tablo; ilk satır Varsayılan metindir. Sekme adındaki sayı dil karşılığı sayısıdır.
Gövde	Konu sekmesiyle aynı yapıda; her satırın İşlemler kolonunda o dilin Önizleme düğmesi bulunur. Uzun metinler tabloda kısaltılır; tamamını önizlemede ya da düzenleme formunda görürsünüz.

Sık karşılaşılan durumlar

Adını bildiğim şablon listede çıkmıyor. Ad filtresi tam eşleşme arar. Adın tamamını doğru yazın ya da filtreyi boşaltıp listede gezinin.
Görüntüleme dilini değiştirdim ama bazı konular hâlâ Türkçe. O şablonun seçilen dilde karşılığı yoktur; varsayılan metin gösterilir. Karşılık eklemek için şablonu düzenleyin.
Kaydettikten sonra bir dil karşılığı kayboldu. Güncellemede formda bulunmayan dil karşılıkları silinir. Karşılığı yeniden ekleyip kaydedin.
Üst şablonu kaldıramıyorum. Kayıtlı üst şablon kaldırılamaz; yalnızca başka bir şablonla değiştirilebilir.
Önizlemede alanlar boş ya da hata var. Sağ paneldeki İşleme hataları (bu parçalar gönderimde BOŞ gider) ve Modelde karşılığı olmayan alanlar listelerini inceleyin; örnek modeldeki değerleri değiştirip Modelle işle ile tekrar deneyin.
"Kayıt bulunamadı" çıkıyor. Şablon silinmiş ya da çalışma alanınıza ait değil. Listeye dönüp şablonu yeniden arayın.
Onayladıktan sonra "Bir şeyler ters gitti" çıkıyor. Bildirimdeki nedeni okuyun. Formda uyarı görünmese de Açıklama 1000 karakteri aşıyorsa kayıt reddedilir; açıklamayı kısaltıp yeniden deneyin. Form açık kaldığı için yazdıklarınız kaybolmaz.