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

Когда пользователь пишет «не приходит письмо подтверждения», письмо застряло на одном из четырёх участков: не ушло из вашего приложения, не принято сервером получателя, принято и отфильтровано в спам или дошло так поздно, что код уже истёк. Проверяйте участки по порядку: почти каждый вопрос закрывает одна запись в журнале доставки с ответом принимающего сервера.
Ниже — чек-лист для владельца сайта или приложения, которому пишут в поддержку. Он начинается с фактов, которые нужно получить от пользователя, проходит по пути письма от кнопки «Зарегистрироваться» до папки «Входящие» и заканчивается тем, что поменять в продукте, чтобы таких обращений стало меньше.
Что спросить у пользователя
Три вопроса экономят полчаса переписки:
- Точный адрес, на который ждали письмо. Попросите скопировать его из профиля или из формы. Если человек наберёт адрес заново, он наберёт его правильно и спрячет от вас опечатку.
- Когда он нажал кнопку. Время с точностью до минуты нужно, чтобы найти запись в журнале.
- Какой почтовый сервис. 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— адрес в списке отписавшихся.- Записи нет совсем — письмо не ушло из приложения.
Если поддержка отвечает на такие обращения регулярно, дайте ей доступ к журналу. Это быстрее, чем пересылать вопрос разработчику.
Чек-лист
- Получите от пользователя точный адрес (скопированный, а не набранный), время и почтовый сервис.
- Попросите проверить «Спам», вкладки Gmail и правила фильтрации.
- Проверьте логи приложения и очередь задач рядом со временем отправки.
- Найдите письмо в журнале сервиса отправки; нет записи — проблема в приложении.
- Посмотрите статус:
dropped, отложено прогревом,deferred,bouncedилиdelivered. - Прочитайте ответ сервера получателя и сверьте его со справочником ошибок.
- Проверьте SPF, DKIM и DMARC домена бесплатным чекером.
- Убедитесь, что срок жизни кода переживает задержку доставки в несколько минут.
- Добавьте в продукт показ адреса, исправление адреса и обработку
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 не даст очереди отправить второй код вместо первого.