WhatsApp şablonu karakter sınırları
Meta'nın şablon bileşenleri belgeleri, bir şablonun her bölümü için kesin sınırlar belirler. Bu sınırları aşan gönderimler bir insan inceleyiciye ulaşmadan API'de başarısız olur; bu yüzden yazarken denetlemek işe yarar.
Karakterler göründüğü gibi sayılır: bir emoji veya bir Arapça harf bir karakterdir. Satır sonları da sayılır ve *kalın* içindeki yıldızlar gibi Markdown tarzı biçimlendirme karakterleri de sayıma dahildir.
Kaynak: Meta, Template components, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components (Ekim 2026'da kontrol edildi).
- Şablon adı: en fazla 512 karakter; yalnızca küçük harf, rakam ve alt çizgi.
- Metin başlığı: en fazla 60 karakter ve en çok 1 değişken. Medya başlıkları görsel, video veya belge olabilir; konum başlıklarına yalnızca bilgilendirme (Utility) ve pazarlama için izin verilir.
- Gövde: en fazla 1.024 karakter, zorunludur, istediğiniz kadar değişken içerebilir.
- Alt bilgi: en fazla 60 karakter, değişken yok.
- Butonlar: toplamda en fazla 10; bunun içinde en çok 10 hızlı yanıt, 2 URL butonu, 1 telefon numarası butonu ve 1 kod kopyalama butonu. Buton etiketleri 25 karakterle, URL'ler 2.000, telefon numaraları 20 ve kopyalama kodları 20 karakterle sınırlıdır.
Reddedilmelere yol açan değişken kuralları
Reddedilen şablonların çoğu ifadelerinde değil, yer tutucularında başarısız olur. Meta'nın şablon inceleme rehberi, reddettiği değişken sorunlarını sıralar: sıralı olmayan, #, $ veya % gibi özel karakterler içeren, küme parantezleri eşleşmeyen veya mesajın en başında ya da sonunda yer alan parametreler ("dangling parameters").
Meta ayrıca uzunluğuna göre çok fazla değişken içeren şablonları da reddeder. Kesin bir oran yayımlamaz; bu yüzden araç, değişken başına üçten az sabit sözcük olduğunda uyarır. İnceleyiciler yan yana yerleştirilmiş iki değişkeni de sık sık reddeder; örneğin {{1}} {{2}}. Bunları tek değişkende birleştirin veya araya sözcük koyun.
Her değişken, gönderim sırasında gerçekçi bir örnek değere ihtiyaç duyar. İnceleyiciler mesajın gerçekte ne söylediğini anlamak için örnekleri okur; bu yüzden "test" veya "xxx" reddedilme riskini artırır.
Kaynak: Meta, Template review, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review.
Şablon reddedildi mi? Meta'nın gerekçesini çözün
"Rejected? Paste Meta's reason" sekmesine geçin ve gerekçeyi WhatsApp Manager'dan, Business Support Home'dan, ret e-postasından veya message_template_status_update webhook'undan yapıştırın. Araç; INVALID_FORMAT, INCORRECT_CATEGORY, TAG_CONTENT_MISMATCH, PROMOTIONAL, SCAM ve ABUSIVE_CONTENT gibi Meta'nın gerekçe kodlarını ve Meta'nın şablon inceleme rehberindeki yaygın nedenlerin ifadelerini tanır, ardından olası nedeni ve çözümü gösterir.
Reddedilen bir şablon düzenlenip yeniden gönderilebilir veya örnek değerler ekledikten sonra WhatsApp Manager'da itiraz edebilirsiniz; Meta, itirazların 24 saat içinde karara bağlandığını belirtir. NONE gerekçesi, şablonun reddedilmediği, duraklatıldığı anlamına gelir.
Bilgilendirme (Utility), pazarlama ve kimlik doğrulama farkı
Kategori hem onayı hem fiyatı belirler. Bilgilendirme (Utility) şablonları, müşterinin yaptığı veya talep ettiği bir şeyi (sipariş, rezervasyon, hesap değişikliği ya da uyarı) takip eder ve promosyon içermemelidir. Kimlik doğrulama şablonları tek kullanımlık şifreler taşır ve Meta'nın sabit ifadesini kullanır. Sepet hatırlatmaları, teklifler ve yeniden etkileşim dahil geri kalan her şey pazarlamadır.
Meta'nın kategorilendirme yönergelerine göre hizmet ve promosyon içeriğini karıştıran bir şablon pazarlamadır. İndirim kodları, satış teklifleri, çapraz satış, sepet hatırlatmaları ve uygulama indirme çağrıları şablonu pazarlamaya iter. Meta onaylı şablonları düzenli olarak yeniden denetler ve promosyon gibi görünen hizmet şablonlarını genellikle bir gün önceden haber vererek pazarlama kategorisine taşır.
Denetleyici, İngilizce, Arapça, Fransızca, İspanyolca, Almanca ve Portekizce ifadelerinizi promosyon terimleri açısından tarar ve Meta şablonu sizin yerinize yeniden kategorilendirmeden önce sizi uyarır. Tek kullanımlık şifreleri yalnızca kimlik doğrulama şablonları gönderebileceği için diğer kategorilerdeki OTP ifadelerini de işaretler.
Kaynak: Meta, Template categorization, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization.
Butonlar: gruplama, dinamik URL'ler ve müşterilerin gördükleri
Hızlı yanıt butonları ve harekete geçirici mesaj butonları gruplanmalıdır: tüm hızlı yanıtlar diğer butonlardan önce ya da hepsi sonra gelmelidir. İki bağlantı arasına sıkışmış bir hızlı yanıt API tarafından reddedilir.
Bir URL butonu bir değişken taşıyabilir ve bu değişken URL'nin sonunda yer almalıdır; örneğin https://shop.example.com/orders/{{1}}. Gönderdiğiniz değeri yüzde kodlamasıyla kodlayın (boşluk %20 olur). Bağlantı kısaltıcılardan kaçının: hedefi gizlerler ve spam gibi görünürler.
Bir şablonda üçten fazla buton olduğunda WhatsApp ikisini gösterir, kalanı "See all options" arkasına koyar. Dört veya daha fazla butonlu şablonlar ya da diğer butonlarla karışık hızlı yanıtlar WhatsApp masaüstü istemcilerinde görüntülenemez; bu yüzden en önemli eylemi başa koyun.
Önizlemeden ölçekli gönderime
Dışa aktarılan JSON, örnek değerler dahil, WhatsApp Business Management API'deki POST /<WABA_ID>/message_templates isteğinin gövdesini izler. Medya başlıkları için Resumable Upload API ile bir örnek yükleyin ve yer tutucu tanıtıcıyı (handle) değiştirin.
Onaylandıktan sonra şablonu adıyla ve diliyle, her değişken için gerçek değerlerle gönderirsiniz. OmniChannels.ai şablonları WhatsApp Business hesapları genelinde yönetir, inceleme durumunu ve kaliteyi izler; onaylı şablonları tek bir REST API, kampanyalar veya ortak gelen kutusu üzerinden, WhatsApp kullanılamadığında SMS yedeğiyle gönderir.
