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
- 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.
- Posiadając Mailtrap Możesz korzystać z rozliczeń/planów rocznych, nie tylko miesięcznych.
- 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.
- Mailtrap nie posiada opcji zaplanowania wysyłki emaili.
Porównanie terminologii
- User Management
- Email Templates
- Suppressions
- Email Categories
- Webhooks
- Headers
- X-MT-Custom-Variables
- Teammates
- SendGrid Templates
- Suppressions
- Categories
- Webhooks
- X-SMTPAPI
- unique_args
Ogólny przebieg migracji krok po kroku
-
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.
-
W przypadku korzystania z usługi SMTP należy odpowiednio zmienić ustawienia.
-
W przypadku korzystania z API należy sprawdzić biblioteki i dokumentację API.
-
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.
-
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
Port | Funkcja | Mailtrap | SendGrid |
587 | Zalecane do szyfrowanego połączenia z TLS SMTP | ||
25 | Może być problematyczne z powodu blokowania przez niektórych dostawców skrzynek pocztowych, w celu uniknięcia nadużyć | ||
2525 | Na potrzeby niezaszyfrowanych/TLS | ||
465 | Na 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 API | Mailtrap | SendGrid |
Email sending | Send email | |
User management | User management | Teammates |
Email Testing | Email Testing API |
Biblioteki API
Obecnie w Mailtrap dostępnych jest pięć bibliotek.
Język programowania | Mailtrap | Sendgrid |
NodeJS | NodeJS SDK | NodeJS |
Ruby | Ruby SDK | Ruby |
PHP | PHP SDK | PHP |
Python | Python SDK | Python |
Elixir | Elixir SDK | Nieobsł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.