Jak przeprowadzić migrację z SparkPost do SendGrid
Opublikowany: 2017-08-22Jako pionier transakcyjnej poczty e-mail opartej na chmurze, zaobserwowaliśmy wiele zmian i nowych firm w kosmosie. Trend, który zaobserwowaliśmy w tych firmach, polega na tym, że najpierw nas naśladują, potem nas atakują, a potem jeszcze bardziej nas naśladują. Oprócz przedstawienia szczegółowych wskazówek dotyczących migracji poniżej, chcemy przedstawić kilka przemyśleń na temat wartości, jaką nasi klienci uzyskują dzięki SendGrid.
Po pierwsze, każdy z naszych klientów, w tym osoby korzystające z naszego bezpłatnego planu, otrzymuje wsparcie od naszego bardzo doświadczonego zespołu wsparcia. W przypadku klientów korzystających z naszego bezpłatnego planu pomoc ta jest kontynuowana, nawet jeśli nie dokonają uaktualnienia do planu płatnego. Dla wszystkich klientów wsparcie jest dostępne 24 godziny na dobę, każdego dnia w roku, dla każdego regionu, w którym znajdują się nasi klienci. Nasze oferty pomocy technicznej są częścią naszego zobowiązania, aby wszyscy użytkownicy platformy SendGrid odnieśli sukces, będąc tam dla nich w każdej chwili.
Ponadto, od najmniejszych startupów po największe przedsiębiorstwa, programowa poczta e-mail oparta na interfejsie API nie jest jedynym sposobem, w jaki firmy te wykorzystują pocztę e-mail do docierania do klientów. Wysyłają również biuletyny, ogłoszenia i kampanie, aby zwiększyć zaangażowanie klientów i zachęcić do zakupów. W SendGrid dążymy do zaspokojenia wszystkich potrzeb komunikacyjnych klientów, z pełną obsługą zespołu w zakresie marketingu i promocji, a także automatyzacji. Nasz produkt Kampanie marketingowe pozwala angażować klientów za pomocą naszego intuicyjnego interfejsu użytkownika z zaawansowaną segmentacją, analizą i narzędziami do projektowania.
Wreszcie jest powód, dla którego ponad 55 000 płacących klientów przetwarza ponad miliard e-maili dziennie. Powodem jest to, że wykorzystujemy naszą pasję do komunikacji z klientami i naszą głęboką wiedzę na temat poczty e-mail , aby pomóc naszym klientom rozwijać ich działalność. Nasi klienci każdego dnia pracują z nami, czują naszą kulturę i zaangażowanie w ich sukces.
Jak przeprowadzić migrację do SendGrid ze Sparkpost
Uwaga: Poniższy plan migracji został udostępniony dzięki uprzejmości naszego zespołu ds. rozwoju społeczności. Ten poradnik pokaże pewne różnice między wysyłaniem wiadomości e-mail za pośrednictwem SparkPost a wysyłaniem wiadomości e-mail za pośrednictwem SendGrid, aby ułatwić migrację.
Jeśli chcesz się rozejrzeć, zanim zaczniesz, zapoznaj się z dokumentacją SendGrid. Classroom to świetne miejsce, by zacząć uczyć się o poczcie e-mail przed zagłębieniem się w materiały i szczegóły dotyczące interfejsu API.
Terminologia
Jeśli szukasz odpowiednika SendGrid niektórych funkcji SparkPost, pomoże poniższa tabela:
Termin „SendGrid” | Okres SparkPost |
substytucje/sekcje | dane zastępcze |
kategorie | tagi |
unikalne_argi | metadane |
podużytkownik | subkonto |
stłumienie | lista tłumienia |
X-SMTPAPI | X-MSYS-API |
Webhook analizy przychodzącej | Domeny przychodzące |
Kampanie marketingowe | Brak odpowiednika |
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 w sposób podobny do SparkPost, gdzie zawartość jest kodowana jako Base64 i osadzona bezpośrednio w ładunku JSON wraz z informacjami MIME. 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 SparkPost.
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.