Ошибки SMTP API

Что такое ошибки SMTP API? #

Ошибки SMTP API — это уведомление о внутреннем отклонении, которое Haskimail отправляет в ответ на попытку отправить письмо через SMTP получателю, который ранее был исключен из рассылки из-за возврата, жалобы на спам, отписки или ручного исключения.

Это относится только к письмам, отправленным через SMTP, и включается на уровне SMTP-сервера в Haskimail. Если вы отправляете через наш API, информация об ошибке будет возвращена в стандартном API-ответе.

Настройка уведомлений об ошибках SMTP API для сервера #

Вам необходимо включить уведомления об ошибках SMTP API для каждого сервера, для которого вы хотите их получать. Это можно сделать только через API, а не в веб-интерфейсе.

Вам потребуется аутентифицировать запрос с помощью API аккаунта и обратиться к эндпоинту https://api.haskimail.ru/servers/, добавив к этому URL идентификатор сервера (SERVERID).

curl "https://api.haskimail.ru/servers/SERVERID" \
  -X PUT \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Haskimail-Server-Token: server token" \
  -d '{
  "EnableSmtpApiErrorHooks":true,
}'

Данные об ошибках SMTP API #

При любой попытке отправить письмо исключенному получателю вы получите ошибку в интерфейсе Haskimail:

Тестирование ошибок SMTP API #

Чтобы протестировать ошибку SMTP API, сначала:

1. Исключите получателя (добавьте его в стоп-список).
2. Отправьте письмо этому исключенному получателю через SMTP-сервис, который вы подключили к Haskimail.

Как можно использовать ошибки SMTP API #

Ошибка SMTP API уведомит вас при попытке связаться с неактивным получателем. Это поможет вам синхронизировать ваши внешние списки со стоп-списками Haskimail.

Если у вас есть основания полагать, что получатель снова активен и готов получать ваши письма, вы можете повторно активировать его и продолжить отправку.