Стоп-листы

В Yandex Cloud Postbox есть два стоп-листа: пользовательский и глобальный. Перед отправкой письма каждому получателю сервис проверяет оба стоп-листа независимо.

Когда адрес получателя находится:

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

Перед тем, как добавить адрес в стоп-лист или проверить, находится ли он в стоп-листе, Yandex Cloud Postbox приводит его к каноническому виду: переводит домен в нижний регистр, а все, что идет после знака + до @, отбрасывает. Например, адрес user+promo@Example.COM хранится и ищется как user@example.com.

При попытке отправить письмо на заблокированный адрес запрос на отправку принимается, сервис возвращает идентификатор письма, но на почтовый сервер получателя оно не передается. Такое письмо отображается как недоставленное.

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

Параметр	Пользовательский стоп-лист	Глобальный стоп-лист
Кто управляет	Пользователь	Yandex Cloud Postbox
Область действия	Облако	Все адреса Yandex Cloud Postbox
Доступен пользователю	Да	Нет
Кто добавляет адрес в стоп-лист	Пользователь или Yandex Cloud Postbox из-за жалоб получателей	Yandex Cloud Postbox из-за ошибок доставки
Как долго адрес находится в стоп-листе	Пока пользователь не удалит адрес из стоп-листа	До полугода

Пользовательский стоп-листПользовательский стоп-лист

Пользовательский стоп-лист — это список адресов получателей, которым Yandex Cloud Postbox не отправляет письма, если причина, по которой адрес добавили в стоп-лист, блокирует отправку. Можно создать только один пользовательский стоп-лист для облака и использовать его для всех каталогов, адресов и конфигураций внутри облака.

Пользовательский стоп-лист позволяет:

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

Массового экспорта стоп-листов из сторонних сервисов в Yandex Cloud Postbox нет. Каждый адрес необходимо переносить отдельно.

Как адрес попадает в пользовательский стоп-листКак адрес попадает в пользовательский стоп-лист

Адрес попадает в пользовательский стоп-лист одним из двух способов:

• Вручную — пользователь добавляет адрес и самостоятельно указывает причину добавления.
• Автоматически по жалобе — когда от получателя приходит жалоба на письмо, Yandex Cloud Postbox добавляет адрес получателя в стоп-лист с причиной COMPLAINT. При этом сохраняется идентификатор письма, из-за которого адрес попал в стоп-лист.

Список адресов строится по асинхронному индексу, поэтому только что добавленный или удаленный адрес может добавиться в стоп-лист или удалиться из него с задержкой в несколько секунд. При этом запрос информации об одном адресе возвращает актуальные данные сразу, и блокировка отправки на адрес тоже начинает действовать сразу.

Ограничений на количество адресов в пользовательском стоп-листе нет.

Причины добавления адреса в пользовательский стоп-листПричины добавления адреса в пользовательский стоп-лист

У каждого адреса в пользовательском стоп-листе указана причина, по которой он туда попал:

• COMPLAINT — получатель пожаловался на письмо.
• BOUNCE — на адрес не доставляются письма, например, потому что адреса не существует. Добавить адрес в стоп-лист по причине BOUNCE можно только вручную.

У адреса может быть только одна причина, по которой его добавили в стоп-лист. Если адрес добавляется в стоп-лист повторно, причина перезаписывается. Например, если пользователь добавил адрес с причиной BOUNCE, а затем от получателя пришла жалоба, причина изменится на COMPLAINT.

От настроек стоп-листа в конфигурации, примененной к письму, зависит:

• какие причины блокируют отправку;
• добавляются ли адреса получателей в пользовательский стоп-лист автоматически по причине COMPLAINT.

Настройки стоп-листа			Какие причины блокируют отправку	Адреса автоматически добавляются в стоп-лист по причине COMPLAINT
Включена опция Проверять список	Выбрана причина COMPLAINT	Выбрана причина BOUNCE
	—		COMPLAINT
			COMPLAINT, BOUNCE
			BOUNCE
			Отправка не блокируется

Если конфигурация не применена к письму, по умолчанию отправку блокирует только причина COMPLAINT и адреса получателей, которые пожаловались на письма, автоматически добавляются в пользовательский стоп-лист.

Глобальный стоп-листГлобальный стоп-лист

Глобальный стоп-лист (Global Suppression List, GSL) — это системный список адресов, которым управляет Yandex Cloud Postbox. Он общий для всех адресов и обновляется автоматически.

Глобальный стоп-лист включен по умолчанию для всех адресов Yandex Cloud Postbox, отключить его нельзя. Содержимое глобального стоп-листа недоступно через публичный API.

Как адрес попадает в глобальный стоп-листКак адрес попадает в глобальный стоп-лист

Если почтовый сервер получателя возвращает ошибку, которую Yandex Cloud Postbox классифицирует как постоянную и не требующую повторной попытки доставки, сервис фиксирует отказ по этому адресу. Из-за временных ошибок доставки адрес в глобальный стоп-лист не попадает.

Блокировка зависит от количества отказов. Первый отказ фиксируется, но попытки отправки при этом продолжаются. Если отказы повторяются, Yandex Cloud Postbox блокирует отправку на адрес. Срок блокировки увеличивается с каждым новым отказом и может достигать 14 дней.

Как адрес удаляется из глобального стоп-листаКак адрес удаляется из глобального стоп-листа

После того как срок блокировки истек, Yandex Cloud Postbox удалит адрес из глобального стоп-листа при следующей успешной отправке на этот адрес. Если успешной отправки не происходит, адрес находится в стоп-листе около полугода.

Удалить адрес из глобального стоп-листа вручную нельзя — обратитесь в техническую поддержку.

Как понять, что письмо не отправлено из-за того, что адрес находится в стоп-листеКак понять, что письмо не отправлено из-за того, что адрес находится в стоп-листе

Посмотрите:

• Журнал выполнения. Если для адреса настроена запись логов и включена опция Статусы писем, в журнале выполнения появится запись уровня WARN с сообщением Message suppressed. У обычной ошибки доставки будет сообщение Message bounced.

  Пример записи:

  {
    "level": "WARN",
    "data": {
      "msg": "Message suppressed",
      "identity_id": "...",
      "message": {
        "message_id": "...",
        "reason": "Recipient is on your account suppression list",
        "mail": { "recipient": "user@example.com", "from": "...", "to": "...", "subject": "..." }
      }
    }
  }
  

  Поле reason указывает на то, какой стоп-лист заблокировал отправку:

  • Recipient is on your account suppression list — пользовательский стоп-лист;
  • Recipient is on the global suppression list — глобальный стоп-лист.

• Историю отправленных писем. В причинах недоставки письма будет написано, что отправку заблокировал пользовательский или глобальный стоп-лист.

• Уведомления об операциях с письмами. Если отправку заблокировал:

  • пользовательский стоп-лист, придет событие Bounce с подтипом ошибки bounceSubType : OnAccountSuppressionList и diagnosticCode: Blocked by Account Suppression List.
  • глобальный стоп-лист, придет событие Bounce с подтипом ошибки bounceSubType : Suppressed и diagnosticCode: Blocked by Global Suppression List.

Полезные ссылкиПолезные ссылки

• Управление пользовательским стоп-листом
• Конфигурация
• Уведомления об операциях с письмами