Настройка интеграции с почтовым сервером

Данное руководство рассказывает о процессе настройки SMTP-сервера для отправки электронных писем. Вы узнаете, как подключить почтовый сервер, проверить настройки и отправить тестовое письмо.

Предварительные требования

Перед настройкой почтового сервера убедитесь, что:

У вас есть права администратора приложения
Имеются данные для подключения к SMTP-серверу
Почтовый сервер поддерживает подключения извне
Известны порты и параметры шифрования (SSL/TLS)

Необходимые данные:

Параметр	Где получить	Пример
Адрес сервера	У почтового провайдера	smtp.gmail.com
Порт	У почтового провайдера	587
Логин	Ваш email или спец. логин	user@gmail.com
Пароль	Пароль приложения	app_password
Шифрование	Требования провайдера	TLS/SSL

Обзор функционала

Функция настройки почты позволяет приложению отправлять:

Уведомления о событиях системы
Тестовые письма для проверки настроек
Сообщения пользователям приложения

Принцип работы:

┌─────────────────┐     ┌──────────────┐     ┌─────────────┐
│  Настройки SMTP │────>│  SMTP-сервер │────>│ Получатели  │
│  в приложении   │     │  провайдера  │     │  email      │
└─────────────────┘     └──────────────┘     └─────────────┘

Поддерживаемые протоколы:

SMTP — базовый протокол отправки почты
SSL — защищённое соединение (порт 465)
TLS — шифрование соединения (порт 587)

Переход к странице настроек

Войдите в приложение под учётной записью администратора
В главном меню выберите / Сервис / Настройки почты /

Откроется страница с двумя разделами: - Настройки почтового сервера (слева) - Отправка проверочного письма (справа)

Структура страницы

Раздел 1: Настройки почтового сервера

Поле	Обязательно	Описание
Адрес сервера	Да	DNS-имя или IP SMTP-сервера
Порт сервера	Да	Порт подключения (1-65535)
Email отправителя	Да	Адрес, с которого идут письма
SMTP логин	Нет	Логин для аутентификации
SMTP пароль	Нет	Пароль для аутентификации
Использовать SSL	Нет	Шифрование SSL (порт 465)
Использовать TLS	Нет	Шифрование TLS (порт 587)
Таймаут SMTP	Да	Время ожидания (1-60 секунд)

Раздел 2: Отправка проверочного письма

Поле	Обязательно	Описание
Текст сообщения	Да	Содержимое тестового письма
Получатель email	Да	Адрес для проверки доставки

Пошаговая инструкция настройки

Шаг 1. Заполнение основных параметров

Адрес сервера:

Введите DNS-имя SMTP-сервера вашего почтового провайдера.

Примеры: - Gmail: smtp.gmail.com - Yandex: smtp.yandex.ru - Mail.ru: smtp.mail.ru - Корпоративный: mail.company.local

Порт сервера:

Укажите порт для подключения:

Порт	Протокол	Провайдеры
25	SMTP без шифрования	Редко используется
465	SMTP + SSL	Gmail, Yandex
587	SMTP + TLS/STARTTLS	Большинство провайдеров
2525	Альтернативный SMTP	Некоторые провайдеры

Email отправителя:

Введите полный email-адрес, от имени которого приложение будет отправлять письма.

Важно: Адрес должен совпадать с логином или быть привязанным к учётной записи SMTP.

Шаг 2. Настройка аутентификации

SMTP логин:

Введите логин для подключения к SMTP-серверу.

Рекомендации: - Для Gmail используйте специальный пароль приложения - Для Yandex — пароль приложения из Яндекс.Ключа - Для корпоративной почты — учётные данные домена

SMTP пароль:

Введите пароль для аутентификации на SMTP-сервере.

Меры безопасности: - Пароль отображается в виде звёздочек - Максимальная длина — 32 символа - Хранится в базе данных приложения

Шаг 3. Настройка шифрования

Использовать SSL:

Установите флажок для подключения через SSL.

Когда использовать: - Порт 465 - Требуется защищённое соединение с момента подключения - Старые серверы без поддержки TLS

Использовать TLS:

Установите флажок для шифрования через TLS.

Когда использовать: - Порт 587 - Современный стандарт шифрования - Рекомендуется большинством провайдеров

Важно: Не включайте оба варианта одновременно. Выберите один метод шифрования в соответствии с требованиями почтового провайдера.

Шаг 4. Настройка таймаута

Таймаут SMTP (секунды):

Укажите время ожидания ответа от сервера в секундах.

Допустимые значения: 1-60 секунд

Рекомендации: - 1-5 секунд: Быстрые серверы в локальной сети - 5-15 секунд: Стандартные интернет-серверы - 15-30 секунд: Медленные или удалённые серверы - 30-60 секунд: Нестабильные каналы связи

Шаг 5. Сохранение настроек

Нажмите кнопку Сохранить в нижней части формы
Дождитесь уведомления об успехе
При ошибке проверьте правильность заполнения полей

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

Отправка тестового письма

Проверка настроек

После настройки SMTP-сервера рекомендуется отправить тестовое письмо:

В правой части страницы введите Текст сообщения
Укажите Получатель email (ваш действующий адрес)
Нажмите кнопку Отправить
Проверьте почтовый ящик получателя

Возможные результаты:

Результат	Сообщение	Действие
Успех	«Письмо успешно отправлено!»	Настройки верны
Ошибка авторизации	Сообщение об ошибке	Проверьте логин/пароль
Ошибка подключения	Таймаут или отказ	Проверьте адрес/порт
Ошибка получателя	Неверный email	Исправьте адрес

Примеры тестовых сообщений

Простой текст:

Проверка работы почтовых уведомлений приложения.

С информацией о времени:

Тестовое письмо от [дата] [время].
Если вы получили это письмо — настройки почты работают корректно.

Возможные проблемы и их решение

Ошибка подключения к серверу

Сообщение: «Connection timeout» или «Connection refused»

Возможные причины: - Неверный адрес сервера - Блокировка порта брандмауэром - Сервер недоступен из сети приложения

Решение: 1. Проверьте адрес SMTP-сервера 2. Убедитесь, что порт открыт 3. Проверьте доступность сервера командой ping 4. Настройте правила брандмауэра

Ошибка аутентификации

Сообщение: «Authentication failed» или «Invalid credentials»

Возможные причины: - Неверный логин или пароль - Требуется пароль приложения - Заблокирована менее защищённая аутентификация

Решение: 1. Перепроверьте учётные данные 2. Используйте пароль приложения (для Gmail/Yandex) 3. Включите доступ для сторонних приложений

Письма не доходят

Сообщение: Письмо отправлено, но не получено

Возможные причины: - Письмо попало в спам - Неверный адрес получателя - Проблемы на стороне почтового провайдера

Решение: 1. Проверьте папку «Спам» у получателя 2. Добавьте адрес отправителя в контакты 3. Проверьте логи почтового сервера

Ошибка «Неверный порт»

Сообщение: «This port number is invalid»

Причина: Введён порт вне диапазона 1-65535

Решение: Укажите корректный номер порта (рекомендуется 465 для SSL или 587 для TLS)

Ошибка «Таймаут вне диапазона»

Сообщение: «SMTP timeout must be between 1 and 60 seconds»

Причина: Введено значение вне диапазона 1-60

Решение: Укажите таймаут от 1 до 60 секунд

Сообщения об ошибках

При валидации и отправке писем приложение отображает следующие сообщения:

Сообщение	Причина	Решение
«Неверный номер порта»	Порт вне диапазона 1-65535	Укажите порт 25, 465 или 587
«Таймаут должен быть от 1 до 60 секунд»	Некорректное значение	Введите число от 1 до 60
«Письмо успешно отправлено!»	Успешная отправка	Проверьте почтовый ящик
«Настройки успешно сохранены»	Данные сохранены в БД	Можно отправлять письма
«Ошибка отправки email»	Проблема при отправке	Проверьте логи и настройки