İşlemsel webhook'lar

Webhook'lar, bir işlemsel e-posta gönderildikten sonra başına bir şey geldiğinde uygulamanızın gerçek zamanlı bildirimler almasını sağlar. Teslimat durumunu kontrol etmek için API'yi sürekli sorgulamak yerine, Flexmail bir olay gerçekleştiği anda uç noktanıza bir HTTP POST isteği gönderir.

Bu, işlemsel e-postalar için özellikle değerlidir: bir şifre sıfırlama e-postası geri döndüğünde, bir sipariş onayı teslim edildiğinde veya bir alıcı bir mesajı spam olarak bildirdiğinde hemen harekete geçebilirsiniz.


Webhook olayları

Flexmail, aşağıdaki olayların her biri için bir webhook bildirimi gönderir:

  • Gönderildi (Sent) — mesaj kabul edildi ve alıcı posta sunucusuna iletildi.
  • Teslim edildi (Delivered) — alıcı posta sunucusu, alıcının posta kutusuna teslimatı onayladı.
  • Geri döndü (Bounced) — teslimat başarısız oldu. Kalıcı geri dönmeler (hard bounce) kalıcı bir sorunu (adres mevcut değil); geçici geri dönmeler (soft bounce) ise geçici bir sorunu (posta kutusu dolu, sunucu kullanılamıyor) gösterir.
  • Açıldı (Opened) — alıcı mesajı açtı.
  • Tıklandı (Clicked) — alıcı mesajdaki takip edilen bir bağlantıya tıkladı.
  • Şikâyet edildi (Complained) — alıcı mesajı spam olarak işaretledi.

Not

Açılma ve tıklama takibi, izleme piksellerinin ve bağlantı sarmalamanın etkinleştirilmesini gerektirir. Teslim edildi olayları, alıcı posta sunucusunun teslimatı onaylamasına bağlıdır; tüm sunucular bunu yapmaz.


Webhook uç noktası ayarlama

Webhook uç noktanız, sunucunuzda HTTP POST isteklerini kabul eden ve alındığını onaylamak için 200 yanıtı döndüren bir URL'dir.

Uç noktanız için gereksinimler

  • HTTP POST isteklerini kabul eder.
  • HTTPS üzerinden herkese açık olarak erişilebilir.
  • Alındığını onaylamak için makul bir zaman aşımı süresi içinde 2xx HTTP durum kodu döndürür.
  • İşleme mantığınız yavaşsa yükü eşzamansız olarak işler: zaman aşımlarını önlemek için hemen yanıt verin ve işlemi arka planda yapın.

Uç noktanızı Flexmail'e kaydetme

Webhook uç noktası yapılandırması API üzerinden yapılır. Kayıt sürecinin tamamı ve kullanılabilir seçenekler, email-api.flexmail.eu/documentation adresindeki API belgelerinde, Webhooks bölümünde açıklanmıştır.


Webhook yükü (payload)

Her webhook bildirimi, JSON gövdeli bir HTTP POST isteğidir. Yük; olay türünü, bir zaman damgasını, mesaj kimliğini ve alıcının e-posta adresini içerir. Olaya bağlı olarak ek alanlar da eklenir; örneğin bir geri dönme olayı geri dönme türünü ve nedenini, bir tıklama olayı ise tıklanan URL'yi içerir.

Tipik bir yük şöyle görünür:

{ "event": "delivered", "timestamp": "2024-11-15T09:32:00Z", "messageId": "abc123", "recipient": "customer@example.com" }

Her olay türü için yükün tam spesifikasyonu API belgelerinde yer alır.


Webhook olaylarıyla ne yapmalısınız

Geri dönen e-postalar

Bir kalıcı geri dönme olayı aldığınızda, o e-posta adresini sisteminizde işaretleyin. Bu adrese göndermeyi durdurun ve adresin doğru girilip girilmediğini araştırın. Kalıcı olarak geri dönen adreslere göndermeye devam etmek gönderen itibarınıza zarar verir.

Spam şikâyetleri

Bir alıcı bir işlemsel e-postayı spam olarak işaretlediğinde, o adresi hemen gönderim dışı bırakın. E-posta gerçekten işlemsel olsa bile (örneğin bir sipariş onayı), alıcı sizden e-posta almak istemediğinin sinyalini vermiştir. Göndermeye devam etmek hem itibarınıza zarar verir hem de potansiyel olarak hukuki bir sorun oluşturur.

Teslimat onayları

Şifre sıfırlama veya iki faktörlü kimlik doğrulama kodları gibi zamana duyarlı mesajlar için, e-postanın gelen kutusuna ulaştığını doğrulamak üzere teslim edildi olayını kullanabilirsiniz. Makul bir süre içinde teslimat onayı gelmezse, kullanıcı arayüzünüzde kullanıcıya spam klasörünü kontrol etmesini veya tekrar denemesini öneren bir mesaj gösterebilirsiniz.

İpucu

Webhook isteklerini hemen 200 yanıtıyla onaylayın, ardından yükü bir arka plan işinde veya kuyrukta işleyin. İşleyiciniz yanıt vermek için çok uzun sürerse Flexmail zaman aşımına uğrayıp isteği yeniden deneyebilir; bu da yinelenen işlemeye yol açabilir.


Yeniden denemeler

Uç noktanız başarılı bir yanıt döndürmezse, Flexmail webhook bildirimini yeniden dener. Olay işlemenizi idempotent hâle getirin: aynı olayı iki kez işlemek, bir kez işlemekle aynı sonucu vermelidir. Yinelenenleri ayıklamak için mesaj kimliğini ve olay türünü birlikte kullanın.


Sonraki adımlar

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.