Etkinlikler ve web kancaları
Web kancalarını bağlama
Entegrasyon ayarlarınızda web kancalarının alınacağı adresi belirtin. Yeni mektuplar, posta kutularının durumu ve operasyon sonuçları hakkında bildirimler alacak.
Entegrasyon ayarlarında ayrı bir webhook sırrı ayarlayın ve dağıtımı etkinleştirin. Bu sır, bildirim imzalarını doğrulamak için kullanılır; mail API-key bunun için uygun değil.
Bildirim Formatı
Bildirim HTTP POST- isteği ile birlikte gelir Content-Type: application/json. Alan event olay türünü içerir, timestamp — bildirim zamanı, data — olay verileri. data'nin bileşimi olaya bağlıdır.
data.event_id tanımlayıcısı yeniden teslimatı tanımanıza olanak tanır. Entegrasyon kimliğinizle birlikte saklayın ve bir olayı yalnızca bir kez işleyin.
{ "event": "mail.message.received", "timestamp": "2026-11-01T12:00:00Z", "data": { "event_id": "00000000-0000-4000-8000-000000000001", "created_at": "2026-11-01T12:00:00Z", "mailbox_id": 42, "folder": "INBOX", "uidvalidity": 123456, "uid": 120 }}Doğrulama ve onay
X-Webhook-Signature başlığı, küçük harfli onaltılık gösterimde HMAC-SHA256 içeriyor. İmzayı, istek gövdesinin orijinal baytlarından ve webhook sırrından hesaplayın. Verileri işlemeden önce imzayı kontrol edin; JSON'nin yeniden serileştirilmesi, imzalanan baytları değiştirecektir.
İmzayı doğruladıktan ve olayı kaydettikten sonra HTTP 200 veya 201'i döndürün. 202 ve 204 numaralı yanıtlar alındığını bildirmiyor. 10 saniye içinde yanıt verin; Olayı kaydettikten sonra uzun bir işlem gerçekleştirin.
Bildirimler tekrar tekrar ve düzensiz gelebilir. Abonelik durumunu değiştirmeden önce mevcut ayrıntılarını kontrol edin. Teslimat geçmişi entegrasyon ayarlarında mevcuttur.
Hangi olaylar meydana gelir
mailbox.created- Kutu oluşturulur ve kullanıma hazırdır.
mailbox.expiring- Kutunun ücretli döneminin sonu yaklaşıyor.
mailbox.renewed- Kutunun ödeme süresi uzatıldı.
mailbox.suspended- Posta kutusuna erişim askıya alındı: okuma ve gönderme kullanılamıyor.
mailbox.resumed- Posta kutusuna erişim yeniden sağlandı.
mailbox.deleting_soon- Ödenmemiş kutunun silinmesine bir saat kaldı.
mailbox.deleted- Kutu silindi.
mailbox.account_changed- Posta kutusu başka bir posta hesabına bağlı.
mail.message.received- Posta kutusunda yeni bir gelen mektup belirdi.
mail.operation.succeeded- Operasyon başarıyla tamamlandı. Gönderim için bu, mektubun alıcının gelen kutusuna teslim edilmesi yerine posta sunucusu tarafından kabul edilmesi anlamına gelir.
mail.operation.failed- İşlem başarısız oldu.
mail.operation.uncertain- Gönderim sonucu bilinmiyor. Lütfen yeniden göndermeden önce durumu kontrol edin.
Ödeme hatırlatmaları: 14, 7, 3, 2, 1 gün ve vade bitiminden bir saat önce. Yenileme, henüz gönderilmemiş, süresi geçmiş hatırlatıcıları iptal eder.