Abonelik İptali Webhook'u (Kendi Sisteminize Bildirim)

Bir alıcı toplu e-postanızdan abonelikten çıktığında, bunu kendi sisteminize (CRM, web sitesi vb.) anlık olarak iletebiliriz. Böylece kendi listenizi de güncel tutarsınız. Bu özellik isteğe bağlıdır: tanımlamazsanız abonelikten çıkma yine tam olarak çalışır, yalnızca size ayrıca bildirim gönderilmez.

Nerede

Mail Marketing → Webhook sekmesi. Bu ayar hesabınız geneli içindir; proje veya kampanya seçmenize gerek yoktur.

Kurulum

1. Webhook URL: bildirimlerin gönderileceği https adresiniz.
2. Aktif: bildirimi açar/kapatır.
3. Secret (isteğe bağlı): imza doğrulaması için gizli bir anahtar. Girerseniz gönderdiğimiz her isteği bu anahtarla imzalarız. Kayıtlı bir secret varsa alan boş gösterilir; boş bırakırsanız mevcut secret korunur.
4. Kaydet.

Güvenlik: Yalnızca herkese açık bir https adresi kabul edilir. İç ağ / özel adresler (ör. 127.0.0.1, 10.x, 192.168.x, metadata adresleri) güvenlik nedeniyle reddedilir.

Size gelen bildirim

Her abonelikten çıkışta, tanımladığınız adrese aşağıdaki gibi bir POST isteği gönderilir:

POST <sizin-webhook-adresiniz>
Content-Type: application/json
X-Mailinu-Signature: sha256=...        (secret tanımlıysa)

{
  "event": "unsubscribe",
  "email": "kisi@ornek.com",
  "campaign_id": "...",
  "domain": "...",
  "source": "...",
  "time": "2026-09-02T10:00:00+00:00"
}

Sisteminiz 2xx (ör. 200) yanıt dönerse teslim başarılı sayılır.

İmza doğrulama (geliştiriciler için)

Bir secret tanımladıysanız, isteğin gerçekten Mailinu'dan geldiğini şöyle doğrularsınız: gelen isteğin ham gövdesinin HMAC-SHA256 özetini secret'ınızla hesaplayın ve X-Mailinu-Signature başlığındaki değerle karşılaştırın; eşitse istek geçerlidir.

Önemli: İmza ham gövde baytları üzerinden hesaplanır. Gövdeyi önce JSON'a çevirip sonra yeniden metne dökerek imzalarsanız baytlar değişir ve imza tutmaz.

Güvenlik notu: Yalnızca 2xx başarılı sayılır, yönlendirmeler (redirect) izlenmez ve istek yalnızca herkese açık adrese gönderilir.