Подключение Mail.ru Postmaster: пошаговая инструкция

1. Что дает подключение Postmaster Mail.ru

Postmaster Mail.ru это бесплатный кабинет от Mail.ru, где отправитель видит, как его рассылки принимает почта Mail.ru (домены mail.ru, bk.ru, list.ru и inbox.ru). Без этого кабинета у вас нет официальных данных о доставке и жалобах: вы узнаете о проблеме только по косвенным признакам вроде падения открытий.

Ключевая особенность: статистика привязана не к адресу отправителя и не к IP, а к домену в DKIM-подписи, то есть к значению тега d=. Если письма подписывает ваш ESP своим доменом, в кабинете Postmaster ваш домен останется пустым. Смена селектора s= статистику не обнуляет, а вот смена домена d= уводит историю на новый домен.

После подключения вы получаете объем отправок, процент доставки, долю жалоб на спам и показатель "Репутация, %" (средний процент жалоб за 30 дней, чем меньше, тем лучше). Это те же данные, которые показывает мониторинг Mail.ru Postmaster в PostmastersTool, только без ручных ежедневных заходов в кабинет.

2. Что подготовить до подключения

До того как добавить домен в Postmaster Mail.ru, проверьте три вещи:

Первая: ваши письма должны быть подписаны DKIM именно вашим доменом. Откройте любое отправленное письмо и посмотрите заголовок DKIM-Signature. Нас интересует параметр d=, например d=news.example.com. Если там домен вашего ESP, попросите поддержку настроить подпись вашим доменом (белую DKIM-подпись), иначе статистики не будет.

Вторая: у вас должен быть доступ к DNS домена, который вы будете подтверждать. Подтверждение владения обычно делается через TXT-запись, и без доступа к DNS-зоне вы не пройдете этот шаг.

Третья: аккаунт Mail.ru или VK ID для входа в postmaster.mail.ru. Лучше использовать корпоративный аккаунт, к которому имеют доступ несколько человек: иначе при уходе сотрудника вы потеряете кабинет.

3. Как добавить домен и подтвердить владение

Шаг 1. Войдите на postmaster.mail.ru под своим аккаунтом и нажмите "Добавить домен".

Шаг 2. Введите домен, который стоит в d= вашей DKIM-подписи. Для рассылок это часто поддомен вида news.example.com или mail.example.com.

Шаг 3. Кабинет предложит три способа подтверждения владения доменом: HTML-файл на веб-сервере домена, метатег на главной странице сайта или запись в DNS (TXT-запись с уникальным значением). Первые два способа требуют веб-сервера на этом домене. Для рассыльных поддоменов, у которых обычно нет сайта, подходит только проверка через DNS.

Шаг 4. Добавьте запись у вашего DNS-провайдера и подождите обновления DNS. Обычно это минуты, но зависит от TTL зоны.

Шаг 5. Вернитесь в кабинет и нажмите кнопку проверки. После успешного подтверждения домен появится в списке, и начнется накопление статистики.

Проверить, что TXT-запись опубликована, можно до нажатия кнопки в кабинете. Команда для Linux или macOS:

dig TXT news.example.com +short

Для Windows в командной строке:

nslookup -type=TXT news.example.com

В ответе вы должны увидеть значение, которое выдал Postmaster. Если ответа нет или значение другое, проверка в кабинете не пройдет: смотрите опечатки в имени записи и то, не добавил ли DNS-редактор вашего провайдера домен второй раз (запись вида news.example.com.example.com).

4. OAuth и Ext API: как получать статистику автоматически

Ручной заход в кабинет подходит для разовой проверки, но не для мониторинга: вы увидите проблему только тогда, когда зайдете сами. У Postmaster Mail.ru есть официальный Ext API: он отдает список подтвержденных доменов и дневную статистику по каждому, включая объем, доставку, жалобы и "Репутация, %".

Доступ к API устроен на паре токенов OAuth 2.0. refresh_token бессрочный, access_token живет один час и обновляется через refresh_token. Оба токена владелец кабинета получает разом: нужно авторизоваться на mail.ru, перейти по отдельной ссылке генерации токенов Postmaster API, подтвердить доступ и скопировать значения из JSON-ответа. Автоматического возврата токена стороннему сервису тут нет: пару токенов нужно скопировать самому и один раз вставить в форму подключения сервиса мониторинга, дальше сервис обновляет access_token без вашего участия.

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

В PostmastersTool это выглядит так: вы один раз вставляете refresh_token или весь JSON-ответ целиком (нужное поле сервис найдет сам) в форму подключения. Дальше сервис сам обновляет access_token, регулярно забирает объем, доставку, жалобы и "Репутация, %", хранит историю по дням и присылает уведомление в выбранный канал (Telegram, почта и другие), когда показатель приближается к лимиту Mail.ru для вашего объема отправок или превышает его. Это снимает главный риск ручной схемы: пропустить рост жалоб на несколько дней.

Если вход в аккаунт Mail.ru требует капчи или двухфакторной проверки и это мешает работе по токену, есть резервный вариант: подключение по браузерной сессии, которое настраивается вместе со службой поддержки сервиса мониторинга.

5. Какая статистика доступна и какие пороги считать нормой

В кабинете по домену доступны основные метрики. Ориентируйтесь на них при ежедневном контроле:

Главный порог это жалобы. В официальных правилах для рассыльщиков Mail.ru указаны допустимые уровни жалоб в зависимости от месячного объема отправок на домены Mail.ru:

Это именно пороги Mail.ru, их нельзя переносить на Gmail: у Google свои требования к отправителям (0,1% как норма и 0,3% как недопустимый уровень), а Postmaster Tools лишь показывает сам показатель spam rate. Если ваша доля жалоб приближается к порогу вашего объемного диапазона, это сигнал разбирать базу, сегменты и контент, а не ждать блокировки.

6. Если статистика не появляется: дерево диагностики

Домен добавлен и подтвержден, но графики пустые. Проходите ветки по порядку:

Ветка 1. Подтвержден ли домен. Откройте список доменов в кабинете. Если статус не "подтвержден", статистика не собирается: возвращайтесь к шагу 3 и проверяйте TXT-запись через dig.

Ветка 2. Совпадает ли добавленный домен с d=. Возьмите свежее письмо из реальной рассылки, найдите DKIM-Signature и сравните d= с доменом в кабинете посимвольно. Различие news.example.com и example.com это разные объекты статистики. Разобрать заголовки можно в анализаторе заголовков письма: вставьте исходник письма и посмотрите результат проверки DKIM.

Ветка 3. Есть ли объем. При малом количестве получателей на Mail.ru данные могут не отображаться или отображаться с задержкой. Проверьте по логам отправки, сколько писем реально ушло на адреса mail.ru, bk.ru, list.ru, inbox.ru за последние дни.

Ветка 4. Прошло ли время. Статистика не появляется мгновенно: после подтверждения домена дайте системе время на накопление данных и проверьте кабинет на следующий день.

Ветка 5. Не сменился ли d= после смены ESP или настроек. Если рассылки переехали на другую платформу, она могла начать подписывать своим доменом или другим поддоменом, и история осталась на старом d=.

Если все ветки пройдены, а данных нет, отдельно разберите общий случай в статье о том, почему Postmaster не показывает данные: там разобраны задержки, объемные ограничения и тонкости DKIM.

7. Как проверить, что подключение работает

Проверка результата это не один заход в кабинет, а короткий цикл:

1. В кабинете Postmaster Mail.ru домен в статусе "подтвержден", и по нему есть данные хотя бы за один день: объем больше нуля.

2. Объем в Postmaster сопоставим с объемом отправок на домены Mail.ru по данным вашего ESP. Грубое сравнение достаточно: если ESP отправил 40 000 писем на mail.ru, а Postmaster показывает 300, скорее всего, часть потока подписана другим доменом.

3. Подключен автоматический сбор через Ext API или сервис мониторинга, и история копится по дням без вашего участия.

4. Настроены уведомления на рост жалоб и падение доставки. Без алертов кабинет остается инструментом постфактум-разбора.

Параллельно стоит проверить DNS домена целиком (SPF, DKIM, DMARC, MX, черные списки): Postmaster показывает результат приема, но не показывает состояние ваших записей. Это можно сделать проверкой домена на PostmastersTool.