Amazon SES do Mailtrap:
Przewodnik po migracji

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

Różnice między Amazon SES i Mailtrap

  1. Główna różnica między Amazon SES a Mailtrap polega na tym, że do ustawienia i integracji Mailtrap nie potrzebujesz zaawansowanych umiejętności i doświadczenia w programowaniu.
  2. Twoje emaile są przechowywane w Mailtrap Email Logs przez okres do 30 dni, w zależności od Twojego planu cenowego. Treści email i hard data równie przechowuje przez okres od 3 do 15 dni.
  3. Mailtrap oferuje plany z miesięcznym cyklem rozliczeniowym oraz możliwość wnioskowania o plan z rocznym rozliczeniem. 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ę.
  4. Mailtrap oferuje Email Testing. Jest to odrębny produkt służący do kontroli HTML/CSS, wyników spamu, itp. oraz debugowania emaili w środowisku stagingowym, deweloperskim i QA przed wysłaniem ich do odbiorców.
  5. Mailtrap oferuje Bulk Stream, który pozwala wysyłać emaile do wielu odbiorców jednocześnie (newslettery, wiadomości marketingowe, aktualizacje produktów, itp.).
  6. Kolejną kluczową różnicą między Amazon SES i Mailtrap jest sposób dostępu do wszystkich wskaźników. Mailtrap oferuje opcję Przejrzyste Statystyki, gdzie możesz uzyskać szczegółowe statystyki dla swoich emaili.
  7. Amazon SES nie pozwala na dodawanie opcji rezygnacji z subskrypcji do emaili bez kodowania.

Amazon SES i Mailtrap – podobieństwa

  1. Obsługa 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).

Porównanie terminologii

  • Identity and Access Management (IAM)
  • Template (CreateTemplate – API operation)
  • Account-level suppression list
  • Message Tags (najbliższe porównanie, ale logika jest inna)
  • Event Notifications
  • CONFIGURATIONSET (musisz utworzyć wszystkie nagłówki z wyprzedzeniem i przechowywać je w konfiguracji) lub używać

    SendRawEmail API method

  • Message Tags

Ogólny przebieg migracji krok po kroku

  1. Po zarejestrowaniu się w serwisie Mailtrap przejdź do Sending Domains. Dodaj swoją domenę i przejdź do jej weryfikacji.

  2. W przypadku wyboru serwisu 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 zapoznanie się z głównymi wskazanych wyżej różnicami między Amazon SES 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

    Użyj Ruby gem ActionMailer Balancer, aby proporcjonalnie rozłożyć obciążenie wysyłania emaili pomiędzy dwie różne usługi wysyłkowe (np. 60% AWS SES i 40% Mailtrap), aby zminimalizować ryzyko związane z wysyłaniem.

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 Sending.

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 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 Amazon SES.

SMTP

Przejście z usługi Amazon SES SMTP jest proste.Zapoznaj się z poniższe sekcje, aby lepiej zrozumieć kompatybilność i niezbędne kroki. 

Serwery wysyłania

Amazon Servers

live.smtp.mailtrap.io
bulk.smtp.mailtrap.io
email-smtp.us-east-2.amazonaws.com (+16 more) Show all
email-smtp.us-east-1.amazonaws.com
email-smtp-fips.us-east-1.amazonaws.com
email-smtp.us-west-1.amazonaws.com
email-smtp.us-west-2.amazonaws.com
email-smtp-fips.us-west-2.amazonaws.com
email-smtp.ap-south-1.amazonaws.com
email-smtp.ap-northeast-3.amazonaws.com
email-smtp.ap-northeast-2.amazonaws.com
email-smtp.ap-southeast-1.amazonaws.com
email-smtp.ap-southeast-2.amazonaws.com
email-smtp.ap-northeast-1.amazonaws.com
email-smtp.ca-central-1.amazonaws.com
email-smtp.eu-central-1.amazonaws.com
email-smtp.eu-west-1.amazonaws.com
email-smtp.eu-west-2.amazonaws.com
email-smtp.eu-west-3.amazonaws.com
email-smtp.eu-north-1.amazonaws.com
email-smtp.sa-east-1.amazonaws.com

Porty

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 APIMailtrapSES Naming
The BasicsGeneralWelcome
SendingSend emailSendEmail, SendRawEmail,
SendTemplatedEmail
Email TestingEmail Testing API

Biblioteki API

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

Język programowaniaMailtrapAmazon SES
NodeJSNodeJS SDKNieobsługiwane
RubyRuby SDKRuby SDK
PHPPHP SDKPHP SDK
PythonPython SDKPython SDK
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.