Почтовая доставка

Подключение SMTP и Resend, отправитель, секреты и проверочное письмо

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

Точный путь: «Настройки» — «Общие настройки» — «Уведомления» — «Подключения». Для страницы требуется хотя бы одно из прав: «Настройки уведомлений» из блока «Настройки», «Telegram-уведомления» из блока «Админпанель» или «Общие настройки» из блока «Админпанель». Для обычной почтовой работы используйте минимальное право «Настройки уведомлений» из блока «Настройки». Права находятся по пути «Пользователи» — «Список групп пользователей». Откройте нужную группу.

Выбор сервиса

Вариант	Тип подключения	Когда подходит
Zoho Mail	SMTP	Рабочая почта на собственном домене уже размещена в Zoho
Gmail или Google Workspace	SMTP	Нужна отправка через отдельный Google-аккаунт и политика разрешает пароль приложения или relay
Яндекс Почта или Яндекс 360	SMTP	Рабочий ящик и домен обслуживаются Яндексом
Resend	Resend	Нужна отдельная транзакционная доставка через API и подтверждённый домен
Другой почтовый сервер	SMTP	Провайдер выдал сервер, порт, шифрование и учётные данные

Пошаговые инструкции: Zoho Mail, Gmail и Google Workspace, Яндекс 360, Resend и другой SMTP-сервер. Настройка доменных записей вынесена в отдельную статью «SPF, DKIM и DMARC для почты».

Создание SMTP

Откройте:

«Настройки» — «Общие настройки» — «Уведомления» — «Подключения»

Нажмите «Добавить», выберите тип «SMTP», задайте понятное название и нажмите «Создать». Затем откройте новое подключение и заполните:

• «SMTP-сервер»;
• «Порт»;
• «Шифрование» — TLS, SSL или без шифрования;
• «Логин», если он требуется сервером;
• «Пароль», если он требуется сервером;
• «E-mail отправителя»;
• «Имя отправителя».

Сервер и порт обязательны. Шифрование, логин и пароль зависят от почтового провайдера. Не считайте порт 587 или 465 универсальным: используйте параметры конкретного сервиса. Режим без шифрования подходит только для доверенного локального SMTP.

Создание Resend

Нажмите «Добавить», выберите «Resend» и создайте подключение. В настройке заполните:

• «API-ключ»;
• «E-mail отправителя»;
• «Имя отправителя».

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

Общие адреса

В настройке почтового подключения доступны:

• «E-Mail адрес службы поддержки» — показывается клиентам как контакт для помощи;
• «E-Mail адреса администраторов» — получают включённые административные письма.

Несколько административных адресов разделяются запятыми. Эти адреса являются общими для почтовых подключений. Адрес фактического отправителя задаётся отдельно в каждом SMTP- или Resend-подключении.

Не смешивайте назначения:

• «E-mail отправителя» — адрес в поле From;
• «E-Mail адрес службы поддержки» — контакт, который видит клиент;
• «E-Mail адреса администраторов» — получатели служебных писем;
• «E-Mail для проверки» — временный получатель тестового письма.

Секреты и замена подключения

Сохранённый пароль или API-ключ полностью не отображается. Пустое поле при обычном сохранении не стирает секрет. Используйте явное изменение только для ротации значения.

При переходе на другого провайдера:

1. создайте новое подключение выключенным;
2. настройте DNS отправителя у провайдера домена;
3. отправьте тестовое письмо;
4. включите необходимые события;
5. включите новое подключение;
6. проверьте реальное клиентское и административное событие;
7. только после этого отключите прежнее подключение.

Тестовое письмо

Укажите «E-Mail для проверки» и нажмите «Отправить тест». Параметры подключения сохранятся перед отправкой.

Проверьте:

• появилось ли состояние «Стабильно»;
• дошло ли письмо во входящие или спам;
• совпадают ли имя и адрес отправителя;
• проходят ли SPF, DKIM и DMARC;
• корректны ли ссылки и локаль сообщения.

Тест подтверждает соединение и одно проверочное письмо, но не включает остальные события. После него откройте действие «Уведомления» и выберите фактические сценарии.

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

Состояние подключения

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

Состояние «Стабильно» не подтверждает каждое последующее письмо. Конкретная отправка может задержаться в очереди, быть отклонена провайдером, попасть под лимит или уйти в спам.

Коды входа по E-mail

Коды входа используются, когда гость вводит E-mail существующего аккаунта в форме обмена, а также в других включённых сценариях подтверждения. Для них важна не только настройка шаблона, но и фактическая передача каждого письма.

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

Настройка поведения заявки находится по пути «Настройки» — «Общие настройки» — «Основные» — «Обмен», поле «Если e-mail уже зарегистрирован». Полный выбор режима описан в статье «Настройки обмена».

Что ещё нужно включить

Одного рабочего подключения недостаточно. Проверьте все уровни:

1. «Настройки» — «Общие настройки» — «Уведомления» — «Общие параметры»: включены «Отправка уведомлений» и «Уведомления по E-mail».
2. В настройке почтового подключения включён переключатель «Подключение включено».
3. В действии «Уведомления» включено нужное событие на правильной вкладке — «Клиентам» или «Администраторам».
4. У клиента либо в «E-Mail адресах администраторов» заполнен фактический получатель.
5. Фоновая очередь обрабатывает задания без накопленных ошибок.
6. Провайдер принял сообщение, а принимающий сервер не отклонил его.

Если письмо не пришло, следуйте статье «Уведомление не пришло». Записи домена отправителя описаны в «SPF, DKIM и DMARC для почты», а DNS у регистратора и Cloudflare — в разделе «Сервер, домены и инфраструктура».