Mailchimp Transactional Email do Mailtrap:
Przewodnik po migracji

Ten przewodnik przedstawia kluczowe zasady łatwej migracji z Mailchimp Transactional Email do Mailtrap: od kluczowych różnic, po porównania terminologiczne, konfiguracje SMTP/API i specyfikacje techniczne zapewniające płynne przejście.

Kluczowe różnice pomiędzy Mailchimp Transactional Email i Mailtrap

  1. W zależności od planu cenowego Mailtrap przechowuje emaile w Email Logs do 30 dni. Wiadomości email i hard data przechowuje się z możliwością wglądu przez okres od 3 do 15 dni bez dodatkowych opłat.
  2. 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.
  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 obsługuje i wymaga automatycznej weryfikacji DMARC (razem z SPF i DKIM).
  5. Interfejsy API Mailtrap akceptują i zwracają tylko JSON. Żądania API nie akceptują parametrów HTTP POST. Mailtrap nie odsyła odpowiedzi API w formatach XML i YAML.
  6. Mailtrap nie obsługuje zaplanowanego wysyłania emaili.
  7. Mailtrap nie pozwala na automatyczne generowanie zawartości HTML z części wiadomości tekstowych i odwrotnie. W momencie wysyłania emaili lub tworzenia szablonu typ treści musi być określony.

Porównanie terminologii

  • Users
  • Templates
  • Rejection Blacklist
  • Tags
  • Webhooks
  • Headers
  • X-MC-Metadata

Ogólny przebieg migracji krok po kroku

  1. Zarejestruj się na Mailtrap, dodaj swoją domenę nadawczą w Sending Domains i zweryfikuj ją. Zapoznaj się z treścią naszej instrukcji Getting Started Guide, aby uzyskać więcej szczegółów.

  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ę, że rozumiesz kluczowe różnice między Mailchimp Transactional Email i Mailtrap wymienione powyżej.

    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 Mailchimp Transactional Email 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ć się 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żna 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

Mailchimp Transactional Email
live.smtp.mailtrap.io
bulk.smtp.mailtrap.io		 smtp.mandrillapp.com

Porty SMTP

PortFunkcjaMailtrapMailchimp
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

Podczas tworzenia 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 APIMailtrapMailchimp Transactional Email
Email sendingSend emailMessages
User managementUser managementUsers
Email TestingEmail Testing API

Biblioteki API

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

Język programowaniaMailtrapMailchimp Transactional Email
NodeJSNodeJS SDKNodeJS
RubyRuby SDKRuby
PHPPHP SDKPHP
PythonPython SDKPython
ElixirElixir SDKNieobsługiwane

Autentykacja API

Mailtrap używa uwierzytelniania Bearer. Musisz więc przekazać token API pod nagłówkiem Authorization Twojego emaila.

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ń Admin, 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.