SendGrid do Mailtrap:
Przewodnik po migracji

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

Kluczowe różnice pomiędzy SendGrid i Mailtrap

  1. W zależności od planu cenowego, Mailtrap przechowuje emaile w Email Logs do 30 dni. Wiadomości email i dane historyczne są przechowywane z możliwością wglądu przez okres od 3 do 15 dni bez dodatkowych opłat.
  2. Posiadając Mailtrap Możesz korzystać z rozliczeń/planów rocznych, nie tylko miesięcznych.
  3. 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.
  4. Mailtrap nie posiada opcji późniejszego wysyłania emaili.

Porównanie terminologii

  • Teammates
  • SendGrid Templates
  • Suppressions
  • Categories
  • Webhooks
  • X-SMTPAPI
  • unique_args

Ogólny przebieg migracji krok po kroku

  1. Zarejestruj się w Mailtrap, dodaj swoją domenę nadawczą w zakładce Sending Domains i zweryfikuj ją. Więcej szczegółów znajdziesz w naszym Getting Started Guide.

  2. W przypadku korzystania z usługi SMTP należy odpowiednio zmienić ustawienia.

  3. W przypadku korzystania z API należy sprawdzić biblioteki i dokumentację API.

  4. Upewnij się, czy rozumiesz, na czym polegają wyżej wymienione kluczowe różnice pomiędzy SendGrid a 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. 70% w SendGrid a 30% w Mailtrap), aby zminimalizować zagrożenia związane z wysyłką.

Jak zacząć

Aby rozpocząć wysyłanie wiadomości email z Mailtrap, wystarczy utworzyć konto, a następnie zarejestrować i zweryfikować swoją domenę. Konfigurację i weryfikację domeny można przeprowadzić na stronie głównej aplikacji lub w zakładce Sending Domains w sekcji Sending.

Weryfikacja domeny

  • Po utworzeniu konta i dodaniu swojej domeny wysyłania, weryfikacja pod kątem bezpieczeństwa potrwa do dwóch dni roboczych.
  • Upewnij się, że nie wprowadzasz żadnych dodatkowych ustawień, poprawek ani innych zmian w czasie weryfikacji domeny, ponieważ może to zostać odebrane jako podejrzane zachowanie.
  • Do momentu zweryfikowania domeny przepustowość wysyłania jest ograniczona do 50 emaili na godzinę, aby zapobiec zasypywaniu systemu przez działania o charakterze spamu. Dowiedz się więcej na ten temat z naszego artykułu Sending Limits.
  • Limity wysyłania możesz zwiększyć kontaktując się z zespołem wsparcia Mailtrap. W takim wypadku należy udzielić odpowiedzi na kilka pytań, aby udowodnić wiarygodność i autorytet swojej domeny wysyłania.

Wysyłanie za pomocą Mailtrap SMTP

SMTP Endpoints

live.smtp.mailtrap.io
bulk.smtp.mailtrap.io		smtp.sendgrid.net

Porty SMTP

PortFunkcjaMailtrapSendGrid
587Zalecane do szyfrowanego połączenia z TLS SMTP
25Może być problematyczne z powodu blokowania przez niektórych dostawców skrzynek pocztowych, w celu uniknięcia nadużyć
2525Na potrzeby niezaszyfrowanych/TLS
465Na potrzeby połączenia SSL SMTP

Konfiguracja SMTP

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

Skopiuj i wklej dane uwierzytelniające SMTP (dla wybranego strumienia) do swojej aplikacji.

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

Wysyłanie za pomocą Mailtrap API

Tokeny API Mailtrap

Po utworzeniu domeny, token i jego nazwa tworzą się automatycznie według następującego wzoru: [nazwa domeny] + [token] + [token ID]. Dodaj lub usuń uprawnienia tokena, klikając odpowiednie pola w menu Token.

Dowiedz się więcej o zarządzaniu tokenami API w naszym przewodniku.

Mapowanie API

Typ APIMailtrapSendGrid
Email sendingSend emailMail
User managementUser managementTeammates
Email TestingEmail Testing API

Biblioteki API

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

Język programowaniaMailtrapSendgrid
NodeJSNodeJS SDKNodeJS
RubyRuby SDKRuby
PHPPHP SDKPHP
PythonPython SDKPython
ElixirElixir SDKNieobsługiwane

Autentykacja API

Używamy uwierzytelnienia Bearer. Przekaż token API do kodu pod nagłówkiem Authorization.

Uprawnienia/zarządzanie użytkownikami

Możesz dodawać użytkowników do swojego konta i zarządzać ich uprawnieniami w przypadku korzystania z planu cenowego Business lub wyższego. Aby dodać użytkowników oraz przypisać i edytować ich uprawnienia, kliknij w zakładkę Manage users, a następnie trzy kropki po prawej stronie.

Zauważ, że użytkownik potrzebuje uprawnień administratora, aby uwierzytelnić się i wysyłać emaile za pomocą 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.