Помилки SMTP та відповідні Webhooks

У статті наведено розшифрування кодів SMTP-помилок та відповідні їм автоматичні повідомлення Webhook, які відправляються в разі невдачі доставки листа.

У деяких випадках, коли лист не було доставлено користувачеві, ми отримуємо відповідний код помилки від поштового провайдера. Ми декодуємо цей код та надсилаємо вам автоматичне повідомлення Webhook типу Lost, що повідомляє вас про можливі причини невдачі доставки.

Загальна структура SMTP-коду помилки

SMTP-код помилки складається з трьох цифр, кожна з яких несе своє значення.

• Перша цифра вказує на те, чи був прийнятий та опрацьований ваш запит:

  • 1 – Сервер прийняв команду, але очікує підтвердження. Команда ще не була опрацьована;
  • 2 – Успішне виконання дії, сервер готовий приймати нові команди;
  • 3 – Сервер прийняв команду, але для її виконання потрібна додаткова інформація;
  • 4 – Тимчасовий збій. Повторіть команду;
  • 5 – Постійний збій. Листи не будуть надіслані, доки проблема не буде усунена.

• Друга цифра визначає функціональну категорію відповіді:

  • 0 – Синтаксична помилка: правильні команди з неправильним синтаксисом, нереалізовані або зайві команди;
  • 1 – Відповіді на запити інформації;
  • 2 – Відповіді, що стосуються каналу передачі;
  • 3 та 4 – Не визначено;
  • 5 – Вказує на стан поштового сервера чи системи.

• Третя цифра в коді відповіді надає більш детальну інформацію про статус доставки.

Відповідність кодів помилок SMTP їхнім Webhook з поясненнями

У таблиці нижче ви знайдете найбільш поширені коди помилок, їх причину, яку ми вказуємо в автоматичному повідомленні Webhook, а також коротке пояснення.

Код помилки SMTP	Webhook	Пояснення
452	account_over_quota	Команду було скасовано, оскільки на сервері постачальників недостатньо системної пам’яті. Спробуйте відправити лист з іншого сервера.
454	relay_access_denied	Аутентифікація неможлива через тимчасовий збій сервера.
500	message_rejected	Сервер не розпізнав команду через неправильний синтаксис (наприклад, занадто довгий командний рядок).
511	no_mailbox	Команда не виконана, оскільки не знайдено поштової скриньки або електронної адреси одержувача. Така поштова скринька не існує або була видалена. Адреса одержувача може бути введена некоректно або містити помилки.
540	account_suspended	Виконання команди було зупинено через блокування чи призупинення облікового запису на сервері постачальника поштових послуг. Це може бути обумовлено перевищенням ліміту або порушенням правил використання.
550	does_not_exist	Команда не виконана через недоступну поштову скриньку користувача або відхилення сервером через підозру на спам.
552	user_over_quota	Лист не надіслано через брак місця у поштовій скриньці одержувача.
553	user_not_exists_or_domain_is_not_allowed	Виконання команди зупинено, оскільки не знайдено поштову скриньку із зазначеною назвою.
554	address_rejected	Ваш лист було відхилено поштовим сервером. Ймовірно, сервер розцінює його як спам, виявив вашу IP-адресу у чорному списку або самостійно додав її до свого чорного списку.