Настройка модуля «SMTP (встроенный)»

Встроенная отправка email через SMTP — настраивается в «Настройки сайта». Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

• Проектам, где письма должны уходить стабильно и от имени домена площадки.
• Владельцам, которые хотят управлять регистрационными, платежными и сервисными письмами через надежного провайдера.
• Командам, которым важно заранее проверить SPF, DKIM, DMARC и репутацию отправителя.

Что изменится на сайте

• Системные письма отправляются через «SMTP (встроенный)» вместо неуправляемой почтовой схемы.
• Владелец настраивает домен отправителя и снижает риск попадания писем в спам.
• Транзакционные письма легче отлаживать через логи провайдера.
• Регистрация, восстановление доступа и сервисные уведомления становятся надежнее.

Что подготовить заранее

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

• Подготовьте домен отправителя и адрес, с которого пользователи будут получать письма.
• Настройте SPF, DKIM и DMARC, если провайдер требует подтверждение домена.
• Получите API-ключ или SMTP-доступ в кабинете «SMTP (встроенный)».
• Подготовьте тестовый почтовый ящик для проверки доставки и внешнего вида письма.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «SMTP (встроенный)» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «From email». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное.
• «SMTP host». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное.
• «SMTP password». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах.
• «SMTP port». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное. Значение по умолчанию: 587.
• «SMTP user». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий.

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

Проверка перед запуском

• Отправьте тестовое письмо на рабочий почтовый адрес.
• Проверьте отправителя, тему, ссылки и отображение письма на мобильном устройстве.
• Если письмо попало в спам, проверьте DNS-записи и логи провайдера.
• Проверьте ошибку при неверном ключе или SMTP-пароле.

Частые ошибки

• Письмо не доставлено. Проверьте API-ключ, SMTP-доступ и DNS-записи домена.
• Письмо попадает в спам. Проверьте SPF, DKIM, DMARC и репутацию отправителя.
• Ссылки в письме ведут не туда. Проверьте публичный домен сайта и шаблоны уведомлений.
• Провайдер отклоняет отправку. Проверьте лимиты аккаунта и подтверждение домена.

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