техническое · ответ с источниками

Пользовательские заголовки письма: что это и как их использовать

Пользовательские заголовки письма — нестандартные поля метаданных, добавляемые в раздел заголовков письма. В отличие от стандартных заголовков вроде Subject или From, пользовательские заголовки позволяют разработчикам встраивать данные приложения, которые передаются вместе с письмом, но обычно скрыты от конечного пользователя.

Как это устроено

Пользовательские заголовки представляют собой пары «ключ — значение», расположенные перед телом письма. Они имеют формат Header Name: Value. Согласно RFC 5322, пользовательские заголовки часто начинаются с X, чтобы обозначить их экспериментальный или нестандартный характер, хотя в современных системах это соглашение соблюдается менее строго. Эти заголовки обрабатываются агентом передачи почты (MTA) во время SMTP-сессии и сохраняются в метаданных письма.

Польза для отправителя и отслеживание

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

Что учесть в эксплуатации

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

Конкретный пример

Типичный пример — заголовок X-Campaign-ID. Например, X-Campaign-ID: summer_sale_2024 позволяет отправителю определить, на какую маркетинговую рассылку откликнулся пользователь. С помощью бесплатных инструментов SendHQ (https://sendhq.cc/tools) можно проанализировать настройки почты и убедиться, что техническая конфигурация оптимизирована для доставки.

Интеграция с API

Современные email API позволяют передавать пользовательские заголовки в виде массива или объекта в JSON-теле запроса. Вместо ручного формирования потока данных SMTP API берёт форматирование на себя и корректно размещает заголовки в MIME-структуре до того, как письмо будет поставлено в очередь на доставку.

Что спрашивают команды

Влияют ли пользовательские заголовки на доставляемость?

Как правило, нет, но заголовки с известными спам-шаблонами или чрезмерной длиной могут повысить спам-рейтинг письма.

Видит ли получатель пользовательские заголовки?

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

Нужен ли по-прежнему префикс X-?

Хотя RFC 5322 рекомендовал префикс X- для нестандартных заголовков, большинство современных почтовых серверов больше строго его не требуют.

Первоисточники

RFC 5322: формат интернет-сообщений — RFC Editor
RFC 5321: простой протокол передачи почты (SMTP) — RFC Editor