İçeriğe atla

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

Bu sayfada

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.

Yer tutucu ne yapar

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

Hazır yer tutucular

Düzenleyicide listeden seçebileceğiniz yer tutucular şunlardır:

  • Kişi › Ad — {{contact.first_name}} — Kişinin adının ilk kelimesi. Ad yoksa kullanıcı adı yazılır.
  • Kişi › Ad soyad — {{contact.name}} — Kişinin tam adı. Ad yoksa kullanıcı adı yazılır.
  • Kişi › Kullanıcı adı — {{contact.username}}
  • Kişi › E-posta — {{contact.email}}
  • Kişi › Telefon — {{contact.phone}}
  • Kişinin son yanıtı — {{input}} — Kişinin en son yazdığı metin (tetikleyen mesaj ya da verdiği yanıt).
  • Hesap adı — {{workspace.name}} — Hesabın görünen adı.

Özel alanları yazmak

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.

Varsayılan değer vermek

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.

Nerede kullanılır

Yer tutucular şu yerlerde çalışır:

  • Mesaj adımlarının metinlerinde ve metin varyantlarında.
  • Kart ve galeri başlıklarında, alt başlıklarında; Medya adımının altyazısında.
  • Liste adımının başlık, gövde ve satır metinlerinde.
  • Bilgi topla adımının sorusunda ve yeniden sorma metninde.
  • Yoruma yanıt adımının metinlerinde.
  • Üstünde dene adımının soru, hazırlık ve sonuç altyazısı metinlerinde.
  • Eylem adımındaki Alana yaz değerinde.
  • Yapay zekâ adımının talimatında ve girdisinde.
  • E-posta gönder adımının konusunda ve gövdesinde.
  • Dönüşüm adımının adında ve tutarında.
  • Şablon adımının değişken değerlerinde.
  • Koşul kurallarının değerinde — yalnız Etiket, Alan ve Son yanıt kurallarında. Böylece iki bilgiyi birbiriyle karşılaştırırsınız.
  • Dış istek adımının yolunda, gövdesinde, başlık değerlerinde ve kol karşılaştırmalarında.
  • Dizi adımlarının metninde.
  • Hazır yanıtlarda — gelen kutusunda / ile çağırdığınız cevaplarda.

Dış istekte değerin kaçışlanması

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.

Yer tutucu ile alan arasındaki fark

İkisi aynı şey değildir, birlikte çalışırlar:

  • Alan, bilginin saklandığı yerdir (kişi kartında).
  • Yer tutucu, o bilginin yazıldığı yerdir (mesajın içinde).

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.

Somut bir örnek

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}}

  • Adı bilinen misafire "Merhaba Selin, …" gider.
  • Adı bilinmeyen misafire "Merhaba misafirimiz, …" gider.
  • Tarih ve kişi sayısı, akıştaki Bilgi topla adımlarının yazdığı alanlardan gelir.
  • Son satırdaki hesap adı, mesajın hangi işletmeden geldiğini belirtir.

Uzunluk ve yer tutucu

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.

Sık yapılan hatalar

  • Tek süslü parantez kullanmak. Yer tutucu çift süslü parantez ister; tek parantez düz metin olarak gider.
  • Alan adını yanlış yazmak. {{field.SiparisNo}} tanınmaz. Doğrusu {{field.siparis_no}} gibi küçük harfli ve alt çizgilidir.
  • Uydurma anahtar yazmak. Listede olmayan bir anahtar (örneğin {{contact.city}}) boş kalır. Şehir bilgisi bir alansa {{field.sehir}} yazılır.
  • Varsayılan değer vermemek. Boş kalan yer tutucu yarım cümle bırakır.
  • Uzunluk sayarken yer tutucuyu unutmak. Yer tutucu değerle değişince metin uzar; kanal sınırını aşan metin gönderim anında kısaltılır ve sonuna üç nokta konur.
  • Önizlemeyi gerçek sanmak. Düzenleyicide gördüğünüz metin örnektir; gerçek değerler gönderim anında yazılır. Denemek için otomasyonun Test sekmesini kullanın.

İlgili kavramlar

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?