Mandrill (a.k.a Mailchimp Transactional Email) do Mailtrap:
Przewodnik Po Migracji

W tym przewodniku przedstawiono najważniejsze informacje na temat płynnej migracji z Mandrill (obecnie zwanym Mailchimp Transactional Email) do Mailtrap: główne różnice, porównania terminologii, konfiguracje SMTP i API oraz inne specyfikacje techniczne potrzebne do łatwej migracji.

Kluczowe Różnice Pomiędzy Mandrill and Mailtrap

  1. W zależności od planu cenowego Mailtrap przechowuje e-maile w Email Logs przez okres do 60 dni. Treść e-maili i twarde dane są przechowywane i dostępne od 3 do 15 dni bez żadnych dodatkowych opłat.
  2. Mailtrap oferuje Email Testing. Jest to osobny produkt umożliwiający sprawdzanie wyników spamu HTML/CSS itp., oraz debugowanie e-maili w środowiskach testowych, deweloperskich i kontroli jakości przed wysłaniem ich do odbiorców.
  3. Mailtrap obsługuje i wymaga automatycznej weryfikacji DMARC (wraz z SPF i DKIM).
  4. Mailtrap APIs akceptują i zwracają tylko JSON. Żądania API nie akceptują parametrów HTTP POST. Mailtrap nie zwraca odpowiedzi API w formatach XML i YAML.
  5. Mailtrap nie obsługuje zaplanowanego wysyłania e-maili.
  6. Mailtrap nie pozwala na automatyczne generowanie treści HTML z części wiadomości tekstowych i odwrotnie. Rodzaj treści należy określić w momencie wysyłania wiadomości e-mail lub tworzenia szablonu.

Porównanie terminologii

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

Ogólny proces migracji krok po kroku

  1. Zarejestruj się w Mailtrap, dodaj swoją domenę wysyłającą w sekcji Domeny Wysyłające i zweryfikuj ją. Więcej szczegółów znajdziesz w naszym Getting Started Guide.

  2. Jeżeli korzystasz z usługi SMTP zmień odpowiednio swoje ustawienia.

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

  4. Upewnij się, że rozumiesz kluczowe różnice między Mandrillem (Mailchimp Transactional Email) a Mailtrapem wspomnianym powyżej.

    Potrzebujesz pomocy?

    Skontaktuj się z naszą pomocą techniczną, a nasi eksperci Ci pomogą.

  5. Jeśli planujesz wysyłać ponad 200 tys. e-maili 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 ActionMailer Balancer Ruby gem, aby proporcjonalnie rozdzielić obciążenie wysyłaniem e-maili pomiędzy dwie różne usługi wysyłania (np. 70% Mandrill i 30% Mailtrap), aby zmniejszyć ryzyko wysyłania.

Rozpoczęcie

Aby rozpocząć wysyłanie e-maili za pomocą Mailtrap, wystarczy założyć konto, następnie zarejestrować się i zweryfikować swoją domenę. Konfigurację domeny i weryfikację można przeprowadzić na stronie głównej aplikacji lub na karcie Sending Domains w sekcji Sending.

Weryfikacja domeny

  • Po utworzeniu konta i dodaniu domeny wysyłającej kontrola bezpieczeństwa zajmie do dwóch dni roboczych.
  • Upewnij się, że nie wprowadzasz żadnych dodatków, poprawek ani innych zmian w czasie weryfikacji domeny, ponieważ może to zostać odebrane jako podejrzane zachowanie.
  • Do czasu zweryfikowania domeny przepustowość wysyłki ograniczona jest do 100 e-maili na godzinę, aby zapobiec nadużywaniu systemu przez działania spamowe. Więcej informacji na ten temat znajdziesz w naszym artykule dotyczącym limitów wysyłania.
  • Limity wysyłania można znieść, kontaktując się z zespołem pomocy technicznej Mailtrap. W takim przypadku będziesz musiał odpowiedzieć na szereg pytań, aby udowodnić wiarygodność i autorytet swojej domeny wysyłającej.

Wysyłanie za pomocą Mailtrap SMTP

SMTP Endpoints

Mandrill (Mailchimp Transactional)

live.smtp.mailtrap.io smtp.mandrillapp.com

SMTP Ports

PortFunctionMailtrap supportSendgrid support
587Zalecane w przypadku szyfrowanego połączenia TLS SMTP
25Może być problematyczne ze względu na blokowanie przez niektórych dostawców e-maili w celu uniknięcia nadużyć
2525Dla niezaszyfrowanych/TLS
465Do połączenia SSL SMTP

Konfiguracja SMTP

Po zarejestrowaniu się i zweryfikowaniu domeny wysyłającej przejdź do zakładki API and SMTP w karcie Sending Domains. Wybierz SMTP w Integrations.

Skopiuj i wklej podane dane uwierzytelniające SMTP do swojej aplikacji.

Uwaga: włączenie TLS jest obowiązkowe, jak wspomniano w poświadczeniach.

Wysyłanie za pomocą Mailtrap API

Mailtrap API tokens

Kiedy tworzysz domenę, automatycznie tworzony jest token i nazwany w oparciu o następującą formułę: [nazwa domeny] + [token] + [ID tokena]. Dodaj lub usuń uprawnienia tokena, klikając odpowiednie pola w menu Token.

Więcej o zarządzaniu tokenami API dowiesz się z naszego poradnika.

API Mapping

API typeMailtrapMandrill (Mailchimp Transactional)
Email sendingSend emailMessages
User managementUser managementUsers
Email TestingSandbox API

Biblioteki API

Obecnie w Mailtrap dostępne są cztery biblioteki.

Język programowaniaMailtrapMandrill (Mailchimp Transactional)
NodeJSNodeJS SDKNodeJS
RubyRuby SDKRuby
PHPPHP SDKPHP
PythonPython SDKPython

API Authentication

Mailtrap korzysta z Bearer authentication. Musisz więc przekazać token API w nagłówku Authorization w swoim e-mailu.

Zarządzanie uprawnieniami/Użytkownikami

Możesz dodawać użytkowników do swojego konta i zarządzać ich uprawnieniami, jeśli jesteś zarejestrowany w planie cenowym Business lub wyższym. Aby dodać użytkowników oraz przypisać i edytować ich uprawnienia, kliknij na zakładkę User Management i na trzy kropki po prawej stronie.

Pamiętaj, że użytkownik potrzebuje uprawnień Administratora, aby uzyskać uwierzytelnienie i wysyłać e-maile 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 ActionMailer Balancer, która sprawia, że ​​migracja jest płynna.

Opcja ActionMailer umożliwia proporcjonalne rozłożenie obciążenia związanego z wysyłaniem e-maili pomiędzy dwie różne usługi wysyłania oraz ograniczanie ryzyka związanego z wysyłaniem.

Po tym jak zainstalujesz Balancera w swojej aplikacji i wykonasz kilka drobnych konfiguracji, rozszerzy on metodę wysyłania ActionMailer.

Aby uzyskać bardziej szczegółowe informacje na temat szablonu i wykorzystania w rozwoju, wejdź na strone Mailtrap ActionMailer Balancer Github.