Mailgun do Mailtrap:
Przewodnik migracji
Ten przewodnik obejmuje podstawowe zasady płynnej migracji z Mailgun do Mailtrap: porównanie terminologii, konfiguracje SMTP lub API oraz inne wymagania techniczne potrzebne do sprawnej zmiany.

Kluczowe różnice między Mailgun a Mailtrap
- Mailtrap oferuje miesięczne plany subskrypcyjne z możliwością przejścia na rozliczenie roczne. W przeciwieństwie do Mailgun, nie mamy modelu pay-as-you-go, ale dostępny jest bezpłatny plan Free Forever (1000 e-maili), który umożliwia przetestowanie naszej usługi.
- Mailtrap oferuje Email Testing – to sandbox e-mailowy do analizy HTML/CSS, ocen spamowych i debugowania wiadomości w środowiskach staging/dev/QA, zanim trafią do skrzynki odbiorczej odbiorcy. (Uwaga: Mailgun w tym celu zaleca korzystanie z narzędzia Email on Acid od firmy Sinch).
- Mailgun ogranicza funkcjonalność kont, które nie mają dodanej karty kredytowej. W Mailtrap takie ograniczenia nie obowiązują.
- Mailtrap posiada osobne strumienie (punkty końcowe serwera) dla e-maili masowych oraz wiadomości wyzwalanych przez użytkowników.
- Mailtrap oferuje kreator szablonów HTML oraz edytor typu drag-and-drop (przeciągnij i upuść), podczas gdy Mailgun wspiera wyłącznie szablony HTML i rekomenduje korzystanie z Mailjet firmy Sinch jako zewnętrznego narzędzia do budowania szablonów i edycji „przeciągnij i upuść”.
Mailtrap i Mailgun – podobieństwa
- Obsługa wysyłki zarówno przez SMTP, jak i REST API.
- Możliwość weryfikacji domeny za pomocą rekordów return-path oraz DKIM.
- Import adresów z list wykluczonych oraz list mailingowych w formacie .csv.
- Opcja dodania linku do anulowania subskrypcji bez potrzeby kodowania.
- Możliwość planowania kampanii e-mailowych w obu usługach (w przypadku Mailgun tylko przez API).
- Obie usługi wspierają uwierzytelnianie dwuskładnikowe (2FA).
Porównanie terminologii
- User Management
- Templates
- Suppressions
- Email Categories
- Webhooks
- Headers
- X-MT-Custom-Variables
- Multi User Access
- Mailgun Templates
- Suppressions
- Tags
- Webhooks
- X-headers
- X-Mailgun-Variables
Ogólny przebieg migracji – krok po kroku
-
Po zarejestrowaniu się w Mailtrap, wybierz menu Sending Domains. Dodaj swoją domenę i przejdź do jej weryfikacji. Szczegóły znajdziesz w naszym Przewodniku dla początkujących.
-
Jeśli wybierasz usługę SMTP, zaktualizuj ustawienia wysyłki zgodnie z danymi uwierzytelniającymi udostępnionymi przez Mailtrap. Więcej informacji znajdziesz w sekcji SMTP poniżej.
-
Jeśli decydujesz się na integrację API, sprawdź dokumentację API oraz biblioteki Mailtrap.
-
Wyeksportuj swoją listę kontaktów z Mailgun w formacie CSV* i zaimportuj ją do Mailtrap. Zobacz nasz Przewodnik dla początkujących.
Potrzebujesz pomocy?
Skontaktuj się z naszym zespołem wsparcia – nasi eksperci techniczni chętnie pomogą Ci na każdym etapie.
-
Możesz także zaimportować swoje szablony e-maili jako HTML lub stworzyć nowe za pomocą edytora HTML lub kreatora typu drag-and-drop (przeciągnij i upuść). Więcej informacji znajdziesz w Przewodniku po szablonach e-maili.
-
Wysyłasz więcej niż 200 000 e-maili miesięcznie? Zdecydowanie zalecamy kontakt z zespołem Mailtrap, który pomoże Ci przejść przez cały proces, przypisze dedykowany adres IP i sprawdzi, czy wszystko jest prawidłowo skonfigurowane.
Porada Mailtrap
Możesz skorzystać z gema Ruby ActionMailer Balancer, aby proporcjonalnie rozdzielić ruch e-mailowy między dwa systemy wysyłkowe (np. 70% Mailgun, 30% Mailtrap), co pozwala zminimalizować ryzyko związane z migracją.
*W momencie pisania tego tekstu listy mailingowe w Mailgun można było eksportować wyłącznie przez API (wywołanie GET), z limitem 100 rekordów.
Pierwsze kroki
Aby rozpocząć wysyłanie e-maili za pomocą Mailtrap, wystarczy utworzyć konto i zweryfikować swoją domenę. Konfigurację i weryfikację domeny przeprowadza się w menu Sending Domains. Przeczytaj ten artykuł aby dowiedzieć się więcej o tym procesie.
Weryfikacja domeny
- Po zweryfikowaniu swojej domeny przy użyciu dostarczonych rekordów DNS, przechodzi ona automatyczną kontrolę zgodności. Proces ten zwykle trwa od kilku minut do kilku godzin. E-maile można wysyłać dopiero po pełnym przejściu kontroli zgodności i po zobaczeniu statusu “zweryfikowana” obok swojej domeny.
- Kolejnym krokiem jest skonfigurowanie opcji anulowania subskrypcji w Mailtrap oraz zaimportowanie z Mailgun Twoich list wykluczeń w formacie CSV. Nie zapomnij również o zaimportowaniu listy kontaktów i szablonów HTML do Mailtrap, aby w pełni odtworzyć swoją konfigurację.
- Dodatkowo, jeśli chcesz mieć lepszy wgląd w działanie swojej wysyłki, możesz utworzyć webhooki, które automatycznie poinformują Cię o zdarzeniach takich jak odbicia, zgłoszenia spamu, otwarcia wiadomości czy kliknięcia w linki.
- Na koniec warto także włączyć śledzenie otwarć i kliknięć, aby lepiej zrozumieć, jak Twoi odbiorcy reagują na wiadomości e-mail i wchodzą z nimi w interakcję.
Wysyłka przez Mailtrap SMTP
Punkty końcowe SMTP
Serwer Mailgun (UE) | Serwer Mailgun (USA) | |
live.smtp.mailtrap.io bulk.smtp.mailtrap.io | smtp.eu.mailgun.org | smtp.mailgun.org |
Porty SMTP
Port | Funkcja |
587 | Zalecany serwer SMTP z TLS. |
25 | Duży ruch – może być blokowany przez niektórych dostawców skrzynek pocztowych ze względu na ryzyko nadużyć. |
2525 | Alternatywny port – użyj go, jeśli napotkasz problemy z innymi portami. |
Konfiguracja SMTP
Przejdź do zakładki Sending Domains i kliknij zweryfikowaną domenę, z której chcesz wysyłać e-maile. Przejdź do zakładki “Integration” i kliknij Integruj w Transakcyjne lub Wysyłanie masowe, w zależności od typu e-maili, które chcesz wysłać.
Skopiuj dane uwierzytelniające (dla wybranego strumienia) i wklej je do swojej aplikacji lub projektu – i gotowe, możesz zacząć wysyłać e-maile. Więcej informacji o integracji SMTP znajdziesz tutaj.
Uwaga: Włączenie szyfrowania TLS jest obowiązkowe – ta informacja znajduje się również w danych dostępnych w panelu integracji.
Wysyłanie za pomocą API Mailtrap
Tokeny API Mailtrap
Mailtrap automatycznie tworzy token po dodaniu domeny. Domyślnie token ma uprawnienia Administratora Domeny. Można edytować uprawnienia tokena w menu Tokeny API w Ustawieniach.
Dowiedz się więcej o zarządzaniu tokenami API w naszym przewodniku.
Mapowanie API
Typ API | Mailtrap | Mailgun |
The Basics | General | Introduction |
Sending | Send email | Messages |
Email Testing | Email Testing API |
Biblioteki API
Obecnie w Mailtrap dostępnych jest dziewięć bibliotek.
Język programowania | Mailtrap | Mailgun |
Node.js | Node.js SDK | MailgunJS |
NodeMailer (Node.js) | NodeMailer SDK | Nieobsługiwany |
PHP | PHP SDK | MailgunPHP |
PHP (Laravel + Symphony) | PHP SDK | Nieobsługiwany |
Ruby | Ruby SDK | Gem Ruby do Mailgun |
Ruby (ActionMailer) | ActionMailer SDK | Nieobsługiwany |
Python | Python SDK | Nieobsługiwany |
Elixir | Elixir SDK | Nieobsługiwany |
Java | Java SDK | Mailgun Java |
Uwierzytelnianie API
Używamy uwierzytelniania Bearer. Umieść token API w kodzie w nagłówku Authorization.
Uprawnienia/Zarządzanie użytkownikami
Jeśli korzystasz z planu Business lub wyższego, możesz dodawać użytkowników do swojego konta i zarządzać ich uprawnieniami. Aby to zrobić, przejdź do zakładki User Management w menu Settings, a następnie kliknij trzy kropki (więcej menu) po prawej stronie. Możesz także zarządzać użytkownikami i uprawnieniami za pomocą API.
W zależności od przyznanych uprawnień, użytkownicy mogą przeglądać, uzyskiwać dostęp i/lub modyfikować określone funkcje aplikacji. Pamiętaj, że użytkownik potrzebuje uprawnień Admina, aby móc się uwierzytelnić i wysyłać wiadomości przez API.
Dodatkowo Mailtrap umożliwia włączenie lub wyłączenie uwierzytelniania dwuskładnikowego (2FA) dla wszystkich lub wybranych użytkowników, z opcją wymuszenia 2FA dla całego konta. Sprawdź nasz Przewodnik 2FA , aby dowiedzieć się więcej.
Jeśli chcesz dowiedzieć się więcej o zarządzaniu uprawnieniami użytkowników, kliknij ten link ◀️.
ActionMailer Balancer – płynna migracja
Dla aplikacji opartych na Ruby on Rails, Mailtrap oferuje ActionMailer Balancer, który ułatwia płynne przejście na nową usługę wysyłkową.
Rozszerzenie ActionMailer pozwala na proporcjonalne rozłożenie obciążenia wysyłki wiadomości między dwie różne usługi i zmniejsza ryzyko związane z migracją.
Po zainstalowaniu Balancera i wprowadzeniu drobnych konfiguracji, metoda wysyłania wiadomości w ActionMailer zostaje rozszerzona.
Więcej szczegółów, przykładowy kod i instrukcję użycia w środowisku developerskim znajdziesz na stronie Mailtrap ActionMailer Balancer Github.