Не приходит письмо подтверждения: чек-лист для владельца сайта

Не приходит письмо подтверждения: чек-лист для владельца сайта

Когда пользователь пишет «не приходит письмо подтверждения», письмо застряло на одном из четырёх участков: не ушло из вашего приложения, не принято сервером получателя, принято и отфильтровано в спам или дошло так поздно, что код уже истёк. Проверяйте участки по порядку: почти каждый вопрос закрывает одна запись в журнале доставки с ответом принимающего сервера.

Ниже — чек-лист для владельца сайта или приложения, которому пишут в поддержку. Он начинается с фактов, которые нужно получить от пользователя, проходит по пути письма от кнопки «Зарегистрироваться» до папки «Входящие» и заканчивается тем, что поменять в продукте, чтобы таких обращений стало меньше.

Что спросить у пользователя

Три вопроса экономят полчаса переписки:

  1. Точный адрес, на который ждали письмо. Попросите скопировать его из профиля или из формы. Если человек наберёт адрес заново, он наберёт его правильно и спрячет от вас опечатку.
  2. Когда он нажал кнопку. Время с точностью до минуты нужно, чтобы найти запись в журнале.
  3. Какой почтовый сервис. Gmail, Яндекс Почта, Mail.ru, корпоративная почта на своём домене: у каждого свои фильтры и свои формулировки отказов.

Заодно попросите заглянуть в «Спам», а в Gmail ещё и во вкладки «Промоакции» и «Оповещения». Если письмо нашлось там, переходите сразу к шагу 4.

Шаг 1. Ушло ли письмо из приложения

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

  • Очередь задач стоит. Воркер Celery, Sidekiq или Laravel Queue упал после деплоя, задачи копятся, письма не получает никто. Если жалуются все новые пользователи разом, начните отсюда.
  • Ошибка проглочена. В Django send_mail(..., fail_silently=True) скрывает исключение SMTP. Функция mail() в PHP возвращает true, когда письмо принял локальный sendmail, и ничего не знает о его дальнейшей судьбе. Ищите в логах приложения ошибки рядом со временем регистрации.
  • Неверные учётные данные. Ответ 535 5.7.8 Authentication failed значит, что сервер отправки вас не пустил: поменялся пароль, токен удалили, в конфиге остался старый логин. Разбор этого ответа — на странице 535 5.7.8 Authentication failed.
  • Отправитель с чужого домена. Сервис отправки принимает письма только от подтверждённого домена. В FMailer адрес в From должен принадлежать подключённому домену, иначе письмо отклоняется при приёме, по SMTP и по API одинаково.
  • Исходящий SMTP закрыт хостингом. Библиотека ждёт таймаута, пользователь ждёт письма. Проверка занимает одну команду:
openssl s_client -starttls smtp -crlf -connect smtp.fmailer.ru:587

Если соединение не устанавливается, попробуйте дублирующие порты 8587 и 8465 или отправку через REST API по HTTPS: исходящий HTTPS хостинги не закрывают. Параметры подключения собраны в документации по SMTP.

Шаг 2. Принял ли письмо сервис отправки

Если приложение отработало без ошибок, найдите письмо в журнале сервиса по адресу получателя и времени. Исходов три.

Записи нет. Письмо до сервиса не дошло, и вы возвращаетесь к шагу 1. Часто выясняется, что приложение отправляет почту другим путём: через старый SMTP из забытой переменной окружения или через sendmail на самом сервере.

Письмо не отправлено, событие dropped. Сервис сам решил его не отправлять. В FMailer так происходит, когда адрес в списке отписавшихся: получатель когда-то отказался от всех писем, и отказ действует на письма с кодом тоже. Список открывается в панели, в разделе «Отписки». Удалить адрес оттуда можно, но только если человек сам просит вернуть письма: письмо тому, кто отписался, легко превращается в жалобу на спам.

Письмо ждёт в очереди. Новый домен отправляет столько, сколько разрешает прогрев. В FMailer домен стартует с 200 писем в сутки, суточный потолок удваивается от фактически доставленного объёма, а норма распределяется по часам. Письма сверх потолка принимаются и ждут, а в карточке письма появляется пометка «Отправка отложена: достигнут дневной лимит домена» со временем возобновления. Для кода подтверждения задержка в несколько часов равносильна недоставке. Если вы ждёте всплеск регистраций после рекламы, напишите в поддержку заранее: потолок для конкретного домена поднимают вручную. Подробности — на странице о лимитах отправки.

Шаг 3. Что ответил сервер получателя

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

Ответ в журнале Что это значит Что делать
250 2.0.0 OK Сервер получателя принял письмо Искать в спаме и фильтрах (шаг 4)
550 5.1.1 The email account that you tried to reach does not exist. Такого ящика у Gmail нет Проверить адрес на опечатку: разбор 5.1.1
No MX or A record for <domain> У домена получателя нет почтового сервера Почти всегда опечатка в домене: разбор
451/450 с упоминанием greylisting или «try again later» Временный отказ Дождаться повтора (раздел о грейлистинге ниже)
421 4.7.28 Our system has detected an unusual rate of unsolicited mail. Gmail ограничивает скорость приёма с вашего домена Разбор 4.7.28
550 5.7.26 Unauthenticated email from <domain> is not accepted due to domain's DMARC policy. Письмо не прошло SPF и DKIM с выравниванием Проверить записи домена: разбор 5.7.26
550 Message rejected under suspicion of SPAM. Mail.ru отказал по репутации и содержимому Разбор для Mail.ru
550 5.7.1 Message rejected under suspicion of SPAM. То же у Яндекса Разбор для Яндекса

Отказы бывают постоянные и временные. Код на 5 значит, что письмо не будет доставлено никогда и повтор не поможет. Код на 4 значит «попробуйте позже»: сервис отправки повторит попытку сам, а в журнале появится событие deferred. Если временные отказы идут часами, письмо формально ещё в пути, а код в нём уже бесполезен.

В FMailer по каждому письму виден настоящий ответ сервера получателя с кодом и текстом, а те же события приходят вебхуками: delivered, deferred, bounced, dropped. Обработчик bounced пригодится на шаге с опечатками.

Шаг 4. Доставлено, но не во «Входящих»

Ответ 250 значит, что сервер принял письмо. Дальше им распоряжаются фильтры получателя, и сервер отправки об этом уже не узнает. Куда смотреть:

  • «Спам». Если письмо там, причина в репутации домена, аутентификации или содержимом. Пользователь может нажать «Не спам», но это поможет одному человеку.
  • Вкладки Gmail. Письмо с кодом в «Промоакциях» обычно означает, что оно похоже на рассылку: картинки, баннеры, маркетинговый подвал. Письмо подтверждения стоит держать коротким и текстовым.
  • Правила и пересылка. У пользователя может стоять фильтр «всё с неизвестных адресов в архив» или пересылка на другой ящик, где письмо и лежит.
  • Корпоративный карантин. Защитные шлюзы в компаниях задерживают письма от новых отправителей. Пользователю придётся попросить своего администратора.

Если пользователь готов помочь, попросите его открыть полученное письмо, скопировать заголовки и вставить их в анализатор заголовков. Он покажет цепочку Received с задержкой на каждом переходе и вердикт самого получателя по SPF, DKIM и DMARC из Authentication-Results.

Опечатки в адресах: частая причина, которую не видно

Многие жалобы на письмо подтверждения объясняет опечатка: gmial.com, gmail.co, mail.ri, yandex.ry, лишняя точка, пропущенная буква в имени. Пользователь уверен, что ввёл адрес правильно, и ждёт письма, которое ушло в несуществующий ящик или не ушло вовсе.

Что помогает:

  • Показывайте адрес на экране ожидания: «Мы отправили код на ivan@gmial.com». Половина людей замечает ошибку сама.
  • Дайте исправить адрес с того же экрана, без новой регистрации.
  • Проверяйте домен при вводе. У домена без MX-записи письмо не может быть доставлено в принципе, а подсказка «Возможно, вы имели в виду gmail.com?» для популярных доменов ловит самые частые опечатки.
  • Слушайте отказы. Событие bounced с ответом 5.1.1 приходит через секунды после отправки. Если вебхук пометит регистрацию, пользователь увидит «адрес не существует» вместо бесконечного ожидания.

Аутентификация домена: SPF, DKIM и DMARC

Без аутентификации письмо с кодом попадает в спам или отклоняется, а с 2024 года Gmail требует от всех отправителей хотя бы SPF или DKIM и корректную обратную запись DNS для отправляющего IP. Проверить текущее состояние домена можно бесплатно, без регистрации: общая проверка DNS для почты показывает SPF, DKIM, DMARC и MX одним отчётом.

В FMailer записи не нужно составлять руками. Вы делегируете сервису поддомен, например mail.example.ru, через NS-записи, и FMailer сам публикует и поддерживает DKIM, SPF и DMARC. Порядок действий описан на странице настройки NS-записей. Отдельный поддомен полезен и здесь: репутация писем с кодами не смешивается с перепиской сотрудников.

Лимиты: ваши, сервиса и получателя

Письмо с кодом упирается в три разных ограничения.

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

Лимиты тарифа и прогрев. Превышение часового или месячного объёма тарифа в FMailer возвращается ошибкой (Hourly limit exceeded в API, 550 hourly limit exceeded по SMTP), и приложение должно её записывать в лог. Прогрев, наоборот, ничего не отклоняет и только откладывает отправку.

Ограничения получателя. Gmail отвечает 421 4.7.28, Яндекс — 451 4.7.1 Too many messages from your address. Try again later. (разбор). Оба отказа временные и связаны с тем, сколько и как быстро шлёт ваш домен. Часто упускают ещё одну причину: боты, которые регистрируют аккаунты на чужие адреса. Ваш сайт рассылает коды людям, которые ничего не просили, и они жмут «Спам». Капча или ограничение частоты на форму регистрации защищает и от этого.

Грейлистинг: письмо придёт, но позже

Грейлистинг — приём, при котором сервер получателя на первую попытку от незнакомого отправителя отвечает временной ошибкой и принимает письмо только при повторе. Механизм описан в RFC 6647; стандарт не фиксирует задержку, а на практике сервер ждёт от нескольких минут до получаса. Нормальный сервер отправки повторит попытку сам, а спамерский скрипт обычно нет: на этом расчёт и построен.

Для владельца сайта это значит две вещи. Во-первых, в журнале у такого письма будет deferred, затем delivered, и задержка между ними — время, на которое опоздал код. Во-вторых, если такие задержки повторяются только у получателей одного корпоративного домена, причина почти наверняка в настройках их сервера, и ускорить доставку с вашей стороны нельзя.

Срок жизни кода и повторная отправка

Код, который живёт пять минут, не переживёт грейлистинг, корпоративный карантин и человека, который отошёл за чаем. Разумный выбор — 10–15 минут для кода и сутки для ссылки подтверждения регистрации. Короткий таймер не нужен для защиты, если вы ограничиваете число попыток ввода: шанс угадать шестизначный код за пять попыток — пять на миллион.

Ещё два правила снимают большую часть обращений:

  • Новый код не должен молча убивать старый, пока старый не истёк. Иначе пользователь вводит код из первого письма, которое пришло последним, и получает «неверный код».
  • Повтор задачи не должен рождать второе письмо. Очередь, которая перезапускает упавшую задачу, отправит второй код с другими цифрами. В REST API FMailer для этого есть idempotency_key: повторный запрос с тем же ключом не создаёт новое письмо и возвращается с replayed: true. Ключом удобно сделать идентификатор попытки входа или регистрации.

Как журнал доставки закрывает спор

Без журнала разговор с пользователем идёт по кругу: «я не получил» — «мы отправили». С журналом у каждого письма есть время приёма, время доставки и строка ответа сервера получателя. Её можно показать человеку или переслать в поддержку его почтового сервиса.

Типичные развязки:

  • delivered через две секунды с ответом 250 — письмо у получателя, ищите в спаме и фильтрах.
  • bounced с 5.1.1 — опечатка в адресе, исправляйте адрес.
  • deferred несколько раз подряд, затем delivered через 40 минут — грейлистинг или ограничение скорости, код истёк, нужен новый.
  • dropped — адрес в списке отписавшихся.
  • Записи нет совсем — письмо не ушло из приложения.

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

Чек-лист

  1. Получите от пользователя точный адрес (скопированный, а не набранный), время и почтовый сервис.
  2. Попросите проверить «Спам», вкладки Gmail и правила фильтрации.
  3. Проверьте логи приложения и очередь задач рядом со временем отправки.
  4. Найдите письмо в журнале сервиса отправки; нет записи — проблема в приложении.
  5. Посмотрите статус: dropped, отложено прогревом, deferred, bounced или delivered.
  6. Прочитайте ответ сервера получателя и сверьте его со справочником ошибок.
  7. Проверьте SPF, DKIM и DMARC домена бесплатным чекером.
  8. Убедитесь, что срок жизни кода переживает задержку доставки в несколько минут.
  9. Добавьте в продукт показ адреса, исправление адреса и обработку bounced.

Частые ошибки

Отправка кода прямо в HTTP-запросе регистрации. Сетевой вызов к SMTP может занять секунды или зависнуть. Ставьте отправку в очередь и отвечайте пользователю сразу.

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

Одно доменное имя для кодов и рассылок. Жалобы на рассылку снижают репутацию домена, и вместе с ней падает доставка кодов. Разводите потоки по разным поддоменам.

Пометка письма с кодом как рассылки. Если отправлять код с флагом mass_mail: true, в нём появятся заголовки отписки. Одно нажатие «Отписаться» остановит и следующие коды для этого адреса.

Проверка только на своём ящике. Письмо, которое дошло до вашего Gmail, может не доходить до Mail.ru или до корпоративного сервера клиента. Держите тестовые ящики у основных провайдеров вашей аудитории.

Порт без шифрования в продакшене. По порту 25 без TLS пароль от SMTP уходит открытым текстом. Используйте 587 или 465, а при блокировке — 8587 или 8465.

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

Почему письмо подтверждения приходит через 20–30 минут?

Чаще всего это грейлистинг на стороне получателя или временное ограничение скорости: первая попытка получает 4xx, письмо доставляется при повторе. В журнале доставки это видно как одно или несколько событий deferred перед delivered. Второй вариант — очередь на вашей стороне или прогрев нового домена.

Письмо доставлено, но пользователь его не видит. Что ещё проверить?

Папку «Спам», вкладки Gmail, правила фильтрации и пересылку в настройках ящика. Если адрес корпоративный, письмо может держать в карантине защитный шлюз компании. Заголовки полученного письма покажут, через какие серверы оно прошло и какой вердикт по SPF, DKIM и DMARC вынес получатель.

Можно ли повторно отправить код тому, кто отписался?

Технически адрес можно удалить из списка отписавшихся в панели, но делать это стоит только по просьбе самого человека. Надёжнее до этого не доводить. Не ставьте флаг рассылки на письма с кодом, чтобы в них не было кнопки отписки, а рассылки отправляйте с темой подписки (topic): отказ от темы на странице настроек не затрагивает остальные письма.

Почему коды не доходят только до Mail.ru или только до Яндекса?

У каждого провайдера своя оценка репутации домена. Посмотрите ответ сервера в журнале: Mail.ru и Яндекс пишут причину текстом. Подключите домен к постмастерам: postmaster.mail.ru и Яндекс Постмастер показывают репутацию и долю жалоб бесплатно.

Какой срок жизни кода подтверждения выбрать?

Для одноразового кода разумны 10–15 минут при ограниченном числе попыток ввода, для ссылки подтверждения регистрации — сутки. Пять минут слишком мало: столько может занять одна задержка доставки.

Итог

Письмо подтверждения теряется в одном из четырёх мест: в приложении, в сервисе отправки, на сервере получателя или в его фильтрах. Порядок проверки всегда один и тот же: логи приложения, запись в журнале, ответ сервера получателя, папка «Спам». Журнал с настоящим SMTP-ответом превращает спор «отправили — не получил» в одну строку с кодом, а показ адреса, исправление опечатки и обработка bounced в самом продукте убирают большую часть обращений ещё до поддержки.

Попробовать FMailer

Подключите домен на fmailer.ru: делегируйте поддомен, и сервис сам опубликует DKIM, SPF и DMARC. В журнале каждого письма виден ответ сервера получателя, вебхуки сообщают о доставке и отказах, а idempotency_key в API не даст очереди отправить второй код вместо первого.

Подключить домен на fmailer.ru →