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

Będą Państwo potrzebować konta w serwisie Mailgun oraz dostępu do konfiguracji DNS swojej domeny.

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

1. Dodaj swoją domenę wysyłkową w Mailgun

W panelu Mailgun przejdź do Send → Domains → Add New Domain i wpisz subdomenę, na przykład mail.twojadomena.com.

⚠️ Mailgun zaleca użycie subdomeny, co w tym przypadku ma większe znaczenie niż u niektórych innych dostawców: Mailgun ustawia własne rekordy SPF i DKIM dla podanej wartości, a wskazanie domeny głównej sprawi, że rekordy te znajdą się obok tych, na których polegają Państwa biznesowe skrzynki pocztowe.

Wybierz region odpowiadający miejscu, w którym mają być przechowywane Państwa dane — US lub EU. Zapisz go; będzie potrzebny w kroku 4, a jego pomylenie jest najczęstszym błędem.

2. Opublikuj rekordy DNS podane przez Mailgun

Mailgun wyświetli listę. Dodaj każdy z nich u swojego dostawcy DNS.

⛔ Jeśli Państwa subdomena wysyłkowa ma już rekord SPF, zmodyfikuj go — nie dodawaj drugiego. Domena z dwoma rekordami SPF TXT całkowicie nie przechodzi weryfikacji SPF, co jest gorsze niż brak rekordu.

Następnie kliknij Verify DNS Settings w Mailgun. Zmiana statusu na zielony może potrwać do godziny.

⭐ Dodaj rekordy MX, nawet jeśli domena służy wyłącznie do wysyłki. W ten sposób Mailgun zbiera odbicia (bounces). Bez nich błędny adres odbija się w próżnię, Mailgun nie może go zablokować, a Państwo nadal płacą za wysyłkę na adres, który nigdy niczego nie odbierze.

3. Pobierz swój klucz API

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

Jeśli Państwa plan to umożliwia, użyj klucza wysyłkowego (sending key) ograniczonego do tej domeny, zamiast prywatnego klucza API konta. Klucz wysyłkowy pozwala wyłącznie na wysyłanie wiadomości; klucz prywatny umożliwia odczyt logów i modyfikację konta. Nie ma powodu, abyśmy posiadali ten drugi.

4. Połącz go w Zinn®

Otwórz sekcję Wysyłka e-mail w panelu i wypełnij pola:

• Dostawca — Mailgun
• Wysyłaj z tej domeny — mail.twojadomena.com (domena, nie adres e-mail)
• Domena wysyłkowa Mailgun — ta sama domena, którą dodano w Mailgun
• Region — us lub eu, zgodnie z krokiem 1
• Klucz API Mailgun — klucz z kroku 3

⛔⛔ Wybierz właściwy region. Konta Mailgun zlokalizowane w regionie EU są obsługiwane przez zupełnie inny host API. Przesłanie klucza konta EU do hosta US zwraca błąd „401 Unauthorized” — co wygląda dokładnie tak, jak użycie nieprawidłowego klucza. Jeśli klucz jest na pewno poprawny, a mimo to pojawia się błąd 401, niemal zawsze jest to przyczyną.

5. Wyślij wiadomość testową i wprowadź kod

Kliknij Wyślij wiadomość testową, używając skrzynki odbiorczej w innej domenie — idealnie sprawdzi się adres Gmail. Odczytaj kod z tej skrzynki odbiorczej i wprowadź go. Państwa poczta zostanie natychmiast przełączona.

Co zrobić, gdy konfiguracja nie działa

401 Unauthorized — nieprawidłowy region (patrz wyżej) lub wklejenie klucza z innego konta Mailgun. Zamiast wpisywać klucz ponownie ręcznie, wygeneruj go na nowo; początkowy fragment key- łatwo przeoczyć.

Wiadomość testowa nigdy nie dociera — sprawdź stronę Logs w serwisie Mailgun. Jeśli Mailgun w ogóle jej nie odnotował, dane uwierzytelniające lub nazwa domeny są nieprawidłowe. Jeśli Mailgun przyjął wiadomość, lecz wystąpił błąd na późniejszym etapie, przyczyna będzie tam jasno opisana — niemal zawsze dotyczy ona DNS.

„Domain not found” — pole Domena wysyłkowa Mailgun musi zawierać dokładnie taką domenę, jaką Mailgun podaje na liście, łącznie z subdomeną. Dla serwisu Mailgun twojadomena.com i mail.twojadomena.com to dwie różne domeny.

Działało, a potem przestało — sprawdź, czy okres próbny (free trial) nie dobiegł końca. Konta próbne Mailgun mogą wysyłać wiadomości wyłącznie do autoryzowanych odbiorców, dlatego wiadomość testowa na Państwa własny adres nadal działa, podczas gdy cała korespondencja do klientów po cichu zawodzi.