PODŁĄCZANIE MAILGUNA

Co zostanie skonfigurowane

• Konto Mailgun.

• Dedykowana pocztowa subdomena, na przykład mg.your-domain.com.

• SPF, DKIM, dwa rekordy MX oraz tracking CNAME.

• Domain Sending Key dla Solomono Email Service.

• Opcjonalne dane SMTP dla systemowych wiadomości e-mail sklepu.

• Bezpieczny test do jednego odbiorcy.

Co przygotować

• Działający adres e-mail dla konta Mailgun.

• Dostęp do panelu DNS domeny.

• Dostęp administratora do sklepu Solomono.

• Testowy adres odbiorcy.

Uwaga. Domain Sending Key i hasło SMTP należy traktować jak hasła. Nigdy nie umieszczaj ich na zrzutach ekranu ani w dokumentach.

 

1. Zarejestruj konto Mailgun

1. Otwórz https://signup.mailgun.com/.

2. Wprowadź swoje imię i nazwisko, nazwę firmy oraz służbowy adres e-mail.

3. Jeśli nie chcesz dodawać karty, odznacz Add payment info now.

Rysunek 1. Rejestracja Mailgun bez podawania danych płatniczych

Uwaga. Konta bez karty mają ograniczenia usługi. Ceny i limity mogą się zmieniać; sprawdź aktualną stronę rejestracji.

4. Kliknij Create Account.

5. Potwierdź adres e-mail lub wprowadź kod weryfikacyjny wysłany przez Mailgun.

6. Utwórz hasło i zakończ konfigurację uwierzytelniania dwuskładnikowego, jeśli zostaniesz o to poproszony.

7. Po zalogowaniu Mailgun otworzy Dashboard.

Rysunek 2. Dashboard Mailgun

2. Dodaj dedykowaną subdomenę

Użyj osobnej subdomeny, na przykład mg.your-domain.com. Dzięki temu rekordy Mailgun będą oddzielone od zwykłej poczty dla adresów takich jak info@your-domain.com.

8. Otwórz Send → Sending → Domains.

9. Kliknij Add new domain.

10. Wprowadź subdomenę bez https:// i bez www, na przykład mg.your-domain.com.

11. Wybierz wymagany region i utwórz domenę.

Rysunek 3. Dodawanie niestandardowej domeny Mailgun

3. Dodaj i zweryfikuj rekordy DNS

12. Otwórz Domain settings → DNS Records w Mailgun.

13. Otwórz swojego dostawcę DNS w nowej karcie przeglądarki.

14. Dodaj dokładnie te rekordy, które są wyświetlane na Twoim koncie Mailgun.

Typ i przeznaczenie	Przykład dla mg.your-domain.com
TXT — Mailgun SPF	Host: mg; Value: v=spf1 include:mailgun.org ~all
TXT — podpis DKIM	Host: selector._domainkey.mg; Value: długi klucz Mailgun
MX — odbiór poczty	Host: mg; mxa.mailgun.org; Priority 10
MX — serwer zapasowy	Host: mg; mxb.mailgun.org; Priority 10
CNAME — tracking	Host: email.mg; Value: mailgun.org

 

Rezultat. Dwa rekordy MX nie są duplikatami. Zarówno mxa, jak i mxb są wymagane do redundancji.

Uwaga. Nie usuwaj rekordu MX domeny głównej, jeśli obsługuje on Twoją zwykłą skrzynkę pocztową. Rekordy Mailgun używają hosta mg i nie zastępują rekordu MX dla @.

Uwaga. Nie twórz drugiego rekordu _dmarc, jeśli taki rekord już istnieje. Polityka domeny organizacyjnej zwykle obejmuje również subdomeny.

15. Zapisz rekordy i wróć do Mailgun.

16. Kliknij Check status.

17. SPF, MX i CNAME powinny mieć status Verified; DKIM powinien mieć status Active.

Rysunek 4. Zweryfikowane rekordy DNS Mailgun

Ważne. Propagacja DNS może potrwać od kilku minut do 24–48 godzin.

 

4. Utwórz Domain Sending Key

Domain Sending Key może wysyłać wiadomości tylko dla jednej domeny i jest bezpieczniejszy niż pełny klucz API konta.

18. Otwórz Domain settings → Sending Keys.

19. Kliknij Add sending key.

20. Wprowadź czytelny opis, na przykład SoloMono production.

Rysunek 5. Tworzenie Domain Sending Key

21. Kliknij Create sending key.

22. Natychmiast skopiuj Sending API key. Mailgun wyświetla go tylko jeden raz.

Uwaga. Użyj tego Domain Sending Key w polu API KEY w Solomono. Nie używaj hasła do konta ani hasła SMTP.

5. Włącz Email Service w Solomono

23. Zaloguj się do panelu administracyjnego sklepu.

24. Otwórz Moduły → SOLO modules.

25. Znajdź EMAIL_SERVICE_ENABLED i włącz go.

Rysunek 6. Moduł Email Service w Solomono

6. Połącz Mailgun przez API

26. Otwórz Settings → Integrations → Email Service.

27. Kliknij Change/Edit w wierszu Email Service.

28. Wybierz Mailgun.

29. Wklej Domain Sending Key do pola API KEY.

30. Wprowadź pełną subdomenę w polu Domain, na przykład mg.your-domain.com.

31. Kliknij OK.

Rysunek 7. Ustawienia API Mailgun w Solomono

7. Przetestuj dostarczanie

32. Otwórz Send Email to Customers.

33. Wybierz jednego klienta, a nie wszystkich klientów.

34. Wprowadź testowego odbiorcę, temat i krótką wiadomość.

35. Wyślij wiadomość i sprawdź foldery Odebrane oraz Spam.

36. Otwórz Mailgun Reporting/Logs i potwierdź status Accepted lub Delivered.

Rysunek 8. Formularz bezpiecznego testu do jednego odbiorcy

 

Opcjonalnie: systemowe wiadomości e-mail sklepu przez SMTP

Skonfiguruj SMTP, jeśli Twoja konfiguracja Solomono wysyła automatyczne wiadomości e-mail sklepu niezależnie od API Email Service.

8. Utwórz użytkownika SMTP

37. Otwórz Domain settings → SMTP Credentials.

38. Kliknij Add new SMTP user.

39. Wprowadź unikalny login, na przykład solomono-production.

40. Pozostaw Automatic password creation, jeśli ta opcja jest dostępna.

Rysunek 9. Tworzenie użytkownika SMTP Mailgun

41. Kliknij Create.

42. Natychmiast skopiuj pełny Login i Password. Hasło jest wyświetlane tylko jeden raz.

Rysunek 10. Utworzony użytkownik SMTP i ustawienia serwera SMTP Mailgun

9. Wprowadź ustawienia SMTP w Solomono

43. Otwórz Settings → Integrations → SMTP Settings.

Pole Solomono	Wartość Mailgun
SMTP Port	587
SMTP Host	smtp.mailgun.org
SMTP Password	Password utworzonego użytkownika SMTP
SMTP Login	Pełny login, na przykład solomono-production@mg.your-domain.com
SMTP Security	tls
Weryfikacja certyfikatu	Pozostaw bieżącą wartość, chyba że wsparcie zaleci inaczej

 

44. Zapisz każdą wartość.

Rysunek 11. Ustawienia SMTP Mailgun w Solomono

Uwaga. Hasło SMTP nie jest hasłem do konta Mailgun ani Domain Sending Key.

Typowe problemy

Problem	Co sprawdzić
DNS nie został zweryfikowany	Host nie zawiera domeny dwa razy; wartości nie mają dodatkowych spacji; odczekano do 48 godzin.
DKIM nie ma statusu Active	Skopiuj pełny selektor i klucz TXT dokładnie tak, jak pokazuje Mailgun.
API authentication failed	Użyj aktywnego Domain Sending Key i dokładnej domeny Mailgun.
SMTP authentication failed	Użyj pełnego loginu SMTP i hasła SMTP, a nie hasła do konta.
Unable to connect	Użyj smtp.mailgun.org, portu 587 i tls; upewnij się, że hosting nie blokuje wychodzącego SMTP.
Odrzucono lub nie dostarczono	Sprawdź Mailgun Logs, adres From, limity planu oraz suppression list.
Wiadomość trafia do spamu	SPF/DKIM są aktywne, DMARC nie jest zdublowany, a treść nie wygląda jak spam.

 

Lista kontrolna

□ Konto Mailgun zostało potwierdzone.

□ Subdomena wysyłkowa została dodana.

□ SPF, MX i CNAME mają status Verified; DKIM ma status Active.

□ Domain Sending Key został utworzony i bezpiecznie zapisany.

□ EMAIL_SERVICE_ENABLED jest włączony.

□ Mailgun, API KEY i Domain są zapisane w Solomono.

□ Wiadomość testowa do jednego odbiorcy została dostarczona.

□ W razie potrzeby SMTP zostało skonfigurowane i przetestowane.

Oficjalna dokumentacja Mailgun

Pierwsze kroki: 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