Sözdizimi
WhatsApp şablonları, çift küme parantezi ve 1 tabanlı dizin içeren konumsal değişkenler kullanır:- Dizinler
{{1}}’den başlar ve sıralı olmalıdır -{{1}}’den{{3}}’ye atlayamazsınız. - Aynı indeks tek bir bileşen (gövde, başlık veya URL) içinde tekrar kullanılabilir, ancak Flowella her oluşuma aynı değeri gönderecektir.
- Parantezlerin içinde boşluk bırakılmasına izin verilmez:
{{ 1 }}geçersizdir. - Değişkenler sadece metindir. Sayılar, tarihler ve para birimi dizeler olarak gönderilir - göndermeden önce bunları HubSpot’de yukarı doğru biçimlendirin.
Meta yeni şablonlar için adlandırılmış değişkenleri (
{{first_name}}) kullanıma sunuyor. Flowella her ikisini de destekler, ancak konumsal indeksler tüm şablon türlerinde ve Cloud API sürümlerinde en güvenilir format olmaya devam etmektedir.Değişkenlerin görünebileceği yerler
| Bileşen | İzin verilen değişkenler | Notlar |
|---|---|---|
| Başlık (METİN) | 1 | Yalnızca kısa değerler - satır sonu yok. |
| Header (medya) | 1 (medya tanıtıcısı veya URL) | Değişken medyanın kendisidir, metin değildir. |
| Başlık (KONUM) | 4 (enlem, boylam, ad, adres) | Başlık değişken olduğunda dördü de gereklidir. |
| Body | Pratikte en fazla ~10 | Her değişken Meta’nin gövde karakter sınırına sayılır. |
| Altbilgi | Yok | Altbilgi yalnızca statik metindir. |
| URL düğmesi | 1 | Statik bir temel URL’nin sonuna eklenir. |
| COPY_CODE düğmesi | 1 | Tam kod değeri. |
| Hızlı yanıt, Telefon, Akış, Katalog düğmeleri | Yok | Statik yapılandırma. |
| Karusel kartlar | Kart gövdesi başına en fazla 3 | Her kartın değişkenleri bağımsız olarak numaralandırılır. |
Örnek değerler
Meta’ye bir şablon gönderdiğinizde, her değişkenin bir örnek değere ihtiyacı vardır. Meta örnekleri şu amaçlarla kullanır:- Şablonun içeriğinin seçilen kategoriyle (Pazarlama, Yardımcı Program, Kimlik Doğrulama) eşleşip eşleşmediğine karar verin.
- Kalite ve spam riskini tahmin edin.
- Gözden geçirenlere bir önizleme görüntüleyin.
- Gerçekçi** değerler kullanın.
{{1}} = "John"iyidir;{{1}} = "xxx"genellikle reddedilmeyi tetikler. - Örnekleri kısa tutun. Bir paragrafı tek bir değişkene yapıştırmak klasik bir ret sinyalidir.
- Örneğin tipe uygun olduğundan emin olun.
{{2}}bir tarih ise, bir tarih kullanın. Sipariş numarasıysa, sipariş numarasına benzeyen bir şey kullanın.
Değişkenleri HubSpot verilerine bağlama
Flowella’nin WhatsApp Şablonu Gönder eylemini kullanan bir HubSpot iş akışında:Şablonu seçin
Flowella kanalınız için onaylanmış her şablonu gösterir. Değişkenler şablon gövdesinden, üstbilgiden ve düğmelerden otomatik olarak algılanır.
Her değişkeni bir HubSpot değeriyle eşleyin
Her
{{n}} için bir HubSpot kişi, şirket, anlaşma veya bilet özelliği seçin veya statik bir değer yazın. Kişiselleştirme belirteçlerini ve gerçek metni aynı eşlemede karıştırabilirsiniz.Boş değerler için bir geri dönüş ayarlayın
Bir kişinin eşlenen özellik için değeri yoksa, bir geri dönüş sağlamadığınız sürece mesaj başarısız olur. Yaygın geri dönüşler: Ad için
"there", hesap adı için "your account".Değişken biçimlendirme ipuçları
İsimlerfirstname’yi bir “Ad (biçimlendirilmiş)” özelliğine kopyalamak için bir HubSpot iş akışı adımı kullanın.
Tarihler
WhatsApp şablonları tarihleri biçimlendirmez. HubSpot özelliğiniz 2026-05-24T00:00:00Z ise iletiye bu tarih gelir. Tarihleri eşlemeden önce HubSpot olarak biçimlendirmek için bir 24 May 2026 hesaplanan özelliği veya iş akışı eylemi kullanın.
Para Birimi
Tarihlerle aynı - yukarı doğru biçimlendirin. Para birimi sembolünü statik metne (Total: £{{1}}) dahil edin, böylece değişken sadece sayı olur.
URL’ler gövde metninde
URL’nin tamamını bir gövde değişkeninin içine ekleyebilirsiniz, ancak bağlantı önizlemesi oluşturulmaz ve URL gövde karakter sınırına karşı sayılır. Bunun yerine değişken bir son eke sahip bir URL düğmesi kullanın:
Değişkenlerle ilgili yaygın ret nedenleri
- Atlanan dizinler** (
{{1}}sonra{{3}}). Her zaman yeniden numaralandırın. - Çevreleyen metin olmadan gövdenin en başında veya sonunda **değişken (yalnızca
{{1}}). Önce veya sonra bir sözcük ekleyin. - İki değişken bitişik (
{{1}}{{2}}). Bunları en az bir boşluk veya noktalama işaretiyle ayırın. - Yer tutucu gibi görünen örnek değerler -
"test","xxx","123"- özellikle Pazarlama şablonlarında. - Altbilgideki değişkenler - izin verilmez.
- URL düğmesinde birden fazla değişken** - yalnızca bir tanesine izin verilir ve URL’nin sonunda olmalıdır.
Gelişmiş desenler
Bileşenler arasında bir değeri yeniden kullanma
Bir müşteri adı hem başlıkta hem de gövdede görünüyorsa, iş akışınızda bir kez tanımlayın ve hem{{1}} (başlık) hem de {{1}} (gövde) aynı HubSpot özelliğine eşleyin. Flowella her bileşene kendi parametre listesini gönderir, bu nedenle indeksler bağımsızdır - değeri iki kez eşlersiniz, ancak HubSpot’de yalnızca bir kez depolarsınız.
Koşullu içerik
WhatsApp şablonları, şablon içindeki if/else mantığını desteklemez. Farklı kişi segmentlerine farklı içerikler göndermek için HubSpot iş akışınızda ayrı şablonlar ve şubeler oluşturun - örneğin, “VIP karşılama” ve “Standart karşılama”.Çok dilli şablonlar
Bir şablonun adı ve yapısı diller arasında paylaşılır, ancak her dil ayrı olarak gönderilir, onaylanır ve saklanır. Değişkenler her dil sürümünde aynı konumda olmalıdır. Flowella, kişininhs_language özelliğine (veya yapılandırdığınız bir yedek dile) göre doğru dili seçer.
Sorun Giderme
- Şablon onaylandı ancak mesajlar “parametre uyuşmazlığı” nedeniyle başarısız oluyor - Meta ve Flowella şablonun kaç değişkene sahip olduğu konusunda anlaşamıyor. Şablonu Flowella’de yeniden alın (Şablonlar → yenile), böylece değişken sayısı senkronize olur.
- Değişken, iletilen mesajda değişmez
{{1}}gösteriyor - iş akışı bu dizine bir değer eşlemedi. İş akışı eyleminin parametre listesini kontrol edin. - Mesaj gönderilirken “ilke ihlali” nedeniyle reddedildi - değişken, şablonun kategorisiyle eşleşmeyen bir URL veya içerik içeriyor. Pazarlama tarzı içerik, değişkenler aracılığıyla bir Yardımcı Program şablonuna enjekte edilemez.