الارتدادات

عندما يتعذّر تسليم بريد إلكتروني، يُرسل الخادم المستقبِل ردَّ ارتداد. تُصنِّف MailLand الارتدادات، وتُدرج تلقائيًا العناوين التي لن تقبل البريد في قائمة الحظر، وتُعيد المحاولة للحالات العابرة.

أنواع الارتداداتنسخ رابط القسم

فئات الارتداداتنسخ رابط القسم

تُجمِّع واجهة تفصيل الارتدادات (GET /v1/deliverability/bounce-breakdown) كل ارتداد حسب التصنيف الذي يمنحه خادم نقل البريد (MTA) نفسه لرفض SMTP، ثم تُحوِّل هذا التصنيف إلى صلب أو ناعم أو محظور. الجدول أدناه هو المفردات الكاملة والثابتة للإنتاج: أي شيء يُصدره الخادم ولا يكون في هذا الجدول يُحسب كغير معروف بدلًا من تخمينه:

تُبلِغ نقطتا نهاية واردتان لاحقًا في هذه الصفحة عن الارتدادات بمفردات خاصة بهما. تحسب /v1/transactional/bounces/statistics القيمتين hardBounces وsoftBounces من القرار نفسه الذي يحظر العنوان (أو لا يحظره)، فلا يُحتسب الارتداد المحظور أبدًا صلبًا أو ناعمًا، ويجمع حقلها byCategory تصنيف الخادم أعلاه في مجموعة أخشن (invalid_recipient، bad_mailbox، bad_domain، mailbox_full، content_rejected، policy_reason، general_bounce). أما /v1/transactional/bounces/recent فتُعيد في bounceCategory تصنيف الخادم نفسه للرسالة.

المعالجة التلقائيةنسخ رابط القسم

الارتدادات الصلبةنسخ رابط القسم

1. يُضاف عنوان البريد الإلكتروني للمستلم فورًا إلى قائمة الحظر العالمية
2. تُحظر جميع الرسائل المستقبلية (المعاملاتية والتسويقية) إلى هذا العنوان
3. يُطلَق حدث ويب هوك message.bounced مع bounce_type: "hard" (لا يُطلَق حدث suppression.added منفصل)

الارتدادات الناعمةنسخ رابط القسم

1. تتغير حالة الرسالة إلى Bounced
2. يُحظر العنوان لرسائل التسويق لمدة 30 يومًا (تظل الرسائل المعاملاتية تُسلَّم): عند أول ارتداد ناعم، وليس بعد محاولات إعادة الإرسال. استثناء: أول ارتداد MessageExpired لعنوان ما، أو أول ارتداد له بسبب رسالة أكبر من المسموح (QuotaIssues مع الرمز الموسّع 5.3.4 أو 5.2.3)، لا يحظر شيئًا؛ وأي ارتداد آخر مثله خلال 30 يومًا يحظر كالمعتاد.
3. يُطلَق حدث ويب هوك message.bounced مع bounce_type: "soft". (يُعيد خادم نقل البريد (MTA) نفسه محاولة الأعطال المؤقتة قبل الإبلاغ عن الارتداد إلى MailLand.)
4. بعد 30 يومًا، تنتهي صلاحية الحظر تلقائيًا

الارتدادات المحظورةنسخ رابط القسم

1. تتغير حالة الرسالة إلى Bounced (وإلى Failed في حالة AdminBounce)، لكن عنوان المستلم لا يُضاف إلى أي قائمة حظر: الارتداد المحظور بيان عن إرسالنا نحن، وليس عن صندوق بريد المستلم
2. يُطلَق حدث ويب هوك message.bounced مع bounce_type: "blocked" (وفي حالة AdminBounce يُطلَق بدلًا منه حدث message.failed مع reason: "admin_bounce")
3. معدل مستمر من الارتدادات المحظورة يُطلق تنبيهًا داخليًا للمراجعة اليدوية؛ لا يوجد إيقاف تلقائي للإرسال

إحصاءات الارتداداتنسخ رابط القسم

احصل على إحصاءات الارتدادات التجميعية لفترة زمنية:

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

المصادقة عبر Authorization: Bearer <token> أو X-API-Key: <api key>.

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
  }
}

الارتدادات الأخيرةنسخ رابط القسم

احصل على آخر الرسائل المرتدة:

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
  }
]

النتائج مرتبة تنازليًا حسب bouncedAt ومقيَّدة بآخر 90 يومًا. حقل bouncedAt هو وقت إنشاء الرسالة، وليس طابعًا زمنيًا منفصلًا للارتداد.

إعادة محاولة رسالة مرتدةنسخ رابط القسم

أعد محاولة تسليم رسالة مرتدة يدويًا:

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..."

تُعيد إعادة المحاولة إرسال المحتوى الأصلي عبر صندوق الصادر (outbox) الخاص بـ MailLand. يكون تتبُّع الفتح والنقر مُعطَّلًا في النسخ المُعاد إرسالها: لا يمكن استرجاع خيار التتبُّع الأصلي من صف الرسالة.

حدود نسبة الارتدادنسخ رابط القسم

الحدود هي إعدادات افتراضية للخطة، وتُقيَّم فقط بعد حدوث الحد الأدنى لحجم العينة من الإرسالات ضمن نافذة التقييم:

يُوقَف الإرسال (بردّ 429 من الواجهة) عند بلوغ حد الإيقاف؛ وهذا يخفض نقاط المُرسِل لديك أيضًا.

تعليقات إمكانية التسليم (Deliverability Holds)نسخ رابط القسم

بلوغ حد الإيقاف يضع أيضًا تعليقًا دائمًا لإمكانية التسليم على مساحة العمل، وهو منفصل عن الإيقاف المؤقت 429 أعلاه. أثناء نشاط التعليق، يُرفَض كل إرسال، التراكني والتسويقي على حد سواء، بردّ 403 ACTION_REQUIRED من الواجهة، و451 4.7.0 مؤقت عبر SMTP relay، فيحتفظ خادم البريد لديك بالرسالة في قائمة الانتظار ويعيد المحاولة.

• يُوضع التعليق مرة واحدة لكل حادثة تجاوز، لا مع كل إرسال.
• يستمر حتى يراجعه دعم MailLand ويرفعه؛ تحسّن نسبة الارتداد أو الشكاوى لا يرفعه تلقائيًا، لا يوجد رفع تلقائي.
• يتلقى مالكو مساحة العمل والمشرفون رسالة بريد إلكتروني فور وضع التعليق.

أفضل الممارساتنسخ رابط القسم

• نظِّف قوائمك: تحقق من صحة عناوين البريد الإلكتروني قبل الإرسال باستخدام التحقق من البريد الإلكتروني. أزل العناوين التي ترتد باستمرار.
• راقب فئات الارتداد: قد تشير الزيادة المفاجئة في ارتدادات content_rejected إلى مشكلة في المحتوى، وليس في جودة القائمة.
• لا تُعد محاولة الارتدادات الصلبة: الارتدادات الصلبة دائمة. إعادة المحاولة تُضيع الحصة وتُضر بالسمعة.
• راقب أنماط الارتداد الناعم: قد تشير الارتدادات المتكررة من نوع mailbox_full من النطاق ذاته إلى مشكلة على مستوى مزود الخدمة.
• استخدم لوحة تحكم قابلية التسليم: تتبع نسب الارتداد حسب المزود للكشف المبكر عن مشكلات خاصة بنطاقات معينة.

الخطوات التاليةنسخ رابط القسم

• الحظر: إدارة قائمة الحظر
• نظرة عامة على قابلية التسليم: مراقبة نقاط المُرسِل والاتجاهات
• أحداث ويب هوك: استقبال أحداث message.bounced