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

Отправка email через Mailgun API — надёжная доставка, аналитика. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

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

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

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

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

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

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

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

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

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

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

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

• «API Key». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах.
• «Sending domain (подтверждённый)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное.
• «From — отправитель в письмах». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное.
• «Регион API (us | eu)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: us.

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

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

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

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

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

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