WhatsApp şablonları ve 24 saat penceresi

Bu rehberde: WhatsApp'ta ne zaman serbest mesaj, ne zaman onaylı şablon gönderebileceğinizi öğrenirsiniz. Şablon oluşturur ve OrqLabs'ta kullanırsınız. Bu kuralları bilmek 131047 hatasını ve kalite düşüşünü önler.

⏱ 15 dakika

24 saat penceresi#

Müşteri size yazdığında 24 saatlik bir pencere açılır. Bu sürede serbest metin, medya ve düğmeli mesaj gönderebilirsiniz. Müşterinin her yeni mesajı pencereyi 24 saat uzatır.

Pencere kapandığında yalnızca onaylı şablon gönderebilirsiniz. Müşteri şablona yanıt verirse pencere yeniden açılır.

Mesaj gönder kutusu pencereyi bilir: açıksa metni, kapalıysa şablonu kullanır. Şablon tanımlı değilse hata verir.

Gelen Kutusu'nda şablon seçici yoktur: pencere kapalıyken yazdığınız serbest metin gönderilemez, mesaj "24 saat penceresi kapalı" hatasıyla başarısız olarak işaretlenir. Müşteriye pencere dışında ulaşmak için şablonlu bir Mesaj gönder kutusu veya kampanya kullanın.

Şablon kategorileri#

Meta kategoriyi otomatik değerlendirir; "%20 indirim" içeren Utility şablonu Marketing'e çevrilir. Outreach ve toplu mesajlar Marketing'dir ve alıcının açık onayı gerekir.

Şablon oluşturma (WhatsApp Manager)#

1. business.facebook.com → WhatsApp Manager → Account tools → Message templates → Create template.
2. Category: Marketing / Utility / Authentication.
3. Name: küçük harf ve alt çizgi (first_touch_b2b, appointment_reminder). Bu ad OrqLabs'ta kullanılır.
4. Language: Turkish (tr). Dil belirtmediğiniz şablon mesajlarında OrqLabs projenizin dilini (proje dili yoksa tr) gönderir; şablonu farklı bir dilde onayladıysanız dil kodunu ilgili alana yazın.
5. Header (isteğe bağlı): metin, görsel, video, belge.
6. Body: metin ve değişkenler {{1}}, {{2}}. Örnek: "Merhaba {{1}}, {{2}} için randevunuz {{3}} tarihinde. Değişiklik için bu mesajı yanıtlayın."
7. Footer (isteğe bağlı): "İptal için DUR yazın".
8. Buttons: hızlı yanıt (en fazla 3), bağlantı, telefon; Marketing için opt-out düğmesi önerilir.
9. Samples: her değişken için örnek değer (zorunlu).
10. Submit. Durumlar: bekliyor → onaylandı (dakikalar–24 saat) / reddedildi / duraklatıldı / kapatıldı.

Onaylı şablonların adını ve dilini WhatsApp Manager'daki listeden alın; OrqLabs şablon listesini Meta'dan çekmez, adı alanlara siz yazarsınız.

OrqLabs'ta şablon kullanımı#

Mesaj gönder kutusu#

channel: WHATSAPP
to: {{ $json.phone }}
templateName: appointment_reminder
templateParams: ["{{ $json.name }}", "{{ $json.service }}", "{{ $date($json.appointmentAt, "DD.MM.YYYY HH:mm") }}"]
templateLanguage: tr        # boşsa projenin dili

Şablon alanları yalnızca kanal WhatsApp seçilince görünür. Parametre sayısı şablondaki {{n}} sayısıyla birebir eşleşmeli.

Kampanyalar#

Kampanyalar → Yeni kampanya sihirbazında kanal WhatsApp ise Mesaj adımında Onaylı WhatsApp şablonu bölümü çıkar: Şablon adı, Dil kodu (boşsa projenin dili) ve Şablon değişkenleri (her satır sırayla {{1}}, {{2}}…; {{ firstName }}, {{ company }} gibi alanlar kişiye göre doldurulur). Şablon adı girilen adımlar her adaya bu şablonla gönderilir; böylece müşterinin size hiç yazmadığı veya 24 saatten uzun süredir yazmadığı durumlarda da mesaj teslim edilir. Takip adımlarının her biri kendi şablon adını ve değişkenlerini alır (dil ilk mesajınkiyle aynıdır). Mesaj metni kampanya ekranında ve Gelen Kutusu'nda görünen metindir; alıcıya şablonun onaylı metni gider.

Toplu mesaj kutusu#

Template alanına şablon adını değil metnini yazarsınız. Pratik yol: Alan ayarla ile öğeye templateName ve templateParams ekleyip toplu mesaja bağlayın.

Ajanlar#

• AI Chatbot: yalnızca pencere içinde yanıt verir.
• Outreach Agent (whatsapp): ilk temas için görevde şablon adını belirtin: "first_touch_b2b şablonunu kullan; parametreler: ad, şirket, teklif." Yanıt gelince serbest metinle devam eder.

İngilizce şablon için Mesaj gönder kutusunda Şablon dili alanına en (veya şablonun onaylandığı kodu, ör. en_US) yazın.

Onay (opt-in)#

Meta, Marketing şablonu ve ilk temas için açık onay ister: web formu kutucuğu, sohbette "evet", mağazada QR. Onayı aday kaydında saklayın (tags: ["wa_optin"], custom.optInAt, custom.optInSource). Toplu mesaj segmentine wa_optin etiketi filtresini ekleyin. Türkiye'de ayrıca İYS kaydı gerekir; bkz. Broadcast kampanyaları ve izin.

Kalite puanı ve limitler#

• WhatsApp Manager → Phone numbers → Quality rating: yeşil / sarı / kırmızı. Engelleme ve şikâyet puanı düşürür.
• Kırmızıda mesajlaşma katmanı düşer; şablonlar duraklatılabilir.
• Katmanlar: doğrulanmamış 250 → 1K → 10K → 100K → sınırsız benzersiz alıcı / 24 saat.
• Çok şikâyet alan şablon otomatik duraklatılır.
• Bağlantıyı test et kalite puanını gösterir.

Ücretlendirme#

Meta, şablonları mesaj başına ücretlendirir; müşteri başlattığı konuşmalar belirli koşullarda ücretsizdir. Türkiye fiyatları Meta fiyat listesindedir. OrqLabs yalnızca yapay zekâ maliyetini ölçer; WhatsApp ücretleri Meta faturanızda görünür.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Müşterime kampanya duyurusu atabilir miyim? Evet, onaylı Marketing şablonuyla ve müşterinin açık onayı varsa.

Şablon onayı ne kadar sürer? Genellikle dakikalar; en fazla 24 saat.

Chatbot pencere dışında yanıt verebilir mi? Hayır. Chatbot yalnızca müşteri yazdığında (pencere açıkken) yanıt verir.

Sonraki adım#

• WhatsApp Business (Cloud API)
• Broadcast kampanyaları ve izin yönetimi
• Outreach Agent