برگشتی‌ها

هنگامی که ایمیلی نمی‌تواند تحویل داده شود، سرور دریافت‌کننده یک برگشتی ارسال می‌کند. 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. آدرس برای ایمیل‌های بازاریابی به مدت ۳۰ روز حذف می‌شود (ایمیل‌های تراکنشی همچنان تحویل داده می‌شوند): از همان اولین برگشتی موقت، نه پس از چند بار تلاش مجدد. استثنا: اولین برگشتی MessageExpired یک آدرس، یا اولین برگشتی آن به دلیل بزرگ بودن پیام (QuotaIssues با کد 5.3.4 یا 5.2.3)، آدرس را حذف نمی‌کند؛ اگر در ۳۰ روز بعد تکرار شود، آدرس مثل همیشه حذف می‌شود.
3. یک رویداد وب‌هوک message.bounced با bounce_type: "soft" ارسال می‌شود. (خرابی‌های موقت پیش از گزارش برگشتی به MailLand، توسط خودِ MTA دوباره امتحان می‌شوند.)
4. پس از ۳۰ روز، حذف به‌طور خودکار منقضی می‌شود

برگشتی‌های مسدودشدهکپی پیوند بخش

1. وضعیت پیام به Bounced تغییر می‌کند (برای AdminBounce به Failed)، اما آدرس گیرنده به هیچ لیست حذفی اضافه نمی‌شود: برگشتی مسدودشده بیانیه‌ای دربارهٔ ارسال ماست، نه دربارهٔ صندوق پستی گیرنده
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 به‌صورت نزولی مرتب شده و به ۹۰ روز گذشته محدود هستند. 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 از API)؛ این کار امتیاز فرستنده شما را نیز کاهش می‌دهد.

توقف‌های تحویل‌پذیری (Deliverability Holds)کپی پیوند بخش

عبور از آستانهٔ توقف، جدا از توقف موقت 429 بالا، یک توقف دائمی تحویل‌پذیری نیز روی فضای کاری می‌گذارد. تا زمانی که این توقف فعال است، هر ارسالی، چه تراکنشی و چه بازاریابی، رد می‌شود: از سمت API با 403 ACTION_REQUIRED و از طریق SMTP relay با کد موقت 451 4.7.0، تا سرور ایمیل شما پیام را در صف نگه دارد و دوباره تلاش کند.

• این توقف یک‌بار برای هر رویداد نقض گذاشته می‌شود، نه در هر ارسال.
• تا زمانی که پشتیبانی MailLand آن را بررسی و رفع کند باقی می‌ماند؛ بهبود نرخ برگشتی یا شکایت آن را به‌طور خودکار رفع نمی‌کند و رفع خودکاری وجود ندارد.
• مالکان و مدیران فضای کاری بلافاصله پس از اعمال توقف، ایمیلی دریافت می‌کنند.

بهترین روش‌هاکپی پیوند بخش

• لیست‌های خود را پاک کنید: آدرس‌های ایمیل را قبل از ارسال با اعتبارسنجی ایمیل تأیید کنید. آدرس‌هایی که دائماً برمی‌گردند را حذف کنید.
• دسته‌های برگشتی را رصد کنید: افزایش ناگهانی برگشتی‌های content_rejected ممکن است نشان‌دهنده مشکل محتوا باشد، نه کیفیت لیست.
• برگشتی‌های دائمی را مجدداً امتحان نکنید: برگشتی‌های دائمی، دائمی هستند. تلاش مجدد، سهمیه را هدر می‌دهد و به شهرت آسیب می‌رساند.
• الگوهای برگشتی موقت را زیر نظر بگیرید: برگشتی‌های مکرر mailbox_full از همان دامنه ممکن است نشان‌دهنده مشکل سطح ارائه‌دهنده باشد.
• از داشبورد قابلیت تحویل استفاده کنید: نرخ برگشتی را بر اساس ارائه‌دهنده دنبال کنید تا مشکلات خاص دامنه را زودهنگام شناسایی کنید.

مراحل بعدیکپی پیوند بخش

• لیست‌های حذف: مدیریت لیست حذف
• مرور کلی قابلیت تحویل: نظارت بر امتیاز فرستنده و روندها
• رویدادهای وب‌هوک: دریافت رویدادهای message.bounced