WhatsApp şablon kuralları: her kontrolün anlamı ve nasıl düzeltileceği
OmniBrand'in bir WhatsApp şablonunu Meta görmeden önce yaptığı her kontrol, koduyla birlikte (VAR_EDGE, BUTTON_GROUPING, EDIT_LIMIT...): ne anlama geldiği, Meta'nın neden önemsediği ve nasıl düzeltileceği.
Bu konuda daha fazla video
Bir WhatsApp şablonu inceleme için Meta'ya gitmeden önce OmniBrand onu Meta'nın yayımladığı kurallara göre kontrol eder. Aynı kontroller siz yazarken tarayıcınızda ve İncelemeye gönder düğmesine bastığınızda sunucumuzda yeniden çalışır; böylece Meta'nın kesinlikle reddedeceği bir şablon asla OmniBrand'den çıkmaz. Her kontrolün bir kodu vardır; bu sayfa her birini açıklar.
Bir kontrol nasıl okunur
- Düzeltilmesi zorunlu: Meta şablonu reddedecektir. Şablon oluşturucuda sorun düzeltilene kadar İncelemeye gönder devre dışı kalır; Kontroller paneli sorunu Düzeltilmesi zorunlu altında listeler ve OmniBrand sizin için düzeltebiliyorsa bir Düzelt düğmesi gösterir. Gönderdiğinizde sunucu yine de bir sorun bulursa oluşturucu "Meta bu şablonu reddederdi, bu yüzden hiçbir şey gönderilmedi. Bunları düzeltip yeniden deneyin:" mesajını gösterir.
- Olası ret: ret veya yeniden kategorilendirme için yaygın bir neden. Yine de gönderebilirsiniz.
- İpuçları: yalnızca tavsiye.
- *OmniBrand yönergesi* olarak işaretlenen kontroller, Meta'nın bir sayı yayımlamadığı durumlarda kendi pratik kuralımızdır; asla Düzeltilmesi zorunlu değildir.
- Kimler gönderebilir: WhatsApp şablonlarını yönet görevine sahip üyeler (varsayılan olarak Sahipler, Yöneticiler ve Editörler; bkz. Roller ve görevler).
Meta'nın kendisi reddettiğinde
Meta yine de reddederse oluşturucu, Meta'nın kendi ifadeleriyle "Meta şablonu reddetti:" der ve Meta tanıdığımız bir hata numarası gönderdiyse aşağıdaki ilgili kuralı gösterir: 2388299 VAR_EDGE, 2388293 VAR_DENSITY, 2388019 TEMPLATE_QUOTA, 2388039 EDIT_WHILE_PENDING, 2388040 BODY_MAX, 2388047 HEADER_NO_MARKDOWN, 2388072 VAR_SYNTAX, 2388073 FOOTER_NO_VARS ve 2388024 NAME_TAKEN_LANG kuralıdır. Meta'da hiçbir şey değişmez: yeni bir şablon oluşturucuda Taslak olarak kalır (metni düzeltin ve yeniden İncelemeye gönder düğmesine basın), gönderilmiş bir şablon ise durumunu korur (düzeltin ve yeniden Değişiklikleri kaydet düğmesine basın).
Yeni bir şablonda, Meta İncelemeye gönder reddettiğinde hiçbir şey kaydedilmiyor: oluşturucu metninizle açık kalır, bu yüzden Meta'nın adlandırdığı şeyi düzeltin ve tekrar İncelemeye gönder basın. Üzerinde çalışırken bir kopyayı saklamak için önce Taslak kaydet basın.
NAME_FORMAT (düzeltilmesi zorunlu)
Ad yalnızca küçük İngilizce harfler, rakamlar ve alt çizgiler içerebilir ve en fazla 512 karakter olabilir, örn. eid_offer_2026. Boşlukları alt çizgiyle, büyük harfleri küçük harfle değiştirin.
NAME_TAKEN_LANG (düzeltilmesi zorunlu)
Bu WhatsApp Business hesabında bu dilde bu ada sahip bir şablon zaten var. Başka bir ad seçin veya mevcut şablona farklı bir dil ekleyin.
Mesajda şu bağlantı var: Bu isimle şablonu açın: mevcut şablonu, örneğin daha önce kaydettiğiniz bir taslağı açar.
NAME_RECENTLY_DELETED (olası ret)
Bu ada sahip bir şablon 30 günden kısa süre önce silindi. Meta, silinmiş onaylı bir şablonun adını 30 gün boyunca engeller; bu yüzden yeni bir ad seçin veya bekleyin.
LANGUAGE_CODE (düzeltilmesi zorunlu)
Dil kodu WhatsApp'ın kabul ettiği kodlardan biri değil. Meta'nın kodlarını kullanın: en, en_US, en_GB, ar, ar_EG, ar_AE vb. Portekizce pt_BR veya pt_PT olmalıdır.
LANGUAGE_SCRIPT_MISMATCH (olası ret, OmniBrand yönergesi)
Metin seçilen dile benzemiyor: metni çoğunlukla Arapça olmayan bir Arapça şablon veya çoğunlukla Arapça yazılmış bir İngilizce şablon. Dili değiştirin veya metni çevirin. Meta asla çeviri yapmaz; her dili ayrı yazın.
CATEGORY_ADVICE (olası ret, OmniBrand yönergesi)
Bir Kullanım veya Doğrulama şablonu tanıtım amaçlı kelimeler (teklif, indirim, kampanya, عرض، خصم...) veya tanıtım amaçlı bir düğme içeriyor. Meta bu tür şablonları Pazarlama olarak onaylar; bu da pazarlama fiyatlarına mal olur ve yalnızca pazarlamaya izin vermiş kişilere gönderilebilir. Tanıtımı kaldırın veya Pazarlama'yı seçin.
AUTH_SHAPE (düzeltilmesi zorunlu)
Doğrulama şablonlarının Meta tarafından belirlenmiş sabit bir yapısı vardır: gövde "{{1}} doğrulama kodunuzdur." şeklindedir, tek bir tek kullanımlık şifre düğmesi (Kodu kopyala, Tek dokunuşla otomatik doldurma veya Sıfır dokunuş) bulunur; başlık, alt bilgi, medya, bağlantı veya emoji bulunmaz ve kodun geçerlilik süresi 1 ile 90 dakika arasındadır. Tek dokunuş ve sıfır dokunuş düğmeleri Android uygulamanızın paket adını ve imza karmasını gerektirir. Sıfır dokunuş ayrıca Meta'nın sıfır dokunuş koşullarını kabul etmenizi gerektirir (oluşturucuda Düğme altındaki onay kutusu).
BODY_REQUIRED (düzeltilmesi zorunlu)
Her şablonun gövde metni olmalıdır.
BODY_MAX (düzeltilmesi zorunlu)
Gövde Meta'nın izin verdiğinden uzun: 1.024 karakter (sınırlı süreli teklif için 600). Kısaltın.
HEADER_TEXT_REQUIRED (düzeltilmesi zorunlu)
Metin başlığı seçtiniz ama boş bıraktınız. Başlığı yazın veya başlıksız seçeneğini seçin.
HEADER_TEXT_MAX (düzeltilmesi zorunlu)
Bir metin başlığı en fazla 60 karakter olabilir.
HEADER_ONE_VAR (düzeltilmesi zorunlu)
Bir metin başlığı yalnızca bir değişken içerebilir.
HEADER_NO_MARKDOWN (düzeltilmesi zorunlu)
Başlık düz metin olmalıdır: biçimlendirme karakteri (* _ ~ `), satır sonu ve emoji içermemelidir.
HEADER_MEDIA_SAMPLE (düzeltilmesi zorunlu)
Görsel, video veya belge başlığı, Meta'nın şablonu incelerken kullanacağı bir örnek dosya gerektirir. Kabul edilenler: en fazla 5 MB JPEG veya PNG görseller, en fazla 16 MB MP4 videolar, en fazla 100 MB PDF belgeler. OmniBrand dosyanın adını değil, dosyanın kendisini kontrol eder. WhatsApp Manager'da oluşturulan bir şablon, burada düzenlenebilmesi için yeni bir örnek gerektirir.
HEADER_LOCATION_CATEGORY (düzeltilmesi zorunlu)
Konum başlığına yalnızca Pazarlama ve Kullanım şablonlarında izin verilir.
FOOTER_MAX (düzeltilmesi zorunlu)
Alt bilgi en fazla 60 karakter olabilir.
FOOTER_NO_VARS (düzeltilmesi zorunlu)
Alt bilgi değişken içeremez.
VAR_SYNTAX (düzeltilmesi zorunlu)
Bir değişken yanlış yazılmış. Numaralı değişkenler {{1}}, {{2}} şeklinde; adlandırılmış değişkenler {{first_name}} şeklinde (küçük harfler, rakamlar ve alt çizgiler) yazılır. Süslü parantezler eşleşmelidir ve bir şablon ya numara ya ad kullanır, asla ikisini birden kullanmaz.
VAR_SEQUENTIAL (düzeltilmesi zorunlu)
Numaralı değişkenler {{1}} ile başlamalı ve ilk göründükleri sırayla boşluk bırakmadan 1, 2, 3 şeklinde devam etmelidir.
VAR_EDGE (düzeltilmesi zorunlu)
Metin bir değişkenle başlıyor veya bitiyor (Meta hatası 2388299). İlk değişkenden önce ve son değişkenden sonra kelimeler ekleyin, örn. "{{1}}, siparişiniz hazır" yerine "Merhaba {{1}}, siparişiniz hazır."
VAR_ADJACENT (düzeltilmesi zorunlu)
İki değişken, aralarında yalnızca boşluk veya noktalama işareti olacak şekilde yan yana duruyor. Aralarına kelimeler koyun.
VAR_DENSITY (olası ret, OmniBrand yönergesi)
Metnin uzunluğuna göre çok fazla değişken var (Meta hatası 2388293). Meta kesin bir oran yayımlamaz; değişken başına 3 kelimeden az sabit metin olduğunda veya değişkenler kelimelerin %30'undan fazlasını oluşturduğunda uyarırız. Metin ekleyin veya daha az değişken kullanın.
VAR_EXAMPLE (düzeltilmesi zorunlu)
Her değişkenin, Meta'nın inceleyicilerinin okuduğu gerçekçi bir örnek değeri olmalıdır. Bir örnek boş olamaz; satır sonu, sekme veya art arda 4 boşluk içeremez; başka bir değişken olamaz ya da "test", "x" veya "name" gibi bir yer tutucu olamaz. "Sara" veya "A-1042" gibi gerçek görünen bir değer kullanın.
BUTTON_COUNTS (düzeltilmesi zorunlu)
Çok fazla düğme: toplamda en fazla 10, 10 hızlı yanıt, 2 web sitesi düğmesi, 1 arama düğmesi, 1 kod kopyalama düğmesi (ve Flow, katalog, ürün listesi ve WhatsApp araması düğmelerinin her birinden birer tane). Tek kullanımlık şifre düğmeleri yalnızca doğrulama şablonlarına aittir.
BUTTON_TEXT (düzeltilmesi zorunlu)
Her düğmenin değişken içermeyen, 1 ile 25 karakter arasında bir etiketi olmalıdır ve iki düğme aynı etiketi paylaşamaz.
BUTTON_GROUPING (düzeltilmesi zorunlu)
Hızlı yanıt düğmeleri web sitesi veya arama düğmeleri arasına karışmadan bir arada durmalıdır. Onları yan yana taşıyın.
URL_FORMAT (düzeltilmesi zorunlu)
Bir web sitesi düğmesi en fazla 2.000 karakterlik tam bir https:// bağlantısı gerektirir. Bağlantı {{1}} şeklinde yazılmış tek bir değişkenle bitebilir, örneğin https://example.com/order/{{1}}, ve bu değişken boşluk içermeyen bir örnek (sipariş numarası gibi) gerektirir. Boşlukları ve İngilizce olmayan karakterleri kodlayın (%20).
URL_SHORTENER (olası ret, OmniBrand yönergesi)
Bağlantı bir bağlantı kısaltıcı kullanıyor (bit.ly, tinyurl, t.co...). İnceleyiciler bunları sıklıkla reddeder; kendi alan adınızda bir bağlantı kullanın.
PHONE_FORMAT (düzeltilmesi zorunlu)
Bir arama düğmesi, numarayı ülke koduyla birlikte uluslararası biçimde gerektirir, örn. +447400123456; en fazla 20 karakter.
BUTTONS_DESKTOP (ipucu)
3'ten fazla düğme olduğunda WhatsApp 2 tanesini gösterir ve geri kalanını "Tüm seçenekleri gör" altına koyar. 4 veya daha fazla düğme olduğunda ya da hızlı yanıtlar başka düğmelerle karıştırıldığında WhatsApp masaüstü şablonu hiç göstermez.
CAROUSEL_SHAPE (düzeltilmesi zorunlu)
Döngü (carousel) yalnızca Pazarlama içindir ve 2 ile 10 arasında kart içerir. Her kartta bir görsel veya video (hepsi aynı türde), her kartta aynı sırayla aynı türlerde en fazla 2 düğme ve en fazla 160 karakterlik kart metni (ya tüm kartlarda ya hiçbirinde) bulunur. Kartların üstünde başlık veya alt bilgi yoktur.
LTO_SHAPE (düzeltilmesi zorunlu)
Sınırlı süreli teklif yalnızca Pazarlama içindir: değişken içermeyen en fazla 16 karakterlik bir teklif başlığı, görsel veya video başlığı, en fazla 600 karakterlik bir gövde, alt bilgi yok, ilk sırada bir kod kopyalama düğmesi (kod en fazla 15 karakter) ve ardından en fazla bir web sitesi düğmesi.
COUPON_SHAPE (düzeltilmesi zorunlu)
Bir kupon şablonunda, 1 ile 20 karakter arasında ve boşluk içermeyen örnek bir koda sahip tam olarak bir kod kopyalama düğmesi bulunur.
CATALOG_SHAPE (düzeltilmesi zorunlu)
Bir katalog şablonunda tam olarak bir Kataloğu görüntüle düğmesi bulunur; başka düğme ve başlık yoktur (WhatsApp bir ürün görseli gösterir).
MPM_SHAPE (düzeltilmesi zorunlu)
Bir ürün listesi şablonu bir metin başlığı ve tam olarak bir Ürünleri görüntüle düğmesi gerektirir. Oluşturucuda Ürünler altında listelediğiniz bölümler WhatsApp'ın gösterebileceklerine uymalıdır: toplamda en fazla 10 bölüm ve 30 ürün; her bölümün en fazla 24 karakterlik bir başlığı ve en az bir ürün ID'si olmalıdır.
FLOW_SHAPE (düzeltilmesi zorunlu)
Bir Flow şablonu, tek bir Flow'u belirten tam olarak bir Flow düğmesi ve gezinme yaptığında açtığı ekranı gerektirir.
CONTENT_SENSITIVE_ID (olası ret, OmniBrand yönergesi)
Metin tam bir kart, hesap, IBAN veya kimlik numarası istiyor gibi görünüyor. Meta bunları reddeder; son 4 haneyi istemek sorun değildir.
CONTENT_THREAT (olası ret, OmniBrand yönergesi)
İfade tehdit edici veya utandırıcı olarak algılanabilir ("son uyarı", "yasal işlem"). Meta taciz edici veya tehdit edici şablonları reddeder. Kibar bir dille yeniden yazın.
CONTENT_PROHIBITED (olası ret, OmniBrand yönergesi)
Metinde, WhatsApp'ın İş ve Ticaret politikalarının her ülkede yasakladığı veya kısıtladığı bir şeyden bahsediliyor: alkol, tütün, kumar, flört, kripto para veya kredi verme (çek ayrıca uyuşturucu ve silah için de arıyor). Kaldır.
DUPLICATE (olası ret)
Bu WhatsApp Business hesabındaki başka bir şablon aynı metne sahip. Meta kopyaları reddeder; ifadeyi değiştirin veya mevcut şablonu kullanın.
EMOJI_DENSE (olası ret, OmniBrand yönergesi)
Mesajda 10'dan fazla emoji var ya da 3 veya daha fazla emoji var ve her 8 kelimeye birden fazla emoji düşüyor. Daha az kullanın.
MARKETING_OPT_OUT (ipucu)
Bir Pazarlama şablonu, kişilere durdurma imkânı vermelidir: "Tanıtımları durdur" hızlı yanıtı ve "Abonelikten çıkmak için STOP yazın" gibi bir alt bilgi ekleyin.
TEMPLATE_QUOTA (düzeltilmesi zorunlu)
WhatsApp Business hesabı Meta'nın şablon sınırına ulaştı: doğrulanmamış bir işletme için 250 şablon, onaylı görünen ada sahip doğrulanmış bir işletme için 6.000 şablon (her dil ayrı sayılır). Artık kullanmadığınız şablonları silin.
EDIT_LIMIT (düzeltilmesi zorunlu)
Yalnızca onaylı, reddedilmiş veya duraklatılmış şablonlar düzenlenebilir. Onaylı bir şablon 24 saatte bir kez ve 30 günde en fazla 10 kez düzenlenebilir; reddedilmiş ve duraklatılmış şablonlarda sınır yoktur. Mesaj kaç saat kaldığını söyler. Yalnızca OmniBrand'in kendi ayarlarını (bir değişkenin değerinin nereden geldiği, yedek değeri) değiştirmek düzenleme sayılmaz ve her zaman serbesttir.
EDIT_CATEGORY_LOCKED (düzeltilmesi zorunlu)
Onaylı bir şablonun kategorisi değiştirilemez. Bunun yerine diğer kategoride yeni bir şablon oluşturun.
EDIT_WHILE_PENDING (düzeltilmesi zorunlu)
Şablon incelemede (PENDING veya IN_APPEAL) ve Meta karar verene kadar düzenlenemez (Meta hatası 2388039).
MESSAGE_TTL (düzeltilmesi zorunlu)
Meta, seçilen Mesaj geçerlilik süresi değerini bu kategori için kabul etmiyor. İzin verilenler: Kimlik doğrulama 30 saniye ile 15 dakika arası veya 30 gün; Fayda 30 saniye ile 12 saat arası veya 30 gün; Pazarlama 12 saat ile 30 gün arası; her zaman tam saniye. Düzelt alanı Meta'nın varsayılanına geri döndürür. Kategoriyi bu süreyi kabul etmeyen bir kategoriye değiştirmek süreyi kendiliğinden kaldırır.
MESSAGE_TTL_ADVICE (olası ret)
Bir doğrulama mesajı, kodunun süresi dolduktan sonra ulaşabilir: Mesaj geçerlilik süresi (veya Meta'nın 10 dakikalık varsayılanı), Kodun ne zaman sona ereceğini belirt (Dakika) altında ayarlanan kod geçerlilik süresinden uzun. Meta, geçerlilik süresinin kod geçerlilik süresinden uzun olmamasını önerir; Düzelt geçerlilik süresini kod geçerlilik süresine eşitler.
MESSAGE_TTL_ROUTE (ipucu)
Meta, bir pazarlama şablonunun geçerlilik süresini Optimize edilmiş teslimat (Marketing Messages API) ile gönderilen mesajlara uygular. Normal Cloud API üzerinden gönderilen pazarlama mesajları 30 güne kadar yeniden denenmeye devam eder.