What's new, 21 October 2026: A customer who sends several messages before the bot's first reply no longer gets the opening sequence of a Chat Flow twice
WASync · Developers

WhatsApp şablonları (WABA)

WASync'te WhatsApp Business API mesaj şablonları oluşturun, Meta onay sürecini takip edin ve şablonları CRM sohbetinden, Bitrix24 otomasyon kurallarından ve Chat Flows'tan gönderin.

Şablon, Meta'nın önceden onayladığı bir mesajdır. Bir WhatsApp Business API (WABA) numarasının, son 24 saat içinde size yazmamış bir müşteriye gönderebileceği tek mesaj türü budur. Bu sayfada WASync'te şablon yazmayı, Meta tarafında neler olduğunu ve şablonu gönderebileceğiniz tüm yerleri bulacaksınız.

Şablon nedir ve ne zaman gerekir?

WhatsApp, işletmelere 24 saatlik bir müşteri hizmetleri penceresi tanır. Pencere, müşteri size yazdığında açılır ve müşterinin son mesajından sonra 24 saat boyunca açık kalır.

  • Pencere açıkken serbest metin, dosya veya sesli mesaj gönderebilirsiniz.
  • Pencere kapalıyken (müşteri hiç yazmadıysa ya da 24 saatten uzun süre önce yazdıysa) yalnızca onaylı bir şablon gönderilebilir. Müşteri yanıt verdiğinde pencere yeniden 24 saat için açılır.

WASync Chat'te pencere kapalıysa Conversation paused — send a template to re-engage başlıklı bir uyarı ve Pick a template düğmesi görünür. Sohbet başlığındaki bir etiket de pencerede ne kadar süre kaldığını gösterir.

Her şablon üç kategoriden birine aittir. Meta bu kategoriyi inceleme ve ücretlendirme için kullanır:

KategoriNe için kullanılır
UtilityMüşterinin zaten başlattığı bir işlemle ilgili bilgilendirme: randevu onayı, sipariş durumu, fatura, teslimat, ödeme hatırlatması.
MarketingTeklifler, kampanyalar, haberler, eski bir müşteriyle yeniden iletişime geçme.
AuthenticationTek kullanımlık kodlar. Metni Meta tarafından belirlenir. WASync henüz bunları oluşturamıyor.

Şablon mesajları Meta tarafından, şablon mesajı başına ve kategoriye göre (marketing, utility, authentication) ücretlendirilir. Açık bir 24 saatlik müşteri hizmetleri penceresi içinde gönderilen utility şablonları ücretsizdir. Ücret, WASync üzerinden değil, Meta hesabınızdaki ödeme yönteminden tahsil edilir. Şablon oluşturmanın veya göndermenin (onaya sunmanın) bir maliyeti yoktur.

Gereksinimler

  • WASync'e bağlı, WABA planında bir WABA numarası. QR ile eşleştirilmiş numaradan farkı için Bağlantı türleri sayfasına bakın.
  • Şablonları yönetmek için: yönetici olmanız ya da WhatsApp numbers & templates alanında yazma erişimi olan bir ekip üyesi olmanız gerekir (Staff access matrix). Listeyi görmek için okuma erişimi yeterlidir.
  • Şablonları göndermek için: diğer tüm mesajlarda olduğu gibi, Connections → Staff bölümünde numaraya erişiminiz olmalıdır.

QR ile eşleştirilmiş numaralar şablon gönderemez

Şablonlar yalnızca resmî WhatsApp Business API'de bulunur. QR ile eşleştirilmiş bir numarada şablon düğmesi sunulmaz. Şablon göndermeye çalışan bir robot veya otomasyon şu hatayla başarısız olur: This WhatsApp connection cannot send templates. Templates need a WhatsApp Business (Cloud API) number.

Şablon oluşturma

Bitrix24'te WASync uygulamasını açın, Connections sayfasına gidin, WABA numarasının … menüsünü açın ve Message templates seçeneğini seçin. Liste her şablonu dili, kategorisi, durumu ve reddedilenler için Meta'nın gerekçesiyle birlikte gösterir. + New template düğmesine tıklayın.

Mesaj ne için?

Inform a customer (Utility), Promote an offer (Marketing) veya Send a code (Coming soon olarak işaretli) seçeneklerinden birini seçin. Bu seçim kategoriyi sizin yerinize belirler. Burada dürüst olun: Utility olarak gönderilen bir tanıtım metni Meta tarafından reddedilir veya Marketing kategorisine taşınır.

Ayrıca bir örnekle de başlayabilirsiniz (Appointment reminder, Order is ready, Offer with an image, Let's pick up the conversation) ve bir sonraki adımda her şeyi değiştirebilirsiniz. Message language alanını seçin. Bir şablon tek bir dilde olur; başka bir dil için ayrı bir şablon oluşturursunuz.

Mesajı yazın

Metni müşterinin alacağı şekilde yazın. Sağdaki önizleme, müşterinin göreceği görünümdür (en fazla 1.024 karakter).

  • Kişiselleştirme. Değişken eklemek için + Personalize düğmesine tıklayın: yaygın bir değişken (Customer name, Date, Time, Order number, Expiry date, Product or service, Amount), bir Bitrix24 field ya da kendi etiketiniz. Arka planda her biri {{1}}, {{2}} gibi bir ifadeye dönüşür. Süslü parantezleri elle yazmayın.
  • Onay için örnekler. Meta, her değişken için gerçekçi bir örnek değer ister (örneğin "Ana", "31 October"). İnandırıcı değerler kullanın, asla gerçek müşteri verisi kullanmayın. Bu değerler kimseye gönderilmez.
  • Başlık (isteğe bağlı). Bir başlık metni (en fazla 60 karakter, değişken içermez) ya da bir Image (JPEG veya PNG, en fazla 5 MB), Video (MP4, en fazla 16 MB) veya PDF (en fazla 16 MB). Yüklediğiniz dosya, Meta'nın incelediği örnektir. WASync bunu şablonun varsayılan dosyası olarak saklar; böylece operatörlerden dosya yeniden istenmez.
  • Diğer seçenekler. Alt bilgi (en fazla 60 karakter), en fazla 3 hızlı yanıt düğmesi, bir bağlantı düğmesi (sabit URL, değişken yok), bir arama düğmesi ve Include a WhatsApp call-permission request. Düğme etiketleri 25 karakterle sınırlıdır.

WhatsApp, bir değişkenle başlayan veya biten mesajları reddeder; bu yüzden ilk değişkenden önce ve son değişkenden sonra bir kelime ekleyin. WASync, devam etmeden önce bu kuralı ve diğer kuralları denetler.

Onaya gönderin

Şablona ekibinizin tanıyacağı bir Template name verin (yalnızca ekibiniz görür). WASync, Meta'nın istediği teknik adı sizin için üretir: küçük harfler, rakamlar ve _; bu numara ve dil içinde benzersizdir. Kontrol listesi nelerin doğrulandığını gösterir. Send to WhatsApp for approval düğmesine tıklayın. Müşterilere hiçbir şey gönderilmez.

Taslak yoktur: liste Meta'daki durumu yansıtır; bu nedenle bir şablon WASync'te yalnızca onaya gönderildikten sonra var olur.

Gönderdikten sonra

Şablon listede Pending olarak görünür. Meta şablonu inceler: genellikle birkaç dakika, bazen birkaç saat, ara sıra bir güne kadar sürebilir. WASync, Meta'nın kararını otomatik olarak alır ve durumu günceller. Hemen kontrol etmek isterseniz Resync from Meta güncel durumu çeker.

DurumAnlamı
PendingMeta inceliyor. Henüz gönderilemez.
ApprovedHazır. Gönderilebilen tek durum budur.
RejectedMeta reddetti. Gerekçe kartta görünür. Metni düzeltin ve yeni bir şablon oluşturun.
PausedMeta şablonu duraklattı. Yeniden etkin olana kadar gönderimler başarısız olur.
Disabled, In appeal, Pending deletion, Deleted, Limit exceededMeta'nın kendi durumları; alındığı gibi gösterilir.

Bir kartın üzerindeki ✕, şablonu siler ve Meta'dan da siler.

Medya şablonunun varsayılan dosyası

Başlığında görsel, video veya PDF bulunan bir şablon, her gönderimde o dosyaya ihtiyaç duyar. Meta kendi kopyasını yalnızca inceleme için tutar; bu yüzden WASync, yüklediğiniz örneği şablonun varsayılan dosyası olarak saklar. Bu değişiklikten önce onaylanmış ya da Meta'da oluşturulmuş bir şablon için kartındaki Set default image (veya video, document) seçeneğini kullanın; Change ve Remove de orada. Varsayılan dosya yoksa, gönderen kişi her seferinde dosyayı seçer.

Meta'da oluşturulan şablonlar

WhatsApp Manager'da oluşturduğunuz şablonlar, şablon listesinde Resync from Meta düğmesine tıklayana kadar WASync'te görünmez. Resync, şablonları düğmeleri ve başlığıyla içe aktarır, tüm durumları yeniler ve Meta'da artık bulunmayan bir şablonu Deleted olarak işaretler. İstediğiniz zaman çalıştırmak güvenlidir.

Şablon gönderme

Aşağıdaki üç yöntem de yalnızca Approved şablonları, yalnızca bir WABA numarasından gönderir ve mesaj almayı durdurmak isteyen kişiyi reddeder. Bir müşteri durdurma talebiyle yanıt verirse WASync onu çıkmış (opt-out) olarak işaretler; kişi yeniden iletişime geçilmesini isterse bir yönetici bu işareti kaldırabilir.

Sohbetten

Bir lead, deal veya Smart Process öğesinin WASync sekmesinde ve WASync Chat'te, mesaj kutusunun yanındaki şablon simgesine tıklayın (Send a Meta-approved template). 24 saatlik pencere kapalıysa, uyarıdaki Pick a template düğmesi aynı listeyi açar.

  1. Ada, dile veya metne göre arayın ve bir şablon seçin.
  2. Her değişkeni doldurun. İlk değişken, biliniyorsa kişinin adıyla önceden doldurulur; gerektiği gibi düzenleyin. Önizleme, mesajın son halini gösterir.
  3. Şablonun medya başlığı varsa dosyayı seçin: şablonun varsayılan dosyası (varsa önceden seçilidir) ya da başka bir dosya yükleyin. Dosya seçilene kadar Send devre dışı kalır.
  4. İsterseniz Also ask permission for a WhatsApp call after sending seçeneğini işaretleyin (şablon zaten arama izni istiyorsa gizlenir).
  5. Send düğmesine tıklayın. Mesaj, sohbette ve kaydın zaman çizelgesinde son metniyle birlikte görünür.

Bitrix24 otomasyon kurallarından

Lead, deal veya Smart Process aşamasını açın → Automation rules → Add automation ve WASync grubundan Send WhatsApp Template (WABA) seçeneğini seçin. Kural, o aşamaya ulaşan her kayıt için, her seferinde tek bir kayıtta çalışır.

  • WABA Connection: gönderen numara.
  • Template: yalnızca o numaranın onaylı şablonları listelenir.
  • Variables: her {{n}} için bir satır. Insert Field penceresini açmak için ⋯ düğmesine tıklayıp CRM alanlarını seçin ya da metin yazın. Bir satırda birden fazla alan ve sabit metin birleştirilebilir. Alanlar, kuralın çalıştığı kayıttan okunur.
  • Header image / video / document: medya şablonu için File or link (bir dosya yükleyin ya da bir bağlantı veya bağlantı içeren bir alan yapıştırın) ya da Template's example (WASync'in sakladığı varsayılan dosya) seçeneğini belirleyin.

Alıcı, kaydın müşteri telefonudur. Henüz kişisi olmayan bir deal, WASync vazgeçmeden önce arka planda yeniden kontrol edilir.

Bir şey gönderimi durdurduğunda, neden sessizce başarısız olmak yerine kaydın zaman çizelgesine yazılır: boş çıkan bir değişken, artık onaylı olmayan bir şablon, eksik başlık dosyası, çıkmış bir kişi veya bir lisans sorunu. Meta boş parametreleri reddettiği için boş değişkenler gönderimi durdurur.

WASync'i kurduktan veya güncelledikten sonra otomasyon sayfasını bir kez yeniden yükleyin: Bitrix24, robot tanımlarını sayfa yeniden yüklenene kadar önbellekte tutar.

Chat Flows'tan

Akış düzenleyicisinde bir Message adımında WhatsApp Business template (window closed) adlı bir bölüm bulunur. Numarayı, onaylı bir şablonu seçin, her değişkeni doldurun ({{NAME}} gibi bir CRM alanı ya da sabit metin) ve medya şablonu için başlık dosyasını belirleyin.

Şablon yalnızca numara bir WABA numarasıysa ve 24 saatlik pencere kapalıysa kullanılır; örneğin hiç yazmamış bir müşteriye ilk mesaj. Pencere açıksa adım normal metni gönderir. Pencere kapalıysa ve adımda şablon yoksa adım On a WhatsApp Business number the first message must use an approved template. hatasıyla başarısız olur. Adıma eklenen dosyalar şablonla birlikte gönderilmez. Boş bir değişken, adımı durdurmak yerine bir tire ile değiştirilir. Meta geçici bir hatayla yanıt verirse adım, başarısız olmadan önce bir kez daha dener.

Kapsam dışı olanlar: toplu kampanyalar

WASync'te toplu veya yayın (broadcast) kampanya modülü yoktur: bir liste yükleyip şablonu herkese gönderemezsiniz. WASync'in yaptığı şey, bir otomasyon kuralı çalıştığında CRM kaydı başına bir şablon göndermektir. Bir segmente mesaj göndermek için o lead veya deal'leri bir aşamaya koyun (ya da oraya taşıyın) ve Send WhatsApp Template (WABA) kuralının o aşamada çalışmasına izin verin.

Meta'nın sınırları içinde kalın

  • Her numaranın, kalite seviyesine bağlı bir mesajlaşma limiti vardır (Connections sayfası, Meta'nın atadığı seviyeyi gösterir; örneğin 24 saatte 1.000 müşteri). Limiti aşan gönderimler başarısız olur.
  • Yalnızca sizden haber beklemesi olan kişilere mesaj gönderin. Her engelleme veya şikâyet kalite puanını düşürür; düşük puan limiti düşürür ve kötü geri bildirim alan bir şablon duraklatılabilir.
  • İlk satırda kim olduğunuzu söyleyin ve kişilere nasıl çıkabileceklerini belirtin. Durdurma talebine uyun: WASync, çıkmış kişilere şablon gönderimini engeller.
  • Meta numarayı kısıtladığında veya sınırladığında, Connections sayfası ve Templates penceresi bir uyarı gösterir (Meta has blocked sending on this number veya Meta has limited sending on this number); uyarıda ne yapmanız gerektiği ve Meta Account Quality bağlantısı yer alır.

Sorun giderme

GördüğünüzNe yapmalı
Rejected durumu, kartta bir gerekçeyleMeta'nın gerekçesini okuyun. Sık nedenler: Utility şablonunda tanıtım metni, metnin başında veya sonunda değişken ya da eksik örnekler. Düzeltilmiş şablonu yeni bir adla oluşturun.
Paused durumuMeta şablonu duraklattı; genellikle kötü müşteri geri bildirimi nedeniyle. Metni iyileştirin ya da yeni bir şablon oluşturun. Duraklatılmış bir şablonu göndermeye devam etmeyin.
Meta has blocked / limited sending on this number uyarısıUyarıdaki düğmeyle Meta Account Quality'yi açın ve adımları izleyin: ödeme yöntemi, işletme doğrulaması veya itiraz. Meta kısıtlamayı kaldırana kadar gönderimler ve yeni şablonlar engelli kalır.
Templates penceresinde Access token expired or invalidConnections sayfasında o numara için Connect with Facebook işlemini çalıştırarak token'ı yenileyin.
Gönderirken şablon listede yokYalnızca Approved şablonlar görünür. Durumu kontrol edin, ardından Resync from Meta kullanın.
Oluştururken değişken hatası (isn't a valid variable, needs a CRM field and an example value)Değişkenleri süslü parantezleri elle yazarak değil, + Personalize ile ekleyin ve her birine bir örnek verin. Numaralandırma boşluksuz olarak 1, 2, 3 şeklinde ilerlemelidir.
Robot göndermedi, zaman çizelgesinde empty variable(s) yazıyorBir değişkene eşlenen alan, o kayıtta boştu. Alanı kayıtta doldurun ya da değişkeni başka bir alana veya sabit metne çevirin.
This template has a … header veya gönderim devre dışıMedya şablonunun dosyaya ihtiyacı var. Gönderim sırasında, kuralda veya adımda bir dosya seçin ya da şablonun varsayılan dosyasını belirleyin.
This WhatsApp connection cannot send templatesNumara QR ile eşleştirilmiş. Bir WABA numarası kullanın.
Templates to this contact are blocked: this contact asked to stop receiving messagesKişi çıkış yaptı. Size gönderdiği mesajlara yine de yanıt verebilirsiniz. Bir yönetici, çıkış işaretini yalnızca kişi yeniden iletişime geçilmesini istediyse kaldırabilir.
Bu sayfa yardımcı oldu mu?

On this page