> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Şablon değişkenleri ve dinamik içerik > WhatsApp şablon başlık, gövde, düğme ve URL'lerinde değişken kullanımı: söz dizimi, örnekler, HubSpot belirteçleri ve yaygın ret nedenleri. Değişkenler, onaylanmış tek bir şablonun Meta'ye yeniden gönderilmeden binlerce kişiye kişiselleştirilmiş mesajlar göndermesini sağlar. Bu sayfa, değişkenlerin Flowella'de nasıl çalıştığını, nerede görünebileceklerini ve HubSpot verilerine nasıl bağlanacağını derinlemesine incelemektedir. Şablon yapısına üst düzey bir genel bakış için [Şablon referansı](/tr/app/template-reference) bölümüne bakın. Adım adım şablon oluşturma için [Templates](/tr/app/templates) bölümüne bakın. ## Sözdizimi WhatsApp şablonları, çift küme parantezi ve 1 tabanlı dizin içeren **konumsal değişkenler** kullanır: ```text theme={null} Hi {{1}}, your booking on {{2}} is confirmed. Reference: {{3}}. ``` Kurallar: * 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: 1. Şablonun içeriğinin seçilen kategoriyle (Pazarlama, Yardımcı Program, Kimlik Doğrulama) eşleşip eşleşmediğine karar verin. 2. Kalite ve spam riskini tahmin edin. 3. Gözden geçirenlere bir önizleme görüntüleyin. Örnek değerler gönderme sırasında kullanılmaz - sadece inceleme içindir. Ama önemlidirler: * 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: 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 `{{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. 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"`. İş akışını önce tek bir test kişisine gönderin. Meta, herhangi bir değişkenin boş olduğu, yalnızca boşluk içerdiği veya satırsonu içerdiği gönderimleri reddeder. Boş değişkenler şablon onayında değil, gönderme sırasında başarısız olur. Binlerce kişiyle çalışan bir iş akışı, kritik bir özellik eksikse sessizce bırakılabilir. Her zaman yedekleri ayarlayın. ## Değişken biçimlendirme ipuçları **İsimler** ```text theme={null} Hi {{1}}, ``` HubSpot yukarı akışında özelliği büyük harfle yazın veya `firstname`'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: ```text theme={null} Base URL: https://acme.com/orders/ Variable: {{1}} At send time: https://acme.com/orders/AB-1234 ``` ## 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şinin `hs_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. Şablon gönderme, düzenleme ve duraklatmaya ilişkin tüm yaşam döngüsü için [Şablonlar](/tr/app/templates) ve [Şablon referansı](/tr/app/template-reference) bölümlerine bakın. Reddedilmeye özgü yardım için [Şablon reddedildi](/tr/troubleshooting/template-rejected) bölümüne bakın.