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-запис основного домену @, якщо він обслуговує вашу звичайну пошту. Mailgun MX додаються для 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