Solomono Инструкции E-mail сервисы ПОДКЛЮЧЕНИЕ MAILGUN

ПОДКЛЮЧЕНИЕ MAILGUN

Что будет настроено

  • Учётная запись Mailgun.

  • Отдельный почтовый поддомен, например mg.your-domain.com.

  • SPF, DKIM, две MX-записи и tracking CNAME в DNS.

  • Domain Sending Key для модуля Email Service в Solomono.

  • Дополнительно: SMTP-пользователь для системных писем магазина.

  • Безопасный тест одному получателю.

Что подготовить

  • Рабочий email-адрес для регистрации в Mailgun.

  • Доступ к DNS-панели домена магазина.

  • Доступ администратора к магазину Solomono.

  • Тестовый адрес получателя.

Внимание. Domain Sending Key и SMTP password являются секретами. Их нельзя отправлять в чатах, добавлять в инструкции или оставлять на скриншотах.


 

1. Зарегистрируйте учётную запись Mailgun

  1. Откройте https://signup.mailgun.com/.

  2. Введите имя, название компании и рабочий email-адрес.

  3. Если не хотите добавлять банковскую карту, снимите флажок Add payment info now.

Рисунок 1. Регистрация Mailgun без добавления карты

Внимание. Без карты Mailgun показывает ограничения бесплатной учётной записи. Тарифы и лимиты могут меняться, поэтому проверяйте актуальные условия на странице регистрации.

  1. Нажмите Create Account.

  2. Подтвердите email или введите проверочный код, который отправит Mailgun.

  3. Создайте пароль и завершите настройку двухфакторной аутентификации, если сервис её требует.

  4. После входа откроется Dashboard.

Рисунок 2. Главная страница Mailgun после входа

2. Добавьте отдельный поддомен

Рекомендуется подключать не основной домен, а отдельный поддомен, например mg.your-domain.com. Так настройки Mailgun не мешают обычной почте на адресах вида info@your-domain.com.

  1. В левом меню откройте Send → Sending → Domains.

  2. Нажмите Add new domain.

  3. Введите поддомен, например mg.your-domain.com, без https:// и без www.

  4. Выберите регион. Для уже созданного домена не меняйте регион без необходимости.

  5. Подтвердите создание домена.

Рисунок 3. Добавление почтового поддомена в Mailgun

3. Добавьте DNS-записи

  1. В Mailgun откройте Domain settings → DNS Records.

  2. В другой вкладке откройте DNS-панель вашего домена.

  3. Добавьте записи, которые показывает именно ваш кабинет Mailgun.

Тип и назначение

Пример для mg.your-domain.com

TXT — SPF для Mailgun

Host: mg; Value: v=spf1 include:mailgun.org ~all

TXT — DKIM-подпись

Host: selector._domainkey.mg; Value: длинный ключ из Mailgun

MX — получение почты

Host: mg; mxa.mailgun.org; Priority 10

MX — резервный сервер

Host: mg; mxb.mailgun.org; Priority 10

CNAME — tracking

Host: email.mg; Value: mailgun.org


 

Результат. Две MX-записи с одинаковыми host и priority не являются дублем: mxa и mxb нужны для резервирования.

Внимание. Не удаляйте MX-запись основного домена @, если она обслуживает вашу обычную почту. MX-записи Mailgun добавляются для host mg и не конфликтуют с корневым MX.

Внимание. Если _dmarc уже существует, не создавайте вторую запись. Политика основного домена обычно наследуется поддоменом. Добавляйте отдельный DMARC для поддомена только по требованию вашей политики или Mailgun.

  1. Сохраните DNS-записи. TTL можно оставить по умолчанию.

  2. Вернитесь в Mailgun и нажмите Check status.

  3. Дождитесь статусов Verified для SPF, MX и CNAME и Active для DKIM.

Рисунок 4. Успешная проверка DNS в Mailgun

Важно. Распространение DNS может занимать от нескольких минут до 24–48 часов.


 

4. Создайте Domain Sending Key

Domain Sending Key даёт доступ только к отправке через один домен. Это безопаснее, чем основной API key аккаунта.

  1. Откройте Domain settings → Sending Keys.

  2. Нажмите Add sending key.

  3. В поле Description введите понятное название, например SoloMono production.

Рисунок 5. Создание Domain Sending Key

  1. Нажмите Create sending key.

  2. Сразу скопируйте Sending API key. Mailgun показывает его только один раз.

Внимание. Для поля API KEY в Solomono используйте именно Domain Sending Key. Не используйте пароль Mailgun или SMTP password.

5. Включите Email Service в Solomono

  1. Войдите в административную панель магазина.

  2. Откройте Модули → SOLO модули.

  3. Найдите EMAIL_SERVICE_ENABLED и включите переключатель.

Рисунок 6. Модуль Email Service в Solomono

6. Подключите Mailgun через API

  1. Откройте Настройки → Интеграции → Email Service.

  2. В строке «Емейл Сервис» нажмите «изменить».

  3. В списке выберите Mailgun.

  4. В поле API KEY вставьте Domain Sending Key.

  5. В поле Domain введите поддомен полностью, например mg.your-domain.com.

  6. Нажмите OK.

Рисунок 7. Настройки Mailgun API в Solomono

7. Проверьте отправку

  1. Откройте страницу «Отправить Email Клиентам».

  2. Выберите отправку одному покупателю, а не всем клиентам.

  3. Укажите тестового получателя, тему и короткий текст.

  4. Отправьте письмо и проверьте папки «Входящие» и «Спам».

  5. В Mailgun откройте Reporting/Logs и убедитесь, что событие имеет статус Accepted или Delivered.

Рисунок 8. Форма безопасного теста одному получателю


 

Дополнительно: системные письма через SMTP

SMTP нужен для автоматических писем магазина, если ваша конфигурация Solomono использует SMTP отдельно от Email Service API.

8. Создайте SMTP-пользователя

  1. В Mailgun откройте Domain settings → SMTP Credentials.

  2. Нажмите Add new SMTP user.

  3. Введите уникальный login, например solomono-production.

  4. Оставьте Automatic password creation, если Mailgun предлагает этот вариант.

Рисунок 9. Создание SMTP-пользователя

  1. Нажмите Create.

  2. Скопируйте полный Login и Password. Пароль отображается только один раз.

Рисунок 10. Созданный SMTP-пользователь и параметры сервера

9. Заполните SMTP в Solomono

  1. Откройте Настройки → Интеграции → Настройки SMTP.

Поле Solomono

Значение Mailgun

SMTP Порт

587

SMTP Хост

smtp.mailgun.org

SMTP пароль

Password созданного SMTP-пользователя

SMTP Логин

Полный login, например solomono-production@mg.your-domain.com

SMTP Защита

tls

Проверка сертификата

Оставить текущее значение; изменять только по рекомендации поддержки


 

  1. Сохраните каждое поле.

Рисунок 11. SMTP-параметры Mailgun в Solomono

Внимание. SMTP password — не пароль от аккаунта Mailgun и не Domain Sending Key.

Типичные проблемы

Проблема

Что проверить

DNS не подтверждается

Host не содержит домен дважды; значения скопированы без лишних пробелов; подождите до 48 часов.

DKIM не Active

Селектор и длинный TXT-ключ полностью скопированы из Mailgun.

API authentication failed

Использован действующий Domain Sending Key, а Domain совпадает с доменом в Mailgun.

SMTP authentication failed

Использован полный SMTP login и SMTP password, а не пароль аккаунта.

Unable to connect

Host smtp.mailgun.org, порт 587, защита tls; хостинг не блокирует исходящий SMTP.

Rejected/Not delivered

Проверьте Mailgun Logs, адрес From, лимиты плана и suppression list.

Письмо в спаме

SPF/DKIM активны, DMARC не дублируется, адрес From соответствует домену, текст не похож на спам.


 

Контрольный список

□ Учётная запись Mailgun подтверждена.

□ Поддомен добавлен в Mailgun.

□ SPF, MX и CNAME имеют статус Verified; DKIM — Active.

□ Domain Sending Key создан и безопасно сохранён.

□ EMAIL_SERVICE_ENABLED включён.

□ В Solomono выбран Mailgun, сохранены API KEY и Domain.

□ Тестовое письмо одному получателю доставлено.

□ При необходимости SMTP настроен и протестирован.

Официальная документация Mailgun

Начало работы: https://documentation.mailgun.com/docs/mailgun/get-started

Custom domains: https://documentation.mailgun.com/docs/mailgun/user-manual/domains/domains-custom

DNS verification: https://documentation.mailgun.com/docs/mailgun/user-manual/domains/domains-verify

API keys: https://documentation.mailgun.com/docs/mailgun/user-manual/api-key-mgmt/rbac-mgmt

SMTP: https://documentation.mailgun.com/docs/mailgun/user-manual/sending-messages/send-smtp

Обновлено: 24/06/2026
icon