SendGrid do Mailtrap:
Przewodnik migracji

Ten przewodnik opisuje kluczowe zasady migracji z SendGrid do Mailtrap: porównanie terminologii, konfiguracje SMTP lub API oraz niezbędne parametry techniczne do sprawnego przejścia.

Kluczowe różnice między SendGrid a Mailtrap

  1. W zależności od wybranego planu, Mailtrap przechowuje wiadomości e-mail w logach przez okres do 30 dni. Treść wiadomości i dane historyczne są dostępne przez 3 do 7 dni – bez dodatkowych opłat.
  2. W Mailtrap możesz wybrać rozliczenie roczne, nie tylko miesięczne.
  3. Mailtrap oferuje Email Testing – to osobny produkt do analizowania HTML/CSS, ocen spamowych i debugowania wiadomości w środowiskach staging/dev/QA przed wysłaniem ich do odbiorców.

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ę wysyłkową w zakładce Sending Domains i ją zweryfikuj. Szczegóły znajdziesz w naszym Przewodniku dla początkujących.

  2. Jeśli korzystasz z usługi SMTP, zaktualizuj odpowiednio swoje ustawienia.

  3. Jeśli korzystasz z API, sprawdź nasze biblioteki i dokumentację API.

  4. Wyeksportuj swoją listę kontaktów z SendGrid jako CSV i zaimportuj ją do Mailtrap. Sprawdź nasz przewodnik krok po kroku, aby dowiedzieć się, jak to zrobić..

    Potrzebujesz pomocy?

    Skontaktuj się z naszym zespołem wsparcia – nasi eksperci techniczni chętnie pomogą Ci na każdym etapie.

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

  6. 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% SendGrid, 30% Mailtrap), co pozwala zminimalizować ryzyko związane z migracją.

Pierwsze kroki

Aby rozpocząć wysyłanie e-maili za pomocą Mailtrap, wystarczy utworzyć konto i zweryfikować swoją domenę. Konfiguracja i weryfikacja domeny odbywa się w menu Sending Domains. Przeczytaj ten artykuł, aby dowiedzieć się więcej o tym procesie.

Weryfikacja domeny

  • Gdy Twój domena zostanie zweryfikowana przy użyciu dostarczonych rekordów DNS, przejdzie automatyczną kontrolę zgodności. Proces ten zazwyczaj trwa od kilku minut do kilku godzin. E-maile można wysyłać dopiero po pełnym zakończeniu kontroli zgodności i po zobaczeniu statusu “zweryfikowane” obok swojej domeny.
Karta weryfikacji domeny – domena zweryfikowana
  • Ustaw opcje rezygnacji z subskrypcji w Mailtrap i zaimportuj swoje listy blokad z SendGrid. Przypomnienie: zaimportuj swoją listę e-mailową i szablony HTML do Mailtrap.
  • Opcjonalnie możesz utworzyć webhooki, aby otrzymywać informacje o odbiciach, zgłoszeniach spamu, otwarciach, kliknięciach i innych zdarzeniach.
  • Włącz śledzenie otwarć i kliknięć, by lepiej zrozumieć, jak odbiorcy wchodzą w interakcję z Twoimi wiadomościami.

Wysyłka przez Mailtrap SMTP

Punkty końcowe SMTP

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

Porty SMTP

PortFunkcjaWsparcie MailtrapWsparcie SendGrid
587Zalecane do połączeń SMTP z szyfrowaniem TLS
25Może powodować problemy ze względu na blokowanie przez niektórych dostawców skrzynek pocztowych w celu zapobiegania nadużyciom
2525Dla połączeń nieszyfrowanych/TLS

Konfiguracja SMTP

Przejdź do zakładki Sending Domains, a następnie kliknij zweryfikowaną domenę, z której chcesz wysyłać wiadomości. Przejdź do zakładki Integrations i kliknij Integruj pod Transakcyjne lub Wysyłanie masowe – w zależności od tego, jakiego rodzaju e-maile zamierzasz wysyłać.

Karta wyboru Integration w Sending Domains Mailtrap

Skopiuj i wklej dane uwierzytelniające (dla wybranego typu strumienia) do swojej aplikacji lub projektu – i możesz zacząć wysyłać wiadomości. Więcej o integracji SMTP przeczytasz tutaj.

Integracja SMTP Strumienia masowej wysyłki Mailtrap

Uwaga: Włączenie TLS jest obowiązkowe – informacja o tym znajduje się w danych uwierzytelniających.

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 APIMailtrapSendGrid
Email sendingSend emailMail
User managementUser managementTeammates
Email TestingEmail Testing API

Biblioteki API

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

Język programowaniaMailtrapSendGrid
Node.jsNode.js SDKNodeJS
NodeMailer (Node.js)NodeMailer SDKNieobsługiwany
PHPPHP SDKPHP
PHP (Laravel + Symphony)PHP SDKNieobsługiwany (dostępny jeden nieoficjalny sterownik społeczności)
RubyRuby SDKRuby
Ruby (ActionMailer)ActionMailer SDKJedna biblioteka społeczności
PythonPython SDKPython
ElixirElixir SDKTylko biblioteki społeczności
JavaJava SDKJava

Uwierzytelnianie API

Mailtrap korzysta z uwierzytelniania typu Bearer. Token API należy przekazać 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.

Menu User Management Mailtrap

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.