Перейти к содержанию

Отправка уведомлений

SMTP — сетевой протокол, предназначенный для передачи электронной почты.

Настройка

SMTP‑клиент по умолчанию отключён. Для его включения настройте следующие переменные окружения сервиса серверной части.

Переменная окружения Описание
SMTP_USERNAME Имя пользователя SMTP‑клиента
SMTP_PASSWORD Пароль пользователя SMTP‑клиента
SMTP_ADDRESS Адрес SMTP‑клиента в формате host:port или ip:port. Выбор номера порта влияет на использование TLS:
1. Порт 25 — без использования TLS (не рекомендуется).
2. Порт 465 — использование TLS.
3. Порт 587 — использование STARTTLS (рекомендуется)

Важно

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

Диагностика

Для отладки отправки сообщений необходимо запустить серверную часть с указанным для переменной окружения LOG_LEVEL значением debug.

  • Пример записи журнала, возникшей в результате отправки отладочного сообщения:

    2026-02-09T16:37:54.135274+03:00    DEBUG    server.api.smtpClient    New email    {"From": "smtp.solidlab.test@yandex.ru", "To": ["ivanov.ivan@solidlab.ru"], "Message": "MIME-version: 1.0;\nContent-Type: text/plain; charset=\"UTF-8\";\r\nContent-Transfer-Encoding: quoted-printable\r\nFrom: smtp.solidlab.test@yandex.ru\r\nTo: ivanov.ivan@solidlab.ru\r\nSubject: Registration for SolidPoint\r\n\r\n\nIvan, welcome to SolidPoint\n\nPlease wait until your organization’s administrator activates your account.\n\nYou are receiving this email because your email address was used to register for the SolidPoint dashboard. If this was not you, please ignore this message.\n\r\n"}
    

Следующие ошибки могут возникнуть, если SMTP‑клиент настроен и произвёл попытку отправить сообщение:

  • Ошибка аутентификации SMTP-клиента:

    2026-02-09T16:34:58.031329+03:00    ERROR    server.api.smtpClient    Failed to send email    {"error": "535 5.7.8 Error: authentication failed: Invalid user or password! 1770644098-vYR1awSGCOs0"}
    

    Возможные причины возникновения:

    1. Некорректные аутентификационные данные.
  • Ошибка хоста при отправке письма через SMTP-клиент:

    2026-02-09T16:36:22.502438+03:00    ERROR    server.api.smtpClient    Failed to send email    {"error": "dial tcp: lookup smtp..ru: no such host"}
    

    Возможные причины возникновения:

    1. Неверно указан адрес SMTP‑клиента.
    2. Проблемы DNS.
    3. Отсутствие подключения к сети.