Mesaj Teslim Edildi mi? Webhook Durum Raporlarını Okumak

API üzerinden bir mesaj gönderdiğinizde aldığınız yanıt, mesajın müşteriye ulaştığı anlamına gelmez; yalnızca isteğin kabul edildiğini söyler. Gerçek hikâye webhook'lardan gelen durum bildirimlerinde yazılıdır. Bu bildirimleri kaydetmeyen bir kurulum, yüzlerce mesajın sessizce düştüğünü fark etmeden haftalarca çalışabilir.

Dört Temel Durum

Okundu bilgisinin gelmemesi mesajın okunmadığı anlamına gelmez; kullanıcı okundu bildirimini kapatmış olabilir. Bu yüzden 'okunma oranı' metriğini tek başına performans ölçütü yapmak yanıltıcıdır.

Sessiz Kayıpların Kaynağı

• Numara WhatsApp kullanmıyor ya da numara biçimi hatalı: uluslararası biçime çevrilmemiş kayıtlar en sık nedendir.
• Kullanıcı işletmeyi engellemiş: mesaj kabul edilir ama iletilmez.
• 24 saatlik pencere kapalıyken serbest metin gönderme denemesi: istek reddedilir.
• Şablon durumu değişmiş: onaylı sandığınız şablon duraklatılmış olabilir.
• Günlük gönderim limiti dolmuş: kalan mesajlar reddedilir.
• Webhook ucunuz hata döndürüyor: bildirim tekrar denenir, kalıcı hata hâlinde bildirimler kaybolabilir.

Son madde en tehlikelisidir çünkü sizin tarafınızdadır ve dışarıdan görünmez: sistem çalışıyor gibi görünürken durum bilgisi hiç işlenmez.

Webhook Ucunda Uyulması Gereken Kurallar

• Hızlı yanıt verin: bildirimi alır almaz kuyruğa yazın ve başarı yanıtı dönün; işlemeyi arka planda yapın.
• İmzayı doğrulayın: gelen isteğin gerçekten platformdan geldiğini doğrulamadan işlemeyin.
• Yinelenen bildirimlere hazırlıklı olun: aynı durum birden fazla kez gelebilir, kayıtlar mesaj kimliğine göre tekilleştirilmelidir.
• Sıralamaya güvenmeyin: okundu bildirimi, iletildi bildiriminden önce ulaşabilir; durum geçişlerini zaman damgasına göre değerlendirin.
• Hata kodunu saklayın: yalnızca 'başarısız' yazmak yetmez, sebep kodu olmadan düzeltme yapılamaz.

Başarısız Mesajda Yeniden Deneme

Her hata yeniden denemeyi hak etmez. Geçici bir altyapı hatası tekrar denenebilir; ancak numara geçersizse, kullanıcı engellemişse veya pencere kapalıysa aynı mesajı tekrar göndermek yalnızca kalite puanınıza zarar verir. Pratik kural şudur: geçici hatalarda artan aralıklarla en fazla iki üç deneme, kalıcı hatalarda hiç deneme yapmayın ve kaydı işaretleyip operasyona düşürün. Kalite ve limit mekaniğini mesaj kalite puanı ve gönderim limitleri yazısında ele almıştık.

İzlenecek Göstergeler

• Gönderilen mesajlara oranla iletilen mesaj yüzdesi — ani düşüş, numara listesi veya limit sorununa işaret eder.
• Hata kodlarının dağılımı ve en sık üç kod.
• Şablon bazında teslimat oranı — belirli bir şablonda düşüş, o şablonun duraklatıldığını gösterebilir.
• Webhook işleme gecikmesi: bildirimden kayda geçme süresi.
• İşlenemeyen bildirim sayısı; sıfırdan farklıysa nedeni bulunmalıdır.

Uyarı Kurmak

Bu göstergeleri panelde görmek yetmez; kimse panele sürekli bakmaz. En az iki uyarı tanımlayın: teslimat oranı belirlediğiniz eşiğin altına düştüğünde ve webhook işleme hataları arka arkaya tekrarladığında haber verilsin. Kampanya ve yoğun günlerde bu uyarılar, sorunu saatler yerine dakikalar içinde fark etmenizi sağlar; yoğunluk hazırlığını kampanya günü mesaj yoğunluğu yazısında anlattık.

Müşteri Tarafına Yansıması

Teslimat verisi yalnızca teknik bir kayıt değildir, operasyonel karar üretir. İletilemeyen bir randevu hatırlatması, müşterinin randevuyu unutması demektir; bu durumda sistem alternatif kanala (SMS veya arama) düşecek şekilde kurgulanmalıdır. Aynı şekilde teslim edilememiş sipariş bildirimleri, çağrı merkezine düşecek işi önceden haber verir. Randevu hatırlatma ritmini randevu hatırlatma ve iptal azaltma yazısında ele almıştık.

BozLat AI ile

BozLat AI kurulumunda teslimat bildirimleri kaydedilir, hata kodlarına göre sınıflandırılır ve kalıcı hatalar operasyon listesine düşer; kritik bildirimlerde alternatif kanala geçiş kurgulanabilir. Teknik kurulum kapsamı için fiyatlar sayfasına, API temelleri için WhatsApp Business API nedir yazısına bakabilirsiniz.