Mailgun do Mailtrap:

Przewodnik po migracji

Ten przewodnik 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 30 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 oferuje Bulk Stream, który pozwala wysyłać emaile do wielu odbiorców jednocześnie (newslettery, wiadomości marketingowe, aktualizacje produktów, itp.).
  4. Mailtrap posiada oddzielny produkt – Email Testing – do testowania emaili w środowisku stagingowym, sprawdzania wyników spamu, 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.
  5. 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żesz użyć rekordów return-path i DKIM.
  3. Gdy wysyłasz z nowo dodanej domeny, ruch sieciowy jest porządkowany w kolejkę lub wstrzymywany.
  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 uwierzytelniającymi 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 rozwieją wszelkie wątpliwości.

  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 wiele wysiłku. Wystarczy utworzyć konto, a następnie przejść do konfiguracji i weryfikacji domeny z poziomu strony głównej w aplikacji lub wybierając opcję Sending Domains w Email API. Więcej informacji możesz 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 50 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.io
bulk.smtp.mailtrap.io
smtp.eu.mailgun.orgsmtp.mailgun.org

Porty SMTP

PortFunkcja
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

Konfiguracja SMTP

Po pomyślnym zweryfikowaniu swojej domeny, wybierz tę domenę i przejdź do zakładki SMTP/API Settings, a następnie wybierz Transactional lub Bulk Stream w zależności od rodzaju wiadomości, jakie chcesz wysłać.

Skopiuj i wklej dane uwierzytelniające (dla wybranego strumienia) do swojej aplikacji lub projektu, a następnie prześlij emaila weryfikującego, aby sprawdzić poprawność 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

Tokeny API Mailtrap

Mailtrap automatycznie tworzy token po dodaniu domeny, 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.

Mapowanie API

Typ APIMailtrapMailgun
The BasicsGeneralIntroduction
SendingSend emailMessages
Email TestingEmail Testing API

Biblioteki API

Obecnie w Mailtrap dostępnych jest pięć bibliotek.

Język programowaniaMailtrapMailgun
NodeJSNodeJS SDKMailgunJS
RubyRuby SDKMailgun Ruby Gem
PHPPHP SDKMailgunPHP
PythonPython SDKNieobsługiwane
ElixirElixir SDKNieobsługiwane

Autentykacja API

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 biolerplate i sposobu użycia, przeczytaj stronę Mailtrap ActionMailer Balancer na Github.