--- title: "WhatsApp Şablon Değişkenleri: {{1}} ve Adlandırılmış Parametreler" description: "WhatsApp şablon değişkenleri: konumsal {{1}} ve adlandırılmış parametreler, kullanılabildikleri yerler, örnek değerler, Meta'nın ret kuralları, gönderim yükü." canonical: "https://omnichannels.ai/tr/blog/whatsapp-template-variables-parameters/" language: "tr" updated: "2026-11-08" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "whatsapp template variables" keywords: ["whatsapp şablon değişkenleri", "whatsapp şablon parametreleri", "whatsapp şablon {{1}}", "whatsapp adlandırılmış parametreler", "parameter_format whatsapp", "whatsapp şablon örnek değerler", "whatsapp şablon değişken nedeniyle reddedildi", "csv ile kişiselleştirilmiş whatsapp şablonu"] published: "2026-11-08" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 9 answer: "WhatsApp şablon değişkeni, konumsal şablonlarda {{1}}, adlandırılmış şablonlarda {{first_name}} olarak yazılan ve her gönderimde doldurduğunuz bir yer tutucudur. Biçimi şablonu oluştururken parameter_format ile seçersiniz; varsayılan konumsaldır. Her değişken için inceleme amacıyla bir örnek değer gerekir. Değişkenler gövdede, metin başlığında (bir tane) ve URL düğmesinin son ekinde (bir tane) kullanılabilir; Meta, değişkenle başlayan veya biten şablonları reddeder." takeaways: ["Konumsal değişkenler {{1}}, {{2}} diye numaralanır ve sırayla doldurulmalıdır; adlandırılmış değişkenler küçük harf ve alt çizgiyle yazılan adlar kullanır ve herhangi bir sırada doldurulabilir.", "Şablon oluşturulurken her değişken için bir örnek değer verilmelidir; Meta incelemede bu örnekleri kullanır.", "Metin başlığı bir değişkeni, gövde birden çok değişkeni, URL düğmesi ise URL'nin sonuna eklenen bir değişkeni destekler.", "Meta'nın belgelediği ret nedenleri arasında hatalı yazılmış veya sıralı olmayan değişkenler, değişkenle başlayan ya da biten şablon, metin uzunluğuna göre çok fazla değişken ve #, $ ya da % gibi özel karakterler vardır.", "CSV'den kişiselleştirme, alıcı başına bir satır ve her değişken için temiz bir değer demektir."] faq: - q: "Konumsal ve adlandırılmış parametreler arasındaki fark nedir?" a: "Konumsal şablonlar {{1}} gibi numaralı yer tutucular kullanır ve gönderim değerlerinin aynı sırada verilmesini gerektirir. Adlandırılmış şablonlar {{order_number}} gibi küçük harf ve alt çizgiyle yazılan adlar kullanır; değerler gönderim yükünde herhangi bir sırada yer alabilir. Şablonu oluştururken parameter_format belirtmezseniz Meta konumsalı kullanır." - q: "WhatsApp şablonunda değişkenleri nerede kullanabilirim?" a: "Meta'nın belgeleri şunları sayar: birden çok parametre kabul eden gövde, bir parametreyi destekleyen metin başlığı ve URL'nin sonuna eklenen bir değişkeni destekleyen URL düğmesi. Medya başlıkları değişken yerine bir dosya taşır. Alt bilgi, hızlı yanıt düğmeleri ve telefon numarası düğmeleri değişken destekleyenler arasında sayılmaz." - q: "Şablonum değişkenler yüzünden neden reddedildi?" a: "Meta'nın inceleme rehberi değişkenlerle ilgili birkaç neden sayar: eksik ya da eşleşmeyen süslü parantezler, sıralı olmayan değişkenler, değişkenle başlayan veya biten bir mesaj, mesaj uzunluğuna göre çok fazla değişken ve #, $ ya da % gibi özel karakterler. Metni düzeltin, gerçekçi örnekler ekleyin ve yeniden gönderin." - q: "Örnek değerlere ihtiyacım var mı?" a: "Evet. Meta, bir şablon değişken kullanıyorsa oluştururken her parametre için bir tane olmak üzere örnek değerler eklemeniz gerektiğini söyler. İncelemecilerin nihai mesajın nasıl görüneceğini görebilmesi için test gibi yer tutucular yerine gerçekçi değerler kullanın. Örnekler yalnızca inceleme içindir; gerçek değerler gönderim anında verilir." - q: "Bir değişken satır sonu veya bağlantı içerebilir mi?" a: "Bu rehber yalnızca Meta'nın belgelerinde doğruladığımız şeyleri kapsar ve baktığımız sayfalar değişken değerleri içindeki satır sonları için bir kural belirtmez. Kendi numaranıza gerçek bir gönderimle test edin; uzun ya da biçimlendirilmiş değerler geçirmeyi planlıyorsanız ekibimize danışın. URL düğmesi değeri, düğme URL'sinin sonuna eklenir." - q: "Şablonu bir elektronik tablodan nasıl kişiselleştiririm?" a: "Alıcı başına bir satır ve değişken başına bir sütun tutun, değerler temiz olsun: fazladan boşluk içermeyen adlar, tek biçimde tarihler, uluslararası biçimde numaralar. Kişiselleştirilmiş bir kampanya gönderirken dosyayı yükleyin ve önizlemeyi kontrol edin. İlk kampanyanızdan önce tam sütun düzenini ekibimizle doğrulayın." sources: - title: "Template fundamentals — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview" - title: "Template components — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components" - title: "Template review — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review" --- # WhatsApp Şablon Değişkenleri: {{1}} ve Adlandırılmış Parametreler Canonical: https://omnichannels.ai/tr/blog/whatsapp-template-variables-parameters/ Language: tr Publisher: OmniChannels.ai by BroadNet Technologies Bu rehber, kişiselleştirilmiş içerikli WhatsApp şablonları oluşturan geliştiriciler ve pazarlamacılar içindir. İki değişken biçimini, değişkenlerin nereye konabileceğini, Meta'nın inceleme hakkında söylediklerini ve değerlerin API'den ya da bir elektronik tablodan nasıl gönderileceğini anlatır. ## WhatsApp şablon değişkenleri nedir? Değişken, şablon metninde gönderim sırasında gerçek bir değerle değiştirdiğiniz yer tutucudur. Meta bunlara parametre (parameters), WhatsApp Manager ise değişken (variables) der. Şablon metni ve örnek değerler bir kez incelenir; gerçek değerler her mesaj için verilir. Örneğin bir şablon gövdesi `Hi {{1}}! Your order number is {{2}}. Thank you.` biçimindedir ve bir müşteriye `Hi Layla! Your order number is OM-4821. Thank you.`, sonrakine başka bir değer çifti gönderirsiniz. Meta, şablon metnini ya da değişken değerlerini çevirmez. Bunları şablonun her dil sürümü için doğru dilde siz sağlarsınız. ## Konumsal ve adlandırılmış parametreler arasındaki fark nedir? Biçimi şablonu `parameter_format` alanıyla oluştururken seçersiniz. Alanı atlarsanız Meta `positional` kullanır. | | Konumsal | Adlandırılmış | |---|---|---| | Yer tutucu | `{{1}}`, `{{2}}` | `{{first_name}}`, `{{order_number}}` | | Adlandırma kuralı | 1'den başlayarak sırayla numaralı | Benzersiz, küçük harf ve alt çizgi | | Gönderim değerleri | Yer tutucu sırasını izlemeli | Herhangi bir sırada olabilir | | Örnek değerler | `body_text` dizisi | `param_name` ile `body_text_named_params` | | En uygun olduğu durum | Bir iki değişkenli kısa şablonlar | Başkalarının bakımını yapacağı, birkaç değişkenli şablonlar | Adlandırılmış parametreler şablon kitaplığında daha okunaklıdır ve yer değiştiren bir sıra, bir sipariş numarasını fark edilmeden ad yerine koyamaz. Konumsal şablonlar yazması daha kısadır ve varsayılan olarak kalır. ## Değişkenler nerelerde kullanılabilir? Meta'nın bileşen belgeleri şu yerleri sayar: | Bileşen | Değişkenler | |---|---| | Metin başlığı | Bir parametre | | Gövde | Birden çok parametre | | URL düğmesi | URL'nin sonuna eklenen bir değişken | | Medya başlığı (görsel, video, belge) | Yok; örnek dosya oluşturmada, asıl dosya gönderimde verilir | | Alt bilgi, hızlı yanıt ve telefon numarası düğmeleri | Değişken destekleyenler arasında sayılmaz | Belgelenmiş uzunluk sınırları: metin başlığı en çok 60 karakter, gövde 1.024, alt bilgi 60, düğme etiketi 25 ve düğme URL'si 2.000 karakter. Bir URL düğmesi değeri özel karakterler içeriyorsa Meta bunları yüzde kodlamayla (percent-encode) kodlamanızı söyler. ## Örnek değerleri nasıl veririm? Meta'nın kuralı şudur: şablonunuz değişken kullanıyorsa oluştururken her parametre için bir tane olmak üzere örnek değerler eklemelisiniz. Değişkeni olan bir başlık da bir `example` ister. Örnek değerli konumsal gövde: ```json { "type": "BODY", "text": "Hi {{1}}! Your order {{2}} ships on {{3}}.", "example": { "body_text": [["Layla", "OM-4821", "12 November"]] } } ``` Örnek değerli adlandırılmış gövde: ```json { "type": "BODY", "text": "Hi {{first_name}}! Your order {{order_number}} ships on {{ship_date}}.", "example": { "body_text_named_params": [ { "param_name": "first_name", "example": "Layla" }, { "param_name": "order_number", "example": "OM-4821" }, { "param_name": "ship_date", "example": "12 November" } ] } } ``` İkinci biçimde şablonun kendisi `"parameter_format": "named"` ayarını yapar. İncelemecilerin gerçek mesajın ne diyeceğini görebilmesi için gerçekçi örnekler kullanın. ## Meta, değişken kuralları ve retler hakkında ne diyor? Meta'nın şablon inceleme rehberi, değişkenlerle ilgili şu ret nedenlerini sayar: - Değişkenler eksik ya da süslü parantezleri eşleşmiyor. Doğru konumsal biçim `{{1}}`'dir. - Değişkenler sıralı değil, örneğin `{{1}}`, `{{2}}`, `{{5}}`, `{{4}}`. - Şablon bir değişkenle başlıyor ya da bitiyor. Meta bunlara sarkan parametreler (dangling parameters) der. - Şablonda mesaj uzunluğuna göre çok fazla değişken var. Meta bir oran vermez, bu yüzden her değişkenin çevresine sabit metin ekleyin. - Değişkenler `#`, `$` veya `%` gibi özel karakterler içeriyor. İki değişkenin doğrudan yan yana konmasıyla ilgili resmî bir açıklama bulamadık; bu yüzden bu konuda bir kural vermiyoruz. Aralarına sözcükler koyun; bu okunurluğu da artırır. Kategori kuralları ve reddedilmeye yol açan diğer şeyler için [WhatsApp şablon kategorileri ve onay](/tr/blog/whatsapp-template-categories-approval/) yazısına bakın. Hazır metinler için [WhatsApp mesaj şablonu örnekleri](/tr/blog/whatsapp-message-template-examples/) yazısına bakın. ## Parametreleri API çağrısında nasıl gönderirim? Şablon adını, dili ve değerleri içeren bir `components` dizisini gönderirsiniz. Konumsal bir şablon için biçim şöyledir: ```json { "messaging_product": "whatsapp", "to": "971500000000", "type": "template", "template": { "name": "order_shipped", "language": { "code": "en" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Layla" }, { "type": "text", "text": "OM-4821" }, { "type": "text", "text": "12 November" } ] } ] } } ``` Adlandırılmış bir şablonda her girdi ayrıca yer tutucuyla eşleşmesi gereken `parameter_name` taşır: ```json { "type": "text", "parameter_name": "order_number", "text": "OM-4821" } ``` ### Başlık medya parametreleri nasıl çalışır? Medya başlığında metin değişkeni yoktur. Oluşturma sırasında başlık, Meta'nın yükleme akışından gelen bir örnek dosya tutamacı taşır ve örnek şablonla birlikte incelenir. Gönderimde dosyayı iletirsiniz, örneğin medya kimliğiyle bir görsel: ```json { "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] } ``` Yukarıdaki kimlik Meta'nın belgelerindeki örnektir, gerçek bir dosya değildir. ### Bu, OmniChannels.ai API'sinde nasıl görünür? `sendbulk` uç noktamız, [WhatsApp API belgelerine](/developers/whatsapp/) göre şablonu form alanları olarak alır: | Şablon özelliği | Alanlar | |---|---| | Gövde değişkeni | `bodyTemplateVariables` | | Adlandırılmış parametre | `bodyTemplateVariables={"parameter_name":"order_id","text":"ORD-12345"}` | | Başlık metin değişkeni | `headerTemplateVariables` | | Başlık görseli, videosu veya belgesi | `mediaUrl` (başlık medyasını geçersiz kılar) | | Dinamik URL düğmesi | `buttonsTemplateVariable` | ## Uygulamalı örnek: sipariş kargoya verildi şablonu BAE'deki bir perakendeci olan "Souq Rafiq" (kurgusal), ürün görseli ve takip düğmesi içeren bir kargo bildirimi göndermek istiyor. 1. **Şablonu** bir değişkenle başlamayacak ya da bitmeyecek şekilde yazın: "Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it." 2. **Başlığı** görsel, alt bilgiyi düz metin olarak ekleyin; ayrıca `https://shop.example/track/{{1}}` biçiminde bir URL düğmesi ve `OM-4821` gibi bir örnek ekleyin. 3. **Gönderin**; her değişken için gerçekçi örnekler verin, sonra onay durumunu bekleyin. 4. **Gönderim yapın**: üç gövde değeri, takip son eki ve geçersiz kılacaksanız başlık görseliyle. ```bash curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -F batchId=0 \ -F campaignName=order-shipped \ -F destinationNo=971500000000 \ -F messageType=TEMPLATE \ -F templateName=order_shipped \ -F templateLanguage=en \ -F bodyTemplateVariables=Layla \ -F buttonsTemplateVariable=OM-4821 ``` Bu parça, tek bir değer için alan adlarını gösterir. Alıcı başına birkaç gövde değişkeni için komutu tekrarlamak yerine kişiselleştirilmiş bir yükleme kullanın. İlk kampanyanız için kodlamayı ekibimizle doğrulayın. ## Şablonu CSV'den nasıl kişiselleştiririm? Alıcı başına bir satır ve değişken başına bir sütun kullanın, sonra kişiselleştirilmiş bir gönderimde yükleyin. 1. Alıcının numarasını ilk sütuna uluslararası biçimde yazın. [E.164 telefon numarası biçimi](/tr/blog/e164-phone-number-format/) yazısına bakın. 2. Değişken başına bir sütun ekleyin ve ilk kampanyanız için sütun düzenini ekibimizle doğrulayın. 3. Önce veriyi temizleyin: boşlukları kırpın, büyük-küçük harfi düzeltin, tek tarih biçimi kullanın ve boş değerleri kaldırın; çünkü boş bir değişken bozuk bir mesaja veya başarısız bir gönderime yol açar. 4. Birkaç satırı önizleyin ve önce kendi numaranıza gönderin. Veri temizleme adımları [Excel veya CSV'den toplu SMS gönderme](/tr/blog/send-bulk-sms-from-excel-csv/) yazısında ele alınır; WhatsApp için de aynen geçerlidir. ## Konumsal ve adlandırılmış arasında nasıl seçerim? Şablona kaç kişinin dokunacağına ve kaç değişkeni olduğuna göre seçin. 1. Bir ya da iki değişken, tek sahip: konumsal yeterlidir ve varsayılandır. 2. Üç veya daha fazla değişken ya da şablonları birkaç ekibin düzenlemesi: adlandırılmışı kullanın; böylece her yer tutucu kendini açıklar. 3. Aynı metin birkaç dilde: adları veya numaraları sürümler arasında aynı tutun; böylece tek bir gönderim rutini her dili doldurabilir. 4. Hangi kaynak sütunun hangi değişkeni beslediğine dair bir kayıt her zaman tutun; böylece şablonda sonradan yapılan bir düzenleme veriyi kaydırmaz. Göndermeden önce bitmiş mesajı örnek değerlerle yüksek sesle okuyun. Doğal gelmiyorsa incelemecilere ve müşterilere de öyle gelecektir. ## Sık yapılan hatalar nelerdir? - **Değişkenle başlamak veya bitmek;** Meta bunu ret nedeni olarak sayar. - **Numara atlamak** ya da konumsal şablonda aynı numarayı sırasız yeniden kullanmak. - **Yer tutucu örnekler,** örneğin incelemecilere hiçbir şey anlatmayan "test". - **Değişkenler içinde özel karakterler,** örneğin `#`, `$` veya `%`. - **Gönderimde yanlış sıra;** konumsal şablonda doğru veriyi yanlış yere koyar. - **Adlandırılmış şablonda eşleşmeyen `parameter_name`.** - **Mesajın asıl amacını gizlemek için değişken kullanmak.** Kategorisi içeriğiyle uyuşmayan bir şablon reddedilebilir veya yeniden sınıflandırılabilir; [kategoriler rehberine](/tr/blog/whatsapp-template-categories-approval/) bakın. - **Sınırlar:** Bu rehber, Meta'nın belgelerinin yazıldığı andaki içeriğini aktarır. İnceleme kararları Meta'ya aittir ve kurallar değişir; bağlantılı sayfaları kontrol edin. ## OmniChannels.ai nasıl yardımcı olur? BroadNet, Meta'nın resmî İş Çözümü Sağlayıcısıdır (Business Solution Provider). OmniChannels.ai'da değişkenli, medyalı ve düğmeli WhatsApp şablonları oluşturabilir, önizleyebilir ve onay durumunu izleyebilir; ardından kişiselleştirilmiş değerlerle API'den ya da bir kampanyada Excel ya da CSV yüklemesiyle gönderebilirsiniz. Mükerrer kayıt filtreleme ve iletim raporları dahildir. [WhatsApp Business API sayfasına](/tr/channels/whatsapp-business-api/) ve [kampanya platformuna](/tr/platform/campaigns/) bakın.