Değişken ve yer tutucu
Yer tutucu, mesajın içine kişiye özel bilgi yazmanın yoludur. Gönderim anında kişinin adıyla, telefonuyla ya da bir alanın değeriyle değişir.
Son güncelleme: 30 Eylül 2026
Yükleniyor…
Yer tutucu, mesajın içine kişiye özel bilgi yazmanın yoludur. Gönderim anında kişinin adıyla, telefonuyla ya da bir alanın değeriyle değişir.
Son güncelleme: 30 Eylül 2026
Yer tutucu, mesajın içine yazdığınız ve gönderim anında gerçek değerle değişen kısa bir işarettir. "Merhaba {{contact.first_name}}, siparişiniz hazır." yazdığınızda Ayşe Yılmaz'a giden mesajda "Merhaba Ayşe, siparişiniz hazır." görünür. Tek bir metinle herkese kişisel yazmanın yolu budur.
💡 Yer tutucular çift süslü parantez içine yazılır. Düzenleyicide elle yazmanız gerekmez: metin kutusunun altındaki yer tutucu listesinden seçtiğinizde imlecin olduğu yere eklenir.
Şablon bir kod çalıştırmaz; yalnız tanınan anahtarları değerle değiştirir. Tanınmayan bir anahtar yazarsanız o yer boş kalır — mesaj gitmeye devam eder, yalnız o kelime eksik görünür.
Değer yazıldıktan sonra metin küçük bir düzeltmeden geçer: art arda gelen fazla boşluklar teke iner ve noktalama işaretinden önceki boşluk silinir. Böylece değeri boş kalan bir yer tutucu "Merhaba !" gibi bir cümle bırakmaz.
Düzenleyicide listeden seçebileceğiniz yer tutucular şunlardır:
{{contact.first_name}} — Kişinin adının ilk kelimesi. Ad yoksa kullanıcı adı yazılır.{{contact.name}} — Kişinin tam adı. Ad yoksa kullanıcı adı yazılır.{{contact.username}}{{contact.email}}{{contact.phone}}{{input}} — Kişinin en son yazdığı metin (tetikleyen mesaj ya da verdiği yanıt).{{workspace.name}} — Hesabın görünen adı.Kişi kartındaki özel alanlar field. önekiyle yazılır:
{{field.sehir}}{{field.siparis_no}}{{field.randevu_tarihi}}Alan adını birebir yazmanız gerekir: küçük harf, rakam ve alt çizgi. Yanlış yazılan alan adı tanınmaz ve yeri boş kalır. Alan kavramı Kişi alanı (özel alan) makalesinde anlatılıyor.
Bir bilgi her kişide dolu olmayabilir. Yer tutucuya dikey çizgiyle bir yedek değer verebilirsiniz:
Merhaba {{contact.first_name|dostum}}!
Kişinin adı biliniyorsa "Merhaba Ayşe!", bilinmiyorsa "Merhaba dostum!" gider. Aynısı alanlar için de çalışır: {{field.sehir|şehrinizde}}.
⚠️ Not: Varsayılan değer yazmadığınızda boş kalan yer tutucu cümlenizi bozabilir. Kişi adı, şehir, sipariş numarası gibi her zaman dolu olmayan bilgilerde yedek değer yazmak alışkanlık hâline getirilmelidir.
Yer tutucular şu yerlerde çalışır:
/ ile çağırdığınız cevaplarda.Dış istek adımında yer tutucu, konulduğu yere göre kaçışlanır: adresin yoluna ve sorgu dizesine konan değer adres kurallarına göre, JSON gövdeye konan değer JSON kurallarına göre yazılır.
Bunun sebebi basittir: müşterinin yazdığı bir tırnak işareti JSON gövdeyi, bir "&" işareti sorgu dizesini bozabilirdi. Ayrıca dış istekte metin düzeltmesi (fazla boşluk temizliği) yapılmaz; adres ve gövde karakteri karakterine korunur.
İkisi aynı şey değildir, birlikte çalışırlar:
Bir alanı doldurmadan yer tutucusunu yazarsanız mesajda boşluk kalır. Bu yüzden akışı kurarken sıra önemlidir: önce bilgiyi toplayan ya da yazan adım, sonra onu kullanan mesaj.
Bir restoran rezervasyon onayı gönderiyor:
Merhaba {{contact.first_name|misafirimiz}}, {{field.rezervasyon_tarihi}} tarihli {{field.kisi_sayisi}} kişilik rezervasyonunuz onaylandı. Sorunuz olursa bu mesajı yanıtlayın. — {{workspace.name}}
Yer tutucu değerle değiştiğinde metin uzar; bu yüzden uzunluk hesabını yer tutucusuz yapmayın. Kanal sınırları farklıdır: Instagram metni bayt sayar (1.000 bayt; Türkçe harfler 2, emojiler 4 bayt tutar), WhatsApp karakter sayar (4.096 karakter; düğme varsa 1.024).
Düzenleyicideki sayaç bu farkı sizin yerinize hesaplar ve hesabınızda birden çok kanal türü varsa en dar sınırı gösterir. Buna rağmen sınır aşılırsa mesaj gitmeden önce harfi ya da emojiyi bölmeden kısaltılır ve sonuna üç nokta konur; mesaj hiç gitmemektense kısalmış olarak gider.
{{field.SiparisNo}} tanınmaz. Doğrusu {{field.siparis_no}} gibi küçük harfli ve alt çizgilidir.{{contact.city}}) boş kalır. Şehir bilgisi bir alansa {{field.sehir}} yazılır.Yer tutucuyu doğru kullandığınızda tek bir mesaj metni, binlerce kişiye kişisel yazılmış gibi ulaşır.
Bu makale yardımcı oldu mu?