Ошибки SMTP API

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

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

В этом случае письмо не уходит получателю, а помечается как возврат (категория hrd — жёсткий возврат) с кодом причины. В интерфейсе Haskimail и в логах писем такое письмо видно как возврат с описанием причины.

Когда письмо отклоняется #

Haskimail проверяет получателя письма перед отправкой через SMTP. Письмо отклоняется в следующих случаях:

Код	Причина
673	Получатель отписан или добавлен в стоп-список (из-за жалобы на спам, ручного исключения или отписки).
674	От этого адреса ранее был зафиксирован жёсткий возврат.
684	IP-адрес отправителя не входит в список разрешённых IP-адресов для отправки через SMTP.

Во всех случаях категория возврата — hrd (жёсткий возврат). Письмо не отправляется, но продолжает учитываться в статистике и логах писем.

Включение отправки через SMTP #

Отправка писем через SMTP включается на уровне сервера полем SmtpApiActivated. Это можно сделать в веб-интерфейсе или через 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-Account-Token: account token" \
  -d '{
  "SmtpApiActivated": true
}'

Как узнавать об отклонениях #

Отклонённое письмо видно в интерфейсе Haskimail и в логах писем как возврат с причиной и кодом из таблицы выше.

Программно отслеживать такие ситуации можно двумя способами:

• Вебхук «Изменение подписки» — сообщает, когда адрес добавляется в стоп-список (после жёсткого возврата, жалобы на спам или вручную). Настроив его, вы заранее узнаете, что адрес перестал принимать письма.
• Вебхук «Возвраты» — сообщает о возвратах, которые приходят от почтовых серверов после отправки письма.

Если вы считаете, что получатель снова активен, удалите его из стоп-списка — после этого отправка ему возобновится.