Geri Dönmeler

Bir e-posta teslim edilemediğinde, alıcı sunucu bir geri dönme bildirimi gönderir. MailLand geri dönmeleri sınıflandırır, hiçbir zaman posta kabul etmeyecek adresleri otomatik olarak bastırır ve geçici hataları yeniden dener.

Geri Dönme TürleriBölüm bağlantısını kopyala

Geri Dönme KategorileriBölüm bağlantısını kopyala

Geri dönme dağılımı API'si (GET /v1/deliverability/bounce-breakdown), her geri dönmeyi posta aktarım aracısının (MTA) SMTP reddine kendisinin atadığı sınıflandırmaya göre gruplar, ardından bu sınıflandırmayı kalıcı, geçici veya engellendi olarak eşler. Aşağıdaki tablo, üretimde sabitlenmiş tam kelime dağarcığıdır: sunucunun yaydığı ve bu tabloda yer almayan her şey, tahmin edilmek yerine bilinmeyen olarak sayılır:

Bu sayfanın ilerisinde ele alınan iki uç nokta geri dönmeleri kendi kelime dağarcıklarıyla bildirir. /v1/transactional/bounces/statistics, hardBounces ve softBounces değerlerini adresi bastıran (ya da bastırmayan) kararın kendisinden sayar; bu yüzden engellenmiş bir geri dönme asla kalıcı veya geçici sayılmaz. byCategory ise yukarıdaki sunucu sınıflandırmasını daha kaba bir kümede toplar (invalid_recipient, bad_mailbox, bad_domain, mailbox_full, content_rejected, policy_reason, general_bounce). /v1/transactional/bounces/recent, bounceCategory olarak mesajın sunucu sınıflandırmasının kendisini döndürür.

Otomatik İşlemeBölüm bağlantısını kopyala

Kalıcı geri dönmelerBölüm bağlantısını kopyala

1. Alıcı e-posta adresi anında küresel bastırma listesine eklenir
2. Bu adrese gelecekteki tüm e-postalar (işlemsel ve pazarlama) engellenir
3. bounce_type: "hard" ile bir message.bounced web kancası olayı tetiklenir (ayrı bir suppression.added olayı tetiklenmez)

Geçici geri dönmelerBölüm bağlantısını kopyala

1. İleti durumu Bounced olur
2. Adres, pazarlama postaları için 30 gün boyunca bastırılır (işlemsel postalar yine de teslim edilir): ilk geçici geri dönmede, yeniden denemelerden sonra değil. İstisna: bir adresin ilk MessageExpired geri dönmesi ya da mesajın çok büyük olmasından kaynaklanan ilk geri dönmesi (5.3.4 veya 5.2.3 genişletilmiş koduyla QuotaIssues) hiçbir şeyi bastırmaz; 30 gün içinde bir yenisi her zamanki gibi bastırır.
3. bounce_type: "soft" ile bir message.bounced web kancası olayı tetiklenir. (Geçici hatalar, MailLand'e bir geri dönme bildirilmeden önce MTA'nın kendisi tarafından yeniden denenir.)
4. 30 gün sonra bastırma otomatik olarak sona erer

Engellenen geri dönmelerBölüm bağlantısını kopyala

1. İleti durumu Bounced olarak değişir (AdminBounce için Failed), ancak alıcının adresi hiçbir bastırma listesine eklenmez: engellenen bir geri dönme, alıcının posta kutusu hakkında değil, bizim gönderimimiz hakkında bir beyandır
2. bounce_type: "blocked" ile bir message.bounced web kancası olayı tetiklenir (bir AdminBounce için bunun yerine reason: "admin_bounce" ile bir message.failed olayı)
3. Sürekli bir engellenen geri dönme oranı, manuel inceleme için dahili bir uyarı tetikler; gönderimde otomatik bir duraklama yoktur

Geri Dönme İstatistikleriBölüm bağlantısını kopyala

Bir dönem için toplu geri dönme istatistiklerini alın:

GET https://api.mail.land/v1/transactional/bounces/statistics

Authorization: Bearer <token> veya X-API-Key: <api key> ile kimlik doğrulaması yapın.

curl https://api.mail.land/v1/transactional/bounces/statistics \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "totalBounces": 1125,
  "hardBounces": 450,
  "softBounces": 385,
  "generalBounces": 290,
  "byCategory": {
    "invalid_recipient": 380,
    "mailbox_full": 345,
    "content_rejected": 185,
    "policy_reason": 95,
    "bad_domain": 70,
    "general_bounce": 50
  }
}

Son Geri DönmelerBölüm bağlantısını kopyala

En son geri dönen iletileri alın:

GET https://api.mail.land/v1/transactional/bounces/recent?limit=50

curl "https://api.mail.land/v1/transactional/bounces/recent?limit=50" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "messageId": "t_a1b2c3d4e5f6",
    "recipientEmail": "[email protected]",
    "subject": "Your order has shipped",
    "bounceCategory": "InvalidRecipient",
    "bounceReason": "550 5.1.1 The email account does not exist",
    "bouncedAt": "2026-02-17T12:34:56Z",
    "retryCount": 0
  },
  {
    "messageId": "t_d4e5f6a1b2c3",
    "recipientEmail": "[email protected]",
    "subject": "Invoice #1234",
    "bounceCategory": "QuotaIssues",
    "bounceReason": "552 5.2.2 Mailbox full",
    "bouncedAt": "2026-02-17T11:00:00Z",
    "retryCount": 2
  }
]

Sonuçlar bouncedAt alanına göre azalan sırada sıralanır ve son 90 günle sınırlıdır. bouncedAt, iletinin oluşturulma zamanıdır; ayrıca izlenen bir geri dönme zaman damgası değildir.

Geri Dönen Bir İletiyi Yeniden DeneBölüm bağlantısını kopyala

Geri dönen bir iletinin teslimatını manuel olarak yeniden deneyin:

POST https://api.mail.land/v1/transactional/bounces/{messageId}/retry

curl -X POST https://api.mail.land/v1/transactional/bounces/t_a1b2c3d4e5f6/retry \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Yeniden deneme, özgün içeriği MailLand'in giden kutusu (outbox) üzerinden yeniden gönderir. Yeniden denenen kopyalarda açma ve tıklama izleme KAPALIDIR: özgün gönderimin izleme tercihi ileti kaydından geri alınamaz.

Geri Dönme Oranı EşikleriBölüm bağlantısını kopyala

Eşikler plan varsayılanlarıdır ve yalnızca değerlendirme penceresinde en az asgari gönderim örneklem büyüklüğüne ulaşıldığında değerlendirilir:

Duraklatma eşiğine ulaşıldığında gönderim duraklatılır (API 429); bu, gönderici puanınızı da düşürür.

Teslimat Askıya Alma (Deliverability Hold)Bölüm bağlantısını kopyala

Duraklatma eşiğinin aşılması, yukarıdaki geçici 429 duraklatmasından ayrı olarak, çalışma alanına kalıcı bir teslimat askıya alması da yerleştirir. Askıya alma etkinken her gönderim, işlemsel olsun pazarlama olsun, reddedilir: API'den 403 ACTION_REQUIRED, SMTP relay üzerinden geçici 451 4.7.0; böylece posta sunucunuz mesajı kuyrukta tutar ve yeniden dener.

• Askıya alma her ihlal olayında bir kez yerleştirilir, her gönderimde değil.
• MailLand desteği inceleyip kaldırana kadar sürer; toparlanan bir geri dönme veya şikayet oranı onu otomatik olarak kaldırmaz, otomatik kaldırma yoktur.
• Çalışma alanının Sahipleri ve Yöneticileri, askıya alma yerleştirilir yerleştirilmez bir e-posta alır.

En İyi UygulamalarBölüm bağlantısını kopyala

• Listelerinizi temizleyin: E-posta Doğrulama ile göndermeden önce e-posta adreslerini doğrulayın. Sürekli geri dönen adresleri kaldırın.
• Geri dönme kategorilerini izleyin: content_rejected geri dönmelerinde ani bir artış, liste kalitesi sorunu değil içerik sorunu olduğuna işaret edebilir.
• Kalıcı geri dönmeleri yeniden denemeyin: Kalıcı geri dönmeler süreklidir. Yeniden denemek kotayı boşa harcar ve itibarı zedeler.
• Geçici geri dönme kalıplarını izleyin: Aynı alandan tekrarlayan mailbox_full geri dönmeleri sağlayıcı düzeyinde bir sorun olduğuna işaret edebilir.
• Teslim edilebilirlik panosunu kullanın: Alana özgü sorunları erken yakalamak için sağlayıcıya göre geri dönme oranlarını takip edin.

Sonraki AdımlarBölüm bağlantısını kopyala

• Bastırmalar: bastırma listesini yönetin
• Teslim Edilebilirliğe Genel Bakış: gönderici puanını ve eğilimleri izleyin
• Web Kancası Olayları: message.bounced olaylarını alın