Mailgun do Mailtrap:

Przewodnik po Migracji

Przewodnik ten przedstawia kluczowe zasady łatwej migracji z Mailgun do Mailtrap: od porównań terminologicznych, przez konfiguracje SMTP/API, po specyfikacje techniczne dla gładkiego przejścia.

Różnice między Mailtrap i Mailgun

  1. Twoje emaile są przechowywane w Mailtrap Email Logs do 60 dni, w zależności od wybranego planu cenowego. Przechowujemy również treść emaili i hard data od 3 do 15 dni.
  2. Mailtrap oferuje plany z miesięcznym cyklem rozliczeniowym oraz możliwość wnioskowania o plan z rocznym rozliczeniem. W przeciwieństwie do Mailgun, Mailtrap nie posiada planu typu pay-as-you-go, ale mamy plan Free Forever z limitem 1000 emaili miesięcznie, aby przetestować i ocenić naszą usługę.
  3. Mailtrap posiada oddzielny produkt – Email Testing – do testowania twoich emaili w środowisku stagingowym, sprawdzania spam score, walidacji HTML i CSS, oraz kontroli dostarczalności u różnych dostawców skrzynek pocztowych. Co istotne, Mailtrap Email Testing służy wyłącznie do testowania emaili w bezpiecznym środowisku, bez wysyłania ich do odbiorców.
  4. Nie można zaplanować dostarczenia emaili później za pomocą Mailtrap.

Mailtrap i Mailgun – Podobieństwa

  1. Wsparcie dla wysyłania za pomocą SMTP lub REST API.
  2. Do weryfikacji domeny można użyć rekordów return-path i DKIM.
  3. Gdy wysyłasz z nowo dodanej domeny, throughput jest kolejkowany lub throttled.
  4. Możesz dodać plik .csv, aby zaimportować adresy email z ‘suppression list’ (listy wycofanych subskrypcji).
  5. Zarówno Mailgun, jak i Mailtrap umożliwiają dodawanie opcji rezygnacji z subskrypcji do emaili bez kodowania.   

Porównanie terminologii

  • Multi User Access
  • Mailgun Templates
  • Suppressions
  • Tags 
  • Webhooks
  • X-headers
  • X-Mailgun-Variables 

Ogólny przebieg migracji krok-po-kroku

  1. Po zarejestrowaniu się w Mailtrap, przejdź do zakładki “Sending Domains”. Dodaj swoją domenę i przejdź do jej weryfikacji.

  2. W przypadku wyboru usługi SMTP, zmień ustawienia wysyłania zgodnie z danymi poświadczeń podawanymi przez Mailtrap. Patrz informacje pod nagłówkiem SMTP poniżej.

  3. W przypadku integracji API, sprawdź dokumentację API i biblioteki Mailtrap.

  4. Poświęć czas na poznanie głównych wskazanych wyżej różnic między Mailgun i Mailtrap.

    Potrzebujesz pomocy?

    Skontaktuj się z naszymi specjalistami ds. pomocy i specjalistami ds. technicznych, którzy jej udzielą.

  5. Jeśli planujesz wysyłać ponad 200 tys. emaili miesięcznie – zdecydowanie zalecamy skontaktowanie się z pomocą techniczną Mailtrap. Chętnie Ci pomożemy. Po prostu umów się na rozmowę z członkiem naszego zespołu, a my upewnimy się, że Twoja migracja przebiega prawidłowo.

    Wskazówka dotycząca Mailtrap

    Możesz użyć Ruby gem ActionMailer Balancer w celu proporcjonalnego rozłożenia ładunku wysyłanych emaili pomiędzy dwa różne serwisy wysyłkowe (np. 60% w Mailgun a 40% w Mailtrap), aby zminimalizować zagrożenia związane z wysyłką.

Jak zacząć

Rozpoczęcie korzystania z Mailtrap nie wymaga zbyt wiele wysiłku. Wystarczy utworzyć konto, a następnie przejść do konfiguracji i weryfikacji domeny albo z poziomu strony głównej w aplikacji lub wybierając opcję „Sending Domains” w Email API. Więcej informacji można znaleźć w naszym „Getting Started Guide”, a tutaj przedstawiamy krótką instrukcję.

Weryfikacja domeny

  • Po zarejestrowaniu się, a następnie dodaniu i weryfikacji Twojej domeny, przechodzi ona kontrolę bezpieczeństwa, która zwykle trwa dwa dni robocze. W tym czasie przepustowość jest ograniczona do 100 emaili na godzinę, aby zapobiec przeciążeniu systemu. Przeczytaj nasz artykuł o “Sending Limits“, aby dowiedzieć się więcej.
  • Podczas kontroli bezpieczeństwa krytyczne znaczenie ma to, aby nie usuwać, ani nie dodawać niczego ponownie, ponieważ będzie to uważane za zachowanie rodzące podejrzenia.
  • Zwiększenie limitu można uzyskać zgłaszając się do pomocy technicznej, gdzie trzeba będzie odpowiedzieć na kilka pytań celem potwierdzenia wiarygodności swojej domeny.
  • Upewnij się, że ustawiłeś opcje rezygnacji z subskrypcji w Mailtrap i zaimportowałeś suppression lists z Mailgun.

SMTP

SMTP Endpoints

Mailgun Server (EU) Mailgun Server (US)
live.smtp.mailtrap.iosmtp.eu.mailgun.orgsmtp.mailgun.org

SMTP Ports

PortFunction
587Zalecany SMTP relay z TLS
25Duży ruch, zablokowany przez niektórych dostawców skrzynek pocztowych z powodu przeciążenia
2525Alternatywny port, w przypadku problemów z innymi portami
465Na potrzeby połączenia SSL SMTP

Konfiguracja SMTP

Po pomyślnym zweryfikowaniu domeny wybierz “SMTP” w obszarze „Integrations”.

Skopiuj i wklej poświadczenia do swojej aplikacji lub projektu, a następnie wyślij email z potwierdzeniem w celu zweryfikowania konfiguracji. Zapoznaj się z artykułem „Sending Domain Setup”, aby uzyskać więcej informacji na temat tego, jak to zrobić.

Uwaga: Włączenie TLS jest obowiązkowe, jak wspomniano w uwierzytelnieniach.

API

Mailtrap API tokens

Mailtrap automatycznie tworzy token, gdy tworzysz domenę, i domyślnie token ma uprawnienia dostępu Domain Admin. Możesz edytować uprawnienia dla tego tokenu, aby autoryzować go z innymi domenami na Twoim koncie.

Zapoznaj się z treścią naszej instrukcji, aby uzyskać więcej informacji o zarządzaniu tokenami API.

API Mapping

API typeMailtrapMailgun
The BasicsGeneralIntroduction
SendingSend emailMessages
Email TestingEmail Testing API

Biblioteki API

Obecnie w Mailtrap dostępne są cztery biblioteki.

Język programowaniaMailtrapMailgun
NodeJSNodeJS SDKMailgunJS
RubyRuby SDKMailgun Ruby Gem
PHPPHP SDKMailgunPHP
PythonPython SDKNot supported

API Authentication

Mailtrap wykorzystuje uwierzytelnienia Bearer. Dlatego musisz przekazać token API pod nagłówkiem “Authorization” Twojego emaila.

Zarządzanie użytkownikami

Począwszy od planu “Business” w Mailtrap Email API, możesz dodawać użytkowników do swojego konta i zarządzać ich uprawnieniami. Kliknięcie w “User Management” pokazuje wszystkich użytkowników w danym koncie, gdzie możesz łatwo dodawać nowych członków i przydzielać im uprawnienia.

Na podstawie uprawnień, które użytkownicy uzyskają, będą mogli przeglądać, uzyskiwać dostęp i/lub modyfikować określone funkcje aplikacji. Należy pamiętać, że użytkownik potrzebuje uprawnień administratora, aby uzyskać uwierzytelnienie i wysyłać wiadomości email za pośrednictwem interfejsu API.

Przeczytaj więcej o zarządzaniu uprawnieniami użytkowników.

ActionMailer Balancer dla płynnej migracji

W przypadku aplikacji Ruby on Rails Mailtrap oferuje rozszerzenie ActionMailer Balancer, które ułatwia migrację. Rozszerzenie ActionMailer pozwala na proporcjonalne rozłożenie obciążenia wysyłania wiadomości email między dwoma różnymi serwisami wysyłającymi i zmniejszenie zagrożeń związanych z wysyłaniem.

Zainstalowanie Balancera w aplikacji i przeprowadzenie kilku drobnych konfiguracji poszerzy zakres metody wysyłania ActionMailer.

Aby uzyskać bardziej szczegółowe informacje na temat boilerplate i użycia w rozwoju, przeczytaj stronę Mailtrap ActionMailer Balancer na Github.