Jak przeprowadzić migrację z Mailgun do SendGrid

Jeśli Mailgun jest Twoim obecnym dostawcą usług poczty e-mail i chcesz wprowadzić zmiany, ten poradnik pomoże Ci przeprowadzić migrację do SendGrid, podkreślając różnice między tymi dwiema usługami.

Jeśli chcesz się rozejrzeć, zanim zaczniesz, zapoznaj się z dokumentacją SendGrid, która zawiera świetne zasoby, zanim zagłębisz się w referencje i szczegóły interfejsu API.

Terminologia

Jeśli szukasz odpowiednika SendGrid niektórych funkcji Mailgun, pomoże poniższa tabela:

Uzyskiwanie klucza API

Najpierw potrzebujesz konta SendGrid. Następnie powinieneś utworzyć klucz API, którego będziesz używać do wysyłania. Przejdź do Ustawienia -> Klucze API lub użyj tego linku. Najlepszym rozwiązaniem dotyczącym SendGrid i zabezpieczeń jest użycie innego klucza interfejsu API dla każdej z różnych aplikacji. Klucze API mają szczegółowe uprawnienia, dzięki czemu możesz włączyć lub wyłączyć dostęp do odczytu lub zapisu dla poszczególnych punktów końcowych. Upewnij się, że utworzony klucz API ma pełny dostęp do funkcji Wysyłanie poczty . (Uwaga: Twoje konto musi przejść obsługę administracyjną, zanim będzie można utworzyć klucz API).

Biblioteki API

Posiadamy szereg oficjalnie obsługiwanych bibliotek API, aby ułatwić naszym klientom integrację. Jeśli w ramach migracji piszesz dowolny kod lub refaktoryzujesz sposób komunikowania się z ESP, teraz jest dobry moment, aby ocenić te biblioteki:

• sendgrid-csharp – oficjalna biblioteka C#
• sendgrid-go – oficjalna biblioteka Go
• sendgrid-java – oficjalna biblioteka Java
• sendgrid-nodejs – Oficjalna biblioteka NodeJS
• sendgrid-php – Oficjalna biblioteka PHP
• sendgrid-python – oficjalna biblioteka Pythona
• sendgrid-ruby – Oficjalna biblioteka Ruby

SMTP

Jeśli wysyłasz przez SMTP, jest kilka różnic, o których powinieneś wiedzieć. Aby uwierzytelnić, 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 także łą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 poczty. Żądania do tego punktu końcowego są uwierzytelniane za pomocą nagłówka autoryzacji z Twoim kluczem API przedstawionym jako token okaziciela. Bardziej szczegółowy przykład można znaleźć w naszych dokumentach.

Personalizacje umożliwiają zdefiniowanie odbiorców i metadanych dla każdej wiadomości, takich jak wartości podstawienia do dostosowywania treści lub custom_args do kojarzenia wiadomości z identyfikatorami użytkowników lub numerami zamówień. Istnieje wiele 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ęć są konfigurowane za pomocą parametrów tracking_settings i mail_settings. Możesz także zaplanować wysyłkę z 72-godzinnym wyprzedzeniem za pomocą parametru „send_at”.

Załączniki wysyłane przez HTTP są obsługiwane inaczej niż Mailgun. Mailgun wymaga wieloczęściowego/form-data POST zawierającego pliki do załączenia. Dzięki SendGrid zawartość jest kodowana jako Base64 i osadzona bezpośrednio w ładunku JSON wraz z informacjami MIME, dzięki czemu cała wiadomość jest przechowywana w tym samym ładunku i upraszcza się żądanie HTTP. Więcej informacji na temat dołączania załączników można znaleźć w następnej sekcji naszej Klasie z dokumentacją.

Webhooki

SendGrid udostępnia dwa elementy webhook: element Webhook zdarzenia do publikowania zdarzeń w czasie rzeczywistym oraz element Webhook analizy przychodzącej do odbierania wiadomości e-mail i programowego odpowiadania na nie. Kształty danych i ładunki różnią się nieco od tego, co zapewnia Mailgun. Obecnie nie obsługujemy również kierowania wiadomości przychodzących do różnych adresów URL wywołań zwrotnych; będziesz musiał obsłużyć tego rodzaju logikę w kodzie, a nie na poziomie interfejsu API.

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 v3. W większości przypadków stosujemy intuicyjne metody HTTP i kody odpowiedzi oraz wymuszamy limity stawek dla połączeń. API v2 jest przestarzałe, ale nie ma harmonogramu, aby przestać go wspierać. Wszystkie nowe integracje powinny preferować wersję 3. Uwierzytelnianie API v3 jest realizowane przez nagłówek uwierzytelniania z tokenem Bearer.

Kampanie marketingowe

Posiadamy w pełni funkcjonalną platformę do zarządzania listami kontaktów, tworzenia i projektowania szablonów, testowania A/B różnych szablonów oraz planowania kampanii. Wszystko to jest zawarte w interfejsie użytkownika, który jest łatwy w użyciu dla osób niebędących programistami. Oczywiście możesz również uzyskać dostęp do wszystkich tych funkcji za pośrednictwem naszego interfejsu API kampanii marketingowych.

Kilka często zadawanych pytań

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

O: Tak – i są dynamiczne! Szablony transakcyjne 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, kliknij tutaj.

P: Czy istnieje piaskownica lub sposób na przetestowanie moich e-maili bez ich wysyłania?

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

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

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

P: czy SendGrid obsługuje wymuszone TLS ?

O: Absolutnie. Możesz wymagać, aby serwery odbierające obsługiwały TLS i odrzucały wiadomości kierowane do serwerów, 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 nad ich pocztą e-mail umożliwia wysyłanie wiadomości e-mail, których chcą ludzie, co jest lepsze dla wszystkich. Sprawdź grupy rezygnacji z subskrypcji, aby uzyskać więcej informacji.

Jeśli interesuje Cię migracja do SendGrid, możesz znaleźć więcej informacji na stronie sendgrid.com/pricing.