WhatsApp mesaj geçerlilik süresi: doğrulama kodları, hatırlatmalar ve kargo bildirimleri geç ulaşmasın

Bir müşteri uçağa binerken giriş kodu istiyor. Telefon uçak moduna geçiyor ve dört saat sonra, indiğinde WhatsApp on dakika sonra geçersiz olan kodu iletiyor. Başka bir müşteri akşamüstü “kuryeniz 20 dakika içinde kapınızda” mesajı alıyor; oysa paket öğlen komşuya bırakılmıştı. Bir kliniğin “randevunuz bir saat sonra başlıyor” hatırlatması ertesi sabah geliyor.

Bu mesajların hiçbiri gönderildiği anda yanlış değil. Yanlış olan, ulaştıkları an. WhatsApp kapalı ya da çevrimdışı bir telefona mesajı iletmeyi dener ve çoğu şablonda bu denemeyi 30 güne kadar sürdürür. Mesaj geçerlilik süresi (TTL), WhatsApp’a ne zaman bırakacağını söyleyen ayardır.

MonoChat’in şablon oluşturucusu 3.8.46 sürümünden beri bunu, Pazarlama şablonlarında olduğu gibi, Yardımcı (utility) ve Kimlik doğrulama şablonlarında da ayarlamanıza izin veriyor. Bu rehber geçerlilik süresinin nasıl çalıştığını, her kategorinin varsayılanlarını ve sınırlarını, hangi mesaja hangi değerin uyduğunu ve nasıl ayarlanacağını anlatıyor.

WhatsApp bir mesajı nasıl yeniden dener?

Bir şablon mesaj gönderdiğinizde WhatsApp önce onu müşterinin telefonuna iletmeye çalışır. Telefon kapalıysa, bağlantısı yoksa ya da bir süredir çevrimdışıysa mesaj WhatsApp tarafında bekler ve WhatsApp yeniden dener. Meta bu deneme süresine mesajın geçerlilik süresi (time-to-live) der.

Süre dolduğunda iki şey olur:

• Mesaj düşürülür. Meta’nın dokümantasyonuna göre sistem, varsayılan ya da özel geçerlilik süresi içinde iletilemeyen mesajları düşürür. Müşteri onu hiç görmez.
• Teslim edildi durumu gelmez. Meta’nın önerisi basit: geçerlilik süresi bitmeden teslim edildi webhook’u gelmediyse mesajın düşürüldüğünü varsayın.

Varsayılan deneme süresi uzundur, çünkü çoğu mesaj günler sonra da işe yarar: makbuz, ekstre, bülten. Bu rehberin konusu, işe yaramayanlar.

Kategoriye göre varsayılanlar ve sınırlar

Meta geçerlilik süresini şablon başına belirler ve izin verilen aralık şablonun kategorisine göre değişir:

Kategori	Varsayılan	Ayarlayabileceğiniz aralık	MonoChat’te (saniye)
Kimlik doğrulama	10 dakika (23 Ekim 2024’ten önce oluşturulan şablonlarda 30 gün)	30 saniye ile 15 dakika	30 ile 900
Utility	30 gün	30 saniye ile 12 saat	30 ile 43200
Pazarlama	30 gün	12 saat ile 30 gün	43200 ile 2592000, Marketing Messages API’ye bağlanmış hesapta

Gözden kaçması kolay üç ayrıntı:

• Eski kimlik doğrulama şablonları 30 gün kalır. Doğrulama şablonunuz 23 Ekim 2024’ten önce oluşturulduysa ve hiç süre girmediyseniz, kod haftalar sonra bile ulaşabilir. Bir değer girmek bunu çözer.
• Utility’de kısa bir varsayılan yoktur. Geçerlilik süresi girilmemiş bir teslimat güncellemesi, bir bülten kadar, 30 gün boyunca yeniden denenir.
• Kategori değişince değer silinir. Meta bir şablonu başka kategoriye taşıdığında geçerlilik süresini siler ve şablon, o kategorinin aralığında yeni bir değer girene kadar yeni kategorinin varsayılanına döner.

Hangi mesaja hangi süre uyar?

Geçerlilik süresini, müşterinin mesajı okumasını istediğiniz ana göre değil, mesajın doğru ya da yararlı olmaktan çıktığı ana göre ayarlayın. Bazı başlangıç noktaları:

Mesaj	Kategori	Önerilen süre	Neden
10 dakika geçerli giriş veya doğrulama kodu	Kimlik doğrulama	En fazla 600 saniye	Meta, sürenin kodun geçerliliğine eşit ya da ondan kısa olmasını önerir
5 dakika geçerli ödeme onay kodu	Kimlik doğrulama	300 saniye	Süresi dolduktan sonra gelen kod yalnızca destek talebi doğurur
”Kuryeniz yaklaşık 30 dakika içinde kapınızda”	Utility	1800 saniye	Sonrasında kurye ya gelmiştir ya da gitmiştir
”Masanız hazır” veya “siparişiniz teslim almaya hazır”	Utility	1800 ile 3600 saniye	Müşteri yakındayken işe yarar
Randevudan 3 saat önce giden hatırlatma	Utility	10800 saniye	Randevu saatinden sonra düşürülmesi kafa karıştırıcı bir mesajı önler
Aynı gün teslimat aralığı onayı	Utility	21600 ile 43200 saniye	Akşama doğru aralık bitmiş olur
Sipariş onayı, makbuz, fatura	Utility	Boş bırakın	Günler sonra da işe yarar
48 saatlik flaş indirim	Pazarlama	172800 saniye	Teklif, indirimle birlikte biter

İki pratik kural:

• Geç gelmesi sorun değilse boş bırakın. Yarın ulaşan bir makbuz, hiç ulaşmayandan iyidir. Mutlaka ulaşması gereken mesajlara kısa süre koymayın.
• Geç gelmesi hiç gelmemesinden kötüyse yedek planı yapın. Düşen bir kod, uygulamanızda “kodu yeniden gönder”e; düşen bir “kurye yakında” mesajı, kuryenin aramasına yönlendirebilir. Bunu, süreyi kısaltmadan önce kararlaştırın.

MonoChat’te nasıl ayarlanır?

WhatsApp Business (Cloud) kanalı olarak bağlı bir WhatsApp numarasına ihtiyacınız var.

1. Şablonları açın. Ayarlar › Sohbet › Kanallar sayfasına gidin, kanalın ⋮ menüsünü açın ve Şablon Mesajlar’ı seçin.

2. Şablonu oluşturun. Oluştur’a tıklayın ve kategoriyi seçin: güncellemeler için Yardımcı, kodlar için Kimlik doğrulama. Kod için Tek kullanımlık şifre türünü; güncelleme için Standart’ı ya da Meta’nın hazır utility şablonlarından birinden başlamak için Meta kütüphanesinden’i seçin (şablon kütüphanesi rehberimize bakın).

3. Geçerlilik süresini girin. Ad ve dilin altındaki Mesaj geçerlilik süresi (saniye) alanını doldurun. MonoChat aralığı siz yazarken kontrol eder; sayı aralığın dışındaysa Yardımcı için “30 ile 43200 saniye arasında bir değer girin”, Kimlik doğrulama için “30 ile 900 saniye arasında bir değer girin” uyarısını gösterir. WhatsApp’ın varsayılanını korumak için boş bırakın.

4. Kodlarda geçerlilikle eşleştirin. Tek kullanımlık şifre şablonunda Kodun geçerlilik süresi (dakika, 1–90) alanı 1 ile 90 dakika arasında değer alır. Geçerlilik süresini buna eşit ya da daha kısa yapın. 10 dakika geçerli bir kod için 600 saniyelik süre, kodun çalışmayı bıraktıktan sonra hiç ulaşmamasını sağlar.

5. Gönderin. Mesajı, butonları ve örnekleri her zamanki gibi tamamlayın (WhatsApp şablon mesajı nasıl oluşturulur rehberimiz her alanı anlatıyor) ve incelemeye gönderin. Geçerlilik süresi şablonla birlikte gider: o şablondan sohbetten, bir akıştan, toplu mesajdan ya da kendi sisteminizden gönderilen her mesaj aynı değeri kullanır.

Pazarlama şablonlarında aynı alan yalnızca WhatsApp Business Hesabınız Meta’nın Marketing Messages API’sine bağlanmışsa görünür; MonoChat bunu kendisi algılar. Buradaki aralık 43200 ile 2592000 saniyedir.

Örnek: bir diş kliniğinin aynı gün mesajları

İzmir’deki bir diş kliniği, randevu takvimine bağlı bir MonoChat akışından üç tür WhatsApp mesajı gönderiyor:

• Randevu onayı (Utility, geçerlilik süresi yok). Hasta ertesi gün okusa da işe yarar.
• Üç saat önceki hatırlatma (Utility, 10800 saniye). Hastanın telefonu sabah boyunca kapalıysa hatırlatma, randevu başladıktan sonra gelmek yerine düşürülür.
• “Doktorumuz 20 dakika gecikecek” (Utility, 1200 saniye). Yalnızca önümüzdeki yirmi dakika için doğru.

Akış her birini Şablon Mesaj Gönder düğümüyle gönderir. Hasta “saat 17.00’ye alabilir miyiz?” diye yanıtladığında yanıt 24 saatlik müşteri hizmetleri penceresini açar ve ekip gelen kutusuna düşer; orada resepsiyonist serbest metinle yanıtlar.

Kliniğin zamanlama umurunda olmasaydı onay da hatırlatmayla aynı şablonu paylaşabilirdi. Geçerlilik süresi şablon başına ayarlandığı için farklı ömürlere ihtiyaç duyan mesajlar ayrı şablon ister.

Maliyeti nedir?

Meta, teslim edilen her mesajdan, şablonun kategorisinin ve alıcının ülkesinin oranı üzerinden ücret alır. Fiyatlandırma sayfasına göre işletmeler yalnızca mesaj teslim edildiğinde ücretlendirilir; dolayısıyla geçerlilik süresinin sonunda düşürülen mesaj ücretlendirilmez. Süreyi kısaltmak hiçbir zaman daha pahalıya gelmez; olsa olsa yardımı dokunmayacak kadar geç ulaşacak bir mesajın ücretinden tasarruf sağlar. Meta işletmenize doğrudan fatura keser; resmi bir Meta Business Partner olan MonoChat komisyon eklemez. Bir kampanyanın maliyetini toplu mesaj maliyet hesaplayıcısıyla tahmin edin.

Kontrol listesi

• Mesajı belli bir süre sonra doğru olmaktan çıkan her şablonu listeleyin: kodlar, “yolda”, “hazır”, aynı gün hatırlatmaları, flaş indirimler
• Kimlik doğrulama şablonları: geçerlilik süresi Kodun geçerlilik süresi’ne eşit ya da ondan kısa
• 23 Ekim 2024’ten önce oluşturulan kimlik doğrulama şablonları: bir değer girin, yoksa 30 gün kalırlar
• Zamana bağlı utility güncellemeleri: güncelleme doğru olmaktan çıktığında biten bir geçerlilik süresi
• Makbuz, onay ve faturalar: boş bırakılmış
• Farklı ömürlere ihtiyaç duyan mesajlar için ayrı şablonlar
• Düşen mesajlar için yedek plan: uygulamada yeniden gönderme, bir arama, müşteri yazdığında yeni bir mesaj
• Meta bir şablonu yeniden kategorilendirdikten sonra: geçerlilik süresini yeniden girin

Kaynaklar

• Meta for Developers: Configure message time-to-live (yeniden denemeler, kategoriye göre varsayılanlar ve aralıklar, düşürülen mesajlar, teslim edildi webhook’u, kimlik doğrulama önerisi, yeniden kategorilendirme; 6 Kasım 2026’da açıldı)
• Meta for Developers: Pricing on the WhatsApp Business Platform (“Businesses are only charged when a message is delivered”; 6 Kasım 2026’da açıldı)
• MonoChat yardım merkezi: Şablon Mesajlar (Mesaj geçerlilik süresi alanı ve aralıkları, Tek kullanımlık şifre kod geçerliliği, Marketing Messages API; 6 Kasım 2026’da açıldı)
• MonoChat değişiklik günlüğü 3.8.46 (Utility ve Kimlik doğrulama şablonları için mesaj geçerlilik süresi; 6 Kasım 2026’da açıldı)