Webhook vs E-posta Bildirimi: Anlık Uyarılar için Karşılaştırma

Bir sitenin erişilemez hale geldiğini ne kadar erken öğrenirsen, müdahale o kadar erken başlar. Bu yüzden uyarının hangi kanaldan geldiği, izlemenin kendisi kadar önemlidir. E-posta herkesin kullandığı, kurulumu kolay bir kanal; webhook ise veriyi doğrudan kendi sistemine aktaran, geliştirici odaklı bir yöntem. Bu yazıda iki yöntemi karşılaştırıyor ve LLCBullet'te hangi seçeneklerin bulunduğunu anlatıyoruz.

E-posta bildirimi: artıları ve eksileri

E-posta evrenseldir: ek kurulum gerektirmez, arşivlenir ve aranabilir. Rapor ve özet gibi acil olmayan içerikler için hâlâ iyi bir kanaldır. Ancak anlık uyarı için zayıf noktaları vardır:

• Teslim süresi gönderen ve alan sunucuların yüküne, kuyruklara ve filtrelere bağlıdır; garanti edilmez.
• Uyarılar spam ya da promosyon klasörüne düşebilir.
• Yoğun bir gelen kutusunda kritik bir uyarı diğer mesajların arasında kaybolur.
• İnsanlar için tasarlanmıştır; içeriğin başka bir sistem tarafından otomatik işlenmesi zordur.
• Gönderen adresi taklit edilebilir; sahte bir "uyarı" e-postası oltalama için kullanılabilir.

Webhook: artıları ve eksileri

Webhook, bir olay ya da zamanlama tetiklendiğinde verinin senin belirlediğin HTTPS adresine POST isteğiyle gönderilmesidir. Veri yapılandırılmış JSON olarak geldiği için alıcı taraf onu doğrudan işleyebilir.

• Otomasyon: Gelen veriye göre destek kaydı açabilir, iç panonu güncelleyebilir ya da kendi mesajlaşma kanalına yönlendirebilirsin.
• Zengin veri: Tek bir istekte birden fazla sitenin durumu ve yanıt süresi gelebilir.
• Yeniden deneme: İyi tasarlanmış webhook sistemleri başarısız teslimatları tekrar dener.
• Bakım yükü: Alıcı bir uç nokta yazman, onu ayakta tutman ve izlemen gerekir.
• Güvenlik sorumluluğu: Uç noktan herkese açıktır; gelen isteğin gerçekten beklediğin kaynaktan geldiğini imza ile doğrulaman şarttır.

Yan yana karşılaştırma

• Kurulum: E-posta hazırdır; webhook için bir alıcı servis gerekir.
• Hız: E-posta teslimatı dış etkenlere bağlıdır; webhook isteği doğrudan senin sunucuna gelir.
• Otomatik işleme: E-postada zor; webhook'ta doğal.
• Güvenlik: E-posta taklit edilebilir; imzalı webhook doğrulanabilir.
• İnsan okuması: E-posta doğrudan okunur; webhook verisini okunur hale getirmek senin işindir.

LLCBullet'te bildirim seçenekleri

LLCBullet'te bildirimler kategori bazında yönetilir ve üç kanaldan gelir: Telegram, panel ve tarayıcı (web push). Her kategori için kanalları ayrı ayrı açıp kapatabilir, bir kategoriyi 1 saat, 8 saat, 1 gün, 1 hafta ya da süresiz sessize alabilirsin. Güvenlik uyarıları ise sessize alınamaz. Anlık uyarı ihtiyacını çoğu ekip için Telegram kanalı karşılar.

Veriyi kendi sistemine aktarmak için webhook görevi kullanılır. Bu görev olay anında değil, senin belirlediğin zamanlamayla çalışır: seçtiğin altyapıdaki sitelerin son durumlarını, cron ifadesiyle belirlediğin aralıklarla (en sık 5 dakikada bir) kendi HTTPS adresine gönderir. Hangi durumda alarm üreteceğine sen karar verirsin. Örnek bir istek gövdesi şöyle görünür:

{
  "id": "run_1842_1",
  "type": "automation.webhook",
  "task": "tsk_Qm3v8Zr1XkP0aLw7Yt2NcA",
  "scheduledFor": "2026-09-28T06:00:00Z",
  "infrastructure": "digitain",
  "sites": [
    { "id": 101, "name": "ornek-site", "status": "up", "latencyMs": 412 },
    { "id": 102, "name": "diger-site", "status": "down", "latencyMs": null }
  ]
}

Her istek X-LLCBullet-Signature başlığında HMAC-SHA256 imzası taşır. Alıcı tarafta imzayı gövdenin ham baytlarıyla doğrulamalı, eski zaman damgalı istekleri reddetmeli ve hızlıca 2xx yanıt dönmelisin. 2xx dışındaki yanıtlarda ya da zaman aşımında çalıştırma artan bekleme süreleriyle yeniden denenir; tüm denemeler başarısız olursa "Otomasyon görevi başarısız" bildirimi alırsın. Adım adım doğrulama kodu webhook ve imza doğrulama rehberinde.

Alıcı uç noktayı tasarlamak

Webhook'un güvenilirliği büyük ölçüde alıcı tarafın nasıl yazıldığına bağlıdır. Sağlam bir alıcı servis için şu sırayı izle:

1. İsteğin ham gövdesini al ve JSON'a çevirmeden önce imzayı doğrula.
2. Zaman damgası çok eskiyse isteği reddet; bu, yakalanmış bir isteğin sonradan tekrar gönderilmesini engeller.
3. İsteği bir kuyruğa yaz ve hemen 2xx yanıt dön; asıl işlemeyi arka planda yap.
4. Aynı çalıştırmanın tekrarlarını ayıklamak için task ve scheduledFor alanlarını birlikte kullan.
5. Gizli anahtarı kaynak koduna değil, ortam değişkenine ya da gizli değer yöneticisine koy.

E-posta hâlâ ne zaman doğru seçim?

E-posta anlık uyarı için zayıf olsa da kayıt tutmak ve paydaşlarla paylaşmak için değerlidir. Haftalık özetler, olay sonrası raporlar ve iş ortaklarına yapılan resmi bildirimler için hâlâ uygun bir kanal. Önemli olan, kritik bir uyarının tek kanalının e-posta olmamasıdır. LLCBullet'te de bildirimler e-posta yerine Telegram, panel ve tarayıcı kanallarından gelir; düzenli özet ihtiyacını rapor görevi karşılar.

Sık yapılan hatalar

• Webhook uç noktasında imza doğrulamasını "sonra ekleriz" diye atlamak.
• Uyarıları yalnızca tek bir kişinin gelen kutusuna ya da telefonuna yönlendirmek.
• Tüm bildirim kategorilerini aynı kanala açıp önemli olanı gürültüde kaybetmek.
• Başarısız teslimat bildirimlerini izlememek ve entegrasyonun sessizce durduğunu geç fark etmek.

Hangisini seçmeli?

• Ekibin Telegram'daysa: Anlık uyarılar için Telegram kanalını açık tut; ek kurulum gerekmez.
• Masa başındaysan: Panel ve tarayıcı bildirimleri, sekme açıkken hızlı fark etmeni sağlar.
• Kendi sistemlerin varsa: Webhook görevini kur ve veriyi kendi izleme ya da olay yönetimi akışına aktar.
• Özet için: Rapor görevi günlük ya da haftalık özetini Telegram'a gönderir.

Kanal seçimini ve kategori ayarlarını adım adım anlattığımız bildirim yapılandırma rehberine göz atabilirsin. Site durumlarının ne sıklıkla kontrol edileceğini belirlemek için de site erişilebilirlik kontrolü rehberi iyi bir başlangıç noktası.