Jak przeprowadzić migrację z Mailchimp Transactional API do SendGrid

W 2016 r. Mandrill — obecnie znany jako Mailchimp Transactional API — stał się ekskluzywną usługą dodatkową do Mailchimp. Oznaczało to, że tylko miesięczni członkowie Mailchimp mieli dostęp do funkcji transakcji e-mail Mandrill. W przypadku innych użytkowników musieli albo wybrać inną platformę, albo zdecydować się na opłacenie konta Mailchimp, którego nie zawsze potrzebowali.

Zrozumieliśmy wtedy, że wielu klientów szukałoby alternatywnego dostawcy, który mógłby sprawnie wysyłać e-maile. Twilio SendGrid chciał, aby ten proces był tak płynny, jak to tylko możliwe.

Migracja z Mailchimp Transactional API do SendGrid

Jako ściśle dodatek, Mailchimp Transactional API nie jest skonfigurowany do niezawodnego dostarczania wiadomości e-mail na skalę, której potrzebujesz dla swojej firmy. Ale tutaj, w Twilio SendGrid, jesteśmy liderami w zakresie godnego zaufania, bezpiecznego dostarczania poczty e-mail, przetwarzając ponad 100 miliardów e-maili miesięcznie od naszych wiodących nadawców, w tym Ubera, Airbnb i Spotify.

W tym samouczku omówimy kluczowe zalety, których można oczekiwać podczas wysyłania wiadomości e-mail za pomocą usługi Twilio SendGrid. Nasz przewodnik po migracji krok po kroku zapewni płynne i sprawne przejście.

Dokumentacja Twilio SendGrid jest najlepszym źródłem informacji dla osób poszukujących odpowiedzi na wszystkie zapytania dotyczące SMTP, API i poczty e-mail. To świetne miejsce na rozpoczęcie, zanim zagłębisz się w bardziej szczegółowe szczegóły przenoszenia poczty i wykonywania wywołań API.

Ale najpierw, jeśli szukasz odpowiednika Twilio SendGrid niektórych funkcji interfejsu Mailchimp Transactional API, może pomóc poniższa tabela:

Uzyskiwanie klucza API

Aby rozpocząć, potrzebujesz konta Twilio SendGrid. Następnie będziesz chciał utworzyć klucz API, którego będziesz używać do wysyłania. Przejdź do Ustawienia → Klucze API lub użyj tego linku , jeśli jesteś zalogowany na swoje konto. Mądrą praktyką bezpieczeństwa jest używanie innego klucza API dla każdej z różnych aplikacji. Możesz również zdefiniować uprawnienia dla kluczy API, włączając lub wyłączając dostęp do odczytu lub zapisu dla poszczególnych punktów końcowych. Na razie potrzebujesz tylko takiego, który ma pełny dostęp do wysyłania poczty. (Uwaga: aby móc utworzyć klucz API, musisz przejść obsługę administracyjną).

Biblioteki API

Posiadamy szereg oficjalnie obsługiwanych bibliotek API , które dodatkowo optymalizują proces wysyłania wiadomości e-mail. Jeśli w ramach migracji piszesz dowolny kod lub refaktoryzujesz sposób komunikowania się z dostawcą usług poczty e-mail (ESP), teraz jest dobry moment, aby skorzystać z jednej z tych bibliotek, aby przyspieszyć integrację:

• sendgrid-csharp – oficjalna biblioteka C#
• sendgrid-go – oficjalna biblioteka Go
• sendgrid-java – oficjalna biblioteka Java
• sendgrid-nodejs – oficjalna biblioteka Node.js
• sendgrid-perl – Oficjalna biblioteka Perla
• sendgrid-php – oficjalna biblioteka PHP
• sendgrid-python – oficjalna biblioteka Pythona
• sendgrid-ruby – Oficjalna Biblioteka Rubinowa
• ti.sendgrid – Oficjalne opakowanie Titanium

SMTP

Jeśli nie korzystasz z jednej z naszych bibliotek i wysyłasz za pomocą Simple Mail Transfer Protocol lub SMTP, jest kilka różnic, które powinieneś znać. Aby uwierzytelnić się podczas wysyłania przez SMTP, podaj ciąg „apikey” jako nazwę użytkownika SMTP i użyj klucza API jako hasła. Następnie wskaż swoją nazwę hosta na smtp.sendgrid.net.

Możesz łączyć się za pomocą protokołu SMTP przez nieszyfrowany lub TLS na portach 25, 2525 i 587. Możesz też łączyć się przez SSL na porcie 465. Ogólnie zalecamy port 587, ponieważ zwykle powoduje on najmniej problemów z dostawcami usług hostingowych .

Mechanizmem dostosowywania wiadomości e-mail wysyłanych przez SMTP jest nasz nagłówek X-SMTPAPI . Ten nagłówek pozwoli Ci zdefiniować podstawienia, wysyłać grupowe żądania w stylu korespondencji seryjnej i kontrolować filtry (takie jak śledzenie kliknięć), które są aktywne podczas wysyłania.

HTTP

Głównym punktem końcowym wysyłania wiadomości e-mail jest punkt końcowy mail.send . Żądania do tego punktu końcowego można uwierzytelniać za pomocą nagłówka autoryzacji z kluczem API przedstawionym jako token okaziciela. Znajdź bardziej szczegółowy przykład w naszych dokumentach.

Personalizacje umożliwiają zdefiniowanie odbiorców i metadanych dla każdej wiadomości, takich jak wartości podstawień do dostosowywania treści lub custom_args do powiązania wiadomości z identyfikatorami użytkowników lub numerami zamówień. Istnieje kilka przykładów personalizacji dla typowych przypadków użycia. Możesz również znaleźć przykładowe wywołania cURL .

Funkcje, takie jak śledzenie kliknięć, można skonfigurować za pomocą parametrów tracking_settings i mail_settings .

W przypadku załączników wysyłanych przez HTTP postępuj z nimi w sposób podobny do interfejsu Mailchimp Transactional API, w którym treść jest zakodowana jako Base64 i osadzona bezpośrednio w ładunku JSON wraz z Multipurpose Internet Mail Extensions lub informacjami MIME, na przykład .

Należy zauważyć, że punkt końcowy mail.send usługi Twilio SendGrid jest całkowicie asynchroniczny. Zaakceptujemy żądanie — o ile jest prawidłowo sformułowane — i spróbujemy jak najszybciej przetworzyć jego dostarczenie. Mailchimp Transactional API umożliwia synchroniczne wykonywanie żądań mniej niż 10 e-maili. Jednak Twilio SendGrid nie oferuje trybu synchronicznego.

Możesz także zaplanować wysyłkę z 72-godzinnym wyprzedzeniem za pomocą parametru „send_at”.

Webhooki

Twilio SendGrid udostępnia dwa elementy webhook: element Webhook zdarzenia do publikowania zdarzeń w czasie rzeczywistym oraz element Webhook analizy przychodzącej poczty e-mail do odbierania wiadomości e-mail i programowego odpowiadania na nie. Kształty danych i ładunki różnią się nieco od tego, co oferuje Mailchimp Transactional API — Twilio SendGrid nie ma odpowiednika webhooka „sync”.

Punkty końcowe interfejsu API bez poczty e-mail

W przypadku punktów końcowych interfejsu API, które nie wysyłają wiadomości e-mail, zapoznaj się z omówieniem interfejsu API w wersji 3 . W większości przypadków stosujemy intuicyjne metody HTTP i kody odpowiedzi oraz wymuszamy limity stawek dla połączeń. Pomimo braku harmonogramu, aby przestać go wspierać, API v2 jest nadal dostępne w minimalnym stopniu. Wszystkie nowe integracje powinny jednak skłaniać się ku v3. Uwierzytelnianie API v3 jest dostępne za pośrednictwem nagłówka uwierzytelniania z tokenem Bearer .

Często zadawane pytania dotyczące migracji do usługi Twilio SendGrid

P: Czy obsługujecie szablony e-maili transakcyjnych?

O: Tak – a szablony są dynamiczne! Szablony transakcyjne Twilio SendGrid zawierają natywną obsługę składni Handlebars. Oprócz podstawowego zastępowania i podstawienia możesz używać wyliczeń/iteracji po listach, korzystać z warunków warunkowych i nie tylko. Aby dowiedzieć się więcej o naszych szablonach, kliknij tutaj .

P: Czy mogę przetestować moje e-maile bez konieczności ich wysyłania?

O: Możesz włączyć tryb piaskownicy podczas wysyłania e-maili przez HTTP. Istnieje również adres „sink”, którego możesz użyć do celów testowych.

P: Czy można przenieść mój adres IP/reputację nadawcy do Twilio SendGrid?

Odp.: Nie możemy przenieść adresu IP ani reputacji, ale możemy automatycznie pomóc w podgrzaniu nowego adresu IP .

P: czy Twilio SendGrid obsługuje wymuszone TLS?

O: Absolutnie. Nasze serwery odbierające obsługują TLS i odrzucają wiadomości wychodzące, które nie są zgodne.

P: Czy mogę zezwolić moim odbiorcom na zdefiniowanie typów wiadomości e-mail, które chcą otrzymywać?

O: Tak! Zapewnienie odbiorcom większej kontroli umożliwia wysyłanie e-maili do subskrybentów, którzy naprawdę ich chcą, co na dłuższą metę jest lepsze dla wszystkich. Sprawdź nasze grupy rezygnacji z subskrypcji, aby uzyskać więcej informacji.

P: Czy możesz wysyłać e-maile do wielu odbiorców na żądanie?

O: Tak. Klienci korzystający z interfejsu API v3 korzystający z personalizacji mogą obejmować do 1000 odbiorców na żądanie. Użytkownicy SMTP mogą obejmować do 10 000 adresatów na wiadomość, ale często zalecamy skorzystanie z 1000 adresatów na żądanie.

Dowiedz się więcej o przejściu z Mailchimp Transactional API na Twilio SendGrid