> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/knowledge-base/uvedomleniya-i-integracii/notification-center/email.md). # Почтовая доставка Подключение SMTP и Resend, отправитель, секреты и проверочное письмо Письма отправляются через отдельные подключения. Можно подготовить несколько почтовых сервисов, но каждый из них имеет собственный статус и набор включённых событий. Точный путь: **«Настройки» — «Общие настройки» — «Уведомления» — «Подключения»**. Для страницы требуется хотя бы одно из прав: «Настройки уведомлений» из блока «Настройки», «Telegram-уведомления» из блока «Админпанель» или «Общие настройки» из блока «Админпанель». Для обычной почтовой работы используйте минимальное право «Настройки уведомлений» из блока «Настройки». Права находятся по пути **«Пользователи» — «Список групп пользователей»**. Откройте нужную группу. ## Выбор сервиса | Вариант | Тип подключения | Когда подходит | | --------------------------- | --------------- | ---------------------------------------------------------------------------------------------- | | Zoho Mail | SMTP | Рабочая почта на собственном домене уже размещена в Zoho | | Gmail или Google Workspace | SMTP | Нужна отправка через отдельный Google-аккаунт и политика разрешает пароль приложения или relay | | Яндекс Почта или Яндекс 360 | SMTP | Рабочий ящик и домен обслуживаются Яндексом | | Resend | Resend | Нужна отдельная транзакционная доставка через API и подтверждённый домен | | Другой почтовый сервер | SMTP | Провайдер выдал сервер, порт, шифрование и учётные данные | Пошаговые инструкции: [Zoho Mail](/knowledge-base/uvedomleniya-i-integracii/notification-center/email/email-zoho.md), [Gmail и Google Workspace](/knowledge-base/uvedomleniya-i-integracii/notification-center/email/email-gmail.md), [Яндекс 360](/knowledge-base/uvedomleniya-i-integracii/notification-center/email/email-yandex.md), [Resend](/knowledge-base/uvedomleniya-i-integracii/notification-center/email/email-resend.md) и [другой SMTP-сервер](/knowledge-base/uvedomleniya-i-integracii/notification-center/email/email-smtp.md). Настройка доменных записей вынесена в отдельную статью [«SPF, DKIM и DMARC для почты»](/knowledge-base/uvedomleniya-i-integracii/notification-center/email/email-domain-authentication.md). ## Создание SMTP Откройте: **«Настройки» — «Общие настройки» — «Уведомления» — «Подключения»** Нажмите «Добавить», выберите тип «SMTP», задайте понятное название и нажмите «Создать». Затем откройте новое подключение и заполните: * «SMTP-сервер»; * «Порт»; * «Шифрование» — TLS, SSL или без шифрования; * «Логин», если он требуется сервером; * «Пароль», если он требуется сервером; * «E-mail отправителя»; * «Имя отправителя». Сервер и порт обязательны. Шифрование, логин и пароль зависят от почтового провайдера. Не считайте порт 587 или 465 универсальным: используйте параметры конкретного сервиса. Режим без шифрования подходит только для доверенного локального SMTP. ## Создание Resend Нажмите «Добавить», выберите «Resend» и создайте подключение. В настройке заполните: * «API-ключ»; * «E-mail отправителя»; * «Имя отправителя». API-ключ является секретом. Выдайте ему минимально необходимый доступ и не вставляйте значение в обращения поддержки. Домен отправителя должен быть подтверждён в Resend и разрешён доменными записями. Полная подготовка приведена в статье [«Подключение Resend»](/knowledge-base/uvedomleniya-i-integracii/notification-center/email/email-resend.md). ## Общие адреса В настройке почтового подключения доступны: * «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 уже зарегистрирован». Полный выбор режима описан в статье [«Настройки обмена»](https://docs.iexexchanger.com/knowledge-base/uvedomleniya-i-integracii/notification-center/pages/hECEwaBMg1t48LYQpRVJ#если-e-mail-уже-зарегистрирован). ## Что ещё нужно включить Одного рабочего подключения недостаточно. Проверьте все уровни: 1. **«Настройки» — «Общие настройки» — «Уведомления» — «Общие параметры»**: включены «Отправка уведомлений» и «Уведомления по E-mail». 2. В настройке почтового подключения включён переключатель «Подключение включено». 3. В действии «Уведомления» включено нужное событие на правильной вкладке — «Клиентам» или «Администраторам». 4. У клиента либо в «E-Mail адресах администраторов» заполнен фактический получатель. 5. Фоновая очередь обрабатывает задания без накопленных ошибок. 6. Провайдер принял сообщение, а принимающий сервер не отклонил его. Если письмо не пришло, следуйте статье [«Уведомление не пришло»](/knowledge-base/pomosh/diagnostic-method/notifications-missing.md). Записи домена отправителя описаны в [«SPF, DKIM и DMARC для почты»](/knowledge-base/uvedomleniya-i-integracii/notification-center/email/email-domain-authentication.md), а DNS у регистратора и Cloudflare — в разделе [«Сервер, домены и инфраструктура»](/knowledge-base/servery-i-domeny/overview.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.iexexchanger.com/knowledge-base/uvedomleniya-i-integracii/notification-center/email.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.