PPostmastersTool

Мониторинг Mail.ru Postmaster: официальный API и алерты

Кабинет postmaster.mail.ru отдаёт то, чего нет у Google, — счётчики писем. Мониторинг превращает их в алерты и не путает «жалобу» с «письмом в спаме» — а это путают почти все.

Что отдаёт кабинет Mail.ru Postmaster

В отличие от Google, Mail.ru публикует абсолютные счётчики и вовлечённость, а не только доли. Статистика записывается по домену из DKIM-подписи (тег d=) — значение заголовка From не учитывается.

Статистику можно разбивать по тегам рассылок: для этого в письма добавляют заголовок X-Mailru-Msgtype (или X-Postmaster-Msgtype) — например, «digest» или «promo».

МетрикаЧто показывает
Отправленоmessages_sent — писем принято серверами Mail.ru к обработке.
Доставленоdelivered — писем принято пользовательскими ящиками (не отбито).
Жалобыcomplaints — получатели нажали кнопку «Это спам».
В спамеspam и spam_percent — письма, которые фильтр Mail.ru положил в папку «Спам».
Вероятный спамprobably_spam — сомнительные письма по оценке фильтра (ранний сигнал).
Прочтенияread, deleted_read, deleted_unread — вовлечённость: прочитано, удалено после прочтения, удалено не читая.
Репутацияreputation и trend — внутренняя оценка домена Mail.ru и её динамика по дням.

Официальный ext-api: как устроен доступ

У Mail.ru есть официальный программный доступ — Постмастер API, методы с префиксом /ext-api/. Авторизация — OAuth 2.0, и это рекомендуемый путь интеграции:

  • refresh_token — бессрочный; владелец аккаунта может перевыпустить его в любой момент.
  • access_token — живёт 1 час и передаётся в HTTP-заголовке Bearer с каждым запросом; обновляется по refresh_token.
  • Методы: reg-list (подтверждённые домены), troubles-list (проблемы SPF/DKIM/DMARC), stat-list (итоги за период), stat-list-detailed (разбивка по дням).
  • Лимиты: около 10 запросов в минуту на домен для каждой группы методов; при превышении — HTTP 429 с указанием, через сколько повторить.
  • Глубина истории: date_from не старше 1 года.
  • Ответ 403 означает проблему авторизации — чаще всего истёк access_token.

«Жалобы» и «письма в папке Спам» — разные метрики

Самая частая ошибка интерпретации у Mail.ru. Жалоба (complaint) — действие человека: получатель открыл письмо и нажал «Это спам». Письмо в спаме (spam) — решение фильтра: письмо доставлено в папку «Спам», и получатель мог его вообще не увидеть.

Механики разные, и действия разные. Растущие жалобы при чистом фильтре — проблема базы: источники контактов, ожидания подписчиков, контент. Рост spam_percent при низких жалобах — проблема репутации и настроек: аутентификация, паттерны отправки, «прогрев».

Доля жалоб оценивается теми же отраслевыми нормами, что и у Google: 0.1% — предупреждение, 0.3% — действовать немедленно. Дополнительно следите за долей доставленных: падение ниже 98% означает деградацию доставки.

Рабочие пороги
  • Жалобы: 0.1% — предупреждение, 0.3% — действовать немедленно.
  • Доля доставленных ниже 98% — деградация доставки.

Почему по домену нет данных

Пять типичных причин — по порядку от самой частой:

  1. 1Порог публикации: при малом объёме рассылки Mail.ru не показывает статистику по домену.
  2. 2Лаг публикации около суток: вчерашние данные появятся сегодня или завтра.
  3. 3Домен не подтверждён в кабинете postmaster.mail.ru.
  4. 4DKIM подписан другим доменом: статистика пишется на домен из тега d=, а не из From.
  5. 5Рассылок не было: нет потока — нет данных.

Подробный разбор с чек-листом — в статье блога.

Browser-режим как запасной путь

Официальный API покрывает метрики мониторинга, и это основной путь. Для случаев, когда API недоступен или не отдаёт нужное (отдельные разделы есть только в веб-кабинете), у PostmastersTool есть запасной: автоматизация кабинета.

Честно об ограничениях: это автоматический браузер в изолированном контейнере, который заходит в кабинет под вашей учётной записью и снимает те же экраны. Он чувствителен к изменениям интерфейса Mail.ru, поэтому настраивается с нашей поддержкой; сессия хранится в зашифрованном виде (AES-256-GCM).

Рекомендуемый порядок: сначала официальный API, browser-режим — как резерв, который включается там, где API не закрывает задачу.

Как подключается PostmastersTool: 3 шага

  1. 1Добавьте домен в postmaster.mail.ru и подтвердите владение (DNS-запись).
  2. 2Получите пару токенов по короткой инструкции и вставьте refresh-токен в разделе «Интеграции» — мы храним его зашифрованным и сами обновляем access_token.
  3. 3Готово: синхронизация каждые 3 часа. Первые данные появятся с учётом лага источника (~1 день), история подтянется на глубину до года.

Дальше работают те же правила, что для Google: жалобы 0.1%/0.3%, доставка ниже 98%, baseline, «нет данных». Оба провайдера — на одном экране.

Смотреть интерфейс в демо

Частые вопросы

Зачем сервис, если кабинет Mail.ru бесплатный?

Кабинет нужно открывать и смотреть по каждому домену вручную — при нескольких доменах это ежедневная рутина. Мониторинг сам замечает превышения и доставляет алерт ответственному, плюс даёт единый экран с Google, инциденты и отчёты.

Что важнее: жалобы или письма в спаме?

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

Насколько безопасно отдавать токен?

Токен даёт доступ только к статистике ваших доменов, не к почте. Мы храним его в зашифрованном виде (AES-256-GCM); отключение интеграции удаляет токен у нас, а окончательно доступ отзывается перевыпуском токена в кабинете Mail.ru.

Читайте также

Google и Mail.ru — в одном экране

21 день на тарифе «Бизнес», без карты. Подключение Mail.ru — по короткой инструкции, данные появятся с учётом лага источника.