Demo
Demo
База знаний PMTA›Механизм§ 7.4.5

Что возвращать в отчёте об отказе

return type in delivery reports
Целиком или только заголовки

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

Выбор едет с письмом: узел задаёт лишь умолчание для писем, которые не выбрали, — dsn-return-default в блоке источника.

Полное письмо в отчёте дорого: каждый отказ несёт содержимое целиком — это трафик, место и вопрос раскрытия чужих данных. Для массовой рассылки почти всегда верны заголовки.

Главная ловушка — полный возврат на массовом потоке. Цена растёт вместе с долей отказов: плохой список с полным возвратом умножает исходящий трафик отчётами.
Что делает Хаб. Не задаёт: письма подаются по SMTP без выбора, а в базовом источнике 0/0 шаблона Хаба включён suppress-local-dsn — отказы идут в учёт и вебхук, а не отчётами-письмами.
Рекомендуемые значения

Два значения:

Значение Что в отчёте Когда
PmtaMsgRETURN_HEADERS только заголовки; по умолчанию массовая рассылка
PmtaMsgRETURN_FULL заголовки и тело транзакционная почта с коротким важным телом
Два значения и умолчание обвязок — из руководства (§ 7.4.5); умолчание узла — § 3.3.7.31. Совет по выбору — наш.
Пример в конфигурации
# вернуть в отчёте только заголовки — это умолчание
msg.setReturnType(PmtaMsgRETURN_HEADERS);
При подаче по SMTP то же выбирают параметром RET=HDRS или RET=FULL команды MAIL FROM — это стандарт DSN.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Проверить, отправляет ли узел отчёты сам и какое у него умолчание:
grep -n 'suppress-local-dsn\|dsn-return-default' /etc/pmta/config
suppress-local-dsn true — отчётов письмами нет вовсе; dsn-return-default — умолчание узла для писем без выбора.
◇

Что ещё почитать

3 статьи

◇Два обработчика входящих отчётов и что с ними делатьОтказы письмом и жалобы разбираются двумя одинаково устроенными блоками; у каждого свой список адресов и своя пара решений о судьбе письма.◇Обратный адрес, в который вписан получательОтказ приходит на уникальный адрес, и разбирать его содержимое не нужно.◇На какие исходы приходит отчёт — решает каждый получательДля каждого получателя отдельно запрашивается отчёт об успехе, о неудаче, о задержке, о любом их сочетании или ни о чём; умолчание — только неудача.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Классификация отказов