Wysyłaj wiadomości e-mail za pośrednictwem własnego konta Mailgun

Będzie potrzebne konto w serwisie Mailgun oraz dostęp do DNS Państwa domeny.

Własna dokumentacja serwisu Mailgun: Dodawanie i weryfikacja domeny · Klucze API · Rejestracja

1. Dodawanie domeny wysyłkowej do serwisu Mailgun

W panelu sterowania serwisu Mailgun należy przejść do sekcji Send → Domains → Add New Domain i wpisać subdomenę, na przykład mail.twojadomena.pl.

⚠️ Własne wytyczne serwisu Mailgun zalecają użycie subdomeny i w tym przypadku ma to większe znaczenie niż u niektórych innych dostawców: Mailgun ustawia własne rekordy SPF i DKIM dla wskazanych przez Państwa zasobów, a skierowanie go na domenę główną oznacza, że rekordy te znajdą się obok tych, od których zależą Państwa firmowe skrzynki pocztowe.

Należy wybrać region odpowiadający lokalizacji, w której mają być przechowywane Państwa dane — US lub EU. Warto go zapisać; będzie on potrzebny w kroku 4 i jest to najczęściej popełniany błąd.

2. Publikowanie rekordów DNS udostępnionych przez serwis Mailgun

Mailgun wyświetla listę rekordów. Należy dodać każdy z nich u Państwa dostawcy DNS.

| Typ | Host | Przeznaczenie | | --- | --- | --- | | TXT | mail.twojadomena.pl | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.twojadomena.pl | Klucz publiczny DKIM | | CNAME | email.mail.twojadomena.pl | Śledzenie i obsługa zwrotów | | MX | mail.twojadomena.pl | Odbieranie zwrotów (dwa hosty MX serwisu Mailgun) |

⛔ Jeśli Państwa subdomena wysyłkowa posiada już rekord SPF, należy go edytować — nie dodawać drugiego. Domena z dwoma rekordami TXT SPF powoduje całkowity błąd weryfikacji SPF, co jest gorszym rozwiązaniem niż brak jakiegokolwiek rekordu.

Następnie należy kliknąć przycisk Verify DNS Settings w serwisie Mailgun. Zmiana statusu na zielony może potrwać do godziny.

⭐ Rekordy MX należy dodać nawet w przypadku korzystania wyłącznie z wysyłkowania. Służą one serwisowi Mailgun do zbierania informacji o zwrotach. Bez nich błędny adres trafia w próżnię, Mailgun nie może go zablokować, a Państwo ponoszą dalsze koszty wysyłania wiadomości na adres, który nigdy niczego nie otrzyma.

3. Uzyskiwanie klucza API

Send → Sending → Domain settings → API keys lub strona API Keys Państwa konta.

Zamiast prywatnego klucza API Państwa konta należy użyć klucza wysyłkowego przypisanego do tej domeny, jeśli plan Państwa go udostępnia. Klucz wysyłkowy umożliwia wyłącznie wysyłanie wiadomości; klucz prywatny pozwala na odczytywanie logów i modyfikowanie konta. Nie ma powodu, abyśmy przechowywali ten drugi.

4. Połączenie w systemie Zinn®

Należy otworzyć sekcję Wysyłanie e-maili w swoim panelu sterowania i uzupełnić następujące pola:

• Dostawca — Mailgun
• Wysyłaj z tej domeny — mail.twojadomena.pl (domena, a nie adres)
• Domena wysyłkowa Mailgun — ta sama domena, która została dodana w serwisie Mailgun
• Region — us lub eu, zgodnie z krokiem 1
• Klucz API Mailgun — klucz z kroku 3

⛔⛔ Należy poprawnie wskazać region. Konta w serwisie Mailgun hostowane w UE obsługiwane są przez całkowicie inny serwer API. Przekazanie klucza konta z UE do serwera w US zwraca komunikat "401 Unauthorized" — co jest odbierane dokładnie tak samo, jak w przypadku podania błędnego klucza. Jeśli klucz jest na pewno poprawny, a pojawia się błąd 401, najczęściej przyczyną jest właśnie to.

5. Wysłanie wiadomości testowej i wpisanie kodu

Należy kliknąć Send test message, używając skrzynki odbiorczej w innej domenie — idealnie sprawdza się adres w usłudze Gmail. Następnie należy odczytać kod z tej skrzynki odbiorczej i go wpisać. Obsługa poczty przełączy się natychmiast.

W przypadku problemów

401 Unauthorized — niewłaściwy region (patrz wyżej) lub wklejony klucz pochodzący z innego konta Mailgun. Klucz należy wygenerować ponownie zamiast go wpisywać; ciąg znaków key- na początku łatwo pominąć.

Wiadomość testowa nie dociera — należy sprawdzić stronę Logs w serwisie Mailgun. Jeśli Mailgun nie odnotował żadnego wpisu, oznacza to, że dane uwierzytelniające lub nazwa domeny są niepoprawne. Jeśli Mailgun zaakceptował wiadomość, a błąd wystąpił później, przyczyna zostanie tam opisana jasnym językiem i najczęściej dotyczy konfiguracji DNS.

„Domain not found” — pole Domena wysyłkowa Mailgun musi dokładnie odpowiadać domenie w takiej formie, w jakiej wyświetla ją Mailgun, łącznie z subdomeną. twojadomena.pl i mail.twojadomena.pl to dla serwisu Mailgun dwie różne domeny.

Działanie ustało po początkowym sukcesie — należy sprawdzić, czy nie wygasł okres próbny. Konta testowe w serwisie Mailgun mogą wysyłać wiadomości wyłącznie do autoryzowanych odbiorców, w związku z czym wiadomość testowa wysłana na własny adres wciąż działa, podczas gdy wysyłka do klientów przestaje działać bez żadnego komunikatu.