So migrieren Sie von SparkPost zu SendGrid

Veröffentlicht: 2017-08-22

Als Pionier der Cloud-basierten Transaktions-E-Mail haben wir viele Veränderungen und neue Unternehmen in diesem Bereich gesehen. Der Trend, den wir bei diesen Unternehmen beobachten, ist, dass sie uns zuerst imitieren, dann angreifen und dann noch mehr imitieren. Zusätzlich zu den nachstehenden detaillierten Migrationsleitfäden möchten wir einige Gedanken über den Wert äußern, den unsere Kunden von SendGrid erhalten.

Erstens erhält jeder unserer Kunden, einschließlich derjenigen, die unseren kostenlosen Plan nutzen, Unterstützung von unserem äußerst erfahrenen Support-Team. Für Kunden mit unserem kostenlosen Plan wird dieser Support auch dann fortgesetzt, wenn sie nicht auf einen kostenpflichtigen Plan upgraden. Und für alle Kunden steht der Support 24 Stunden am Tag, an jedem Tag des Jahres, für jede Region, in der sich unsere Kunden befinden, zur Verfügung. Unsere Supportangebote sind Teil unseres Engagements, alle Benutzer der SendGrid-Plattform erfolgreich zu machen, indem wir jederzeit für sie da sind.

Außerdem ist API-gesteuerte programmatische E-Mail von den kleinsten Startups bis zu den größten Unternehmen nicht die einzige Möglichkeit, wie diese Unternehmen E-Mails verwenden, um Kunden zu erreichen. Sie versenden auch Newsletter, Ankündigungen und Kampagnen, um die Kundenbindung zu steigern und Käufe zu fördern. Bei SendGrid sind wir bestrebt, alle Kommunikationsanforderungen unserer Kunden zu erfüllen, mit vollständiger Teamunterstützung für Marketing und Werbung sowie für Programmatic. Mit unserem Produkt Marketingkampagnen können Sie Ihre Kunden über unsere intuitive Benutzeroberfläche mit fortschrittlichen Segmentierungs-, Analyse- und Designtools ansprechen.

Schließlich gibt es einen Grund, warum wir mehr als 55.000 zahlende Kunden haben, die über eine Milliarde E-Mails pro Tag verarbeiten. Der Grund dafür ist, dass wir unsere Leidenschaft für Kundenkommunikation und unsere umfassende E-Mail-Expertise nutzen , um unseren Kunden dabei zu helfen, ihr Geschäft auszubauen. Jeden Tag, an dem sie mit uns zusammenarbeiten, spüren unsere Kunden unsere Kultur und unser Engagement für ihren Erfolg.

So migrieren Sie von Sparkpost zu SendGrid

Hinweis: Der folgende Migrationsplan wurde mit freundlicher Genehmigung unseres Community-Entwicklungsteams bereitgestellt. In dieser Anleitung werden einige Unterschiede zwischen dem Senden von E-Mails über SparkPost und dem Senden von E-Mails über SendGrid hervorgehoben, um die Migration so einfach wie möglich zu gestalten.

Wenn Sie sich vorab umsehen möchten, sehen Sie sich die SendGrid-Dokumentation an. Der Klassenraum ist ein großartiger Ort, um mit dem Lernen über E-Mail zu beginnen, bevor Sie sich mit der API-Referenz und den Details befassen.

Terminologie

Wenn Sie nach dem SendGrid-Äquivalent bestimmter SparkPost-Funktionen suchen, hilft Ihnen die folgende Tabelle:

SendGrid-Begriff SparkPost-Begriff
Auswechslungen/Teile Substitutionsdaten
Kategorien Stichworte
unique_args Metadaten
Unterbenutzer Unterkonto
Unterdrückungen Unterdrückungsliste
X-SMTPAPI X-MSYS-API
Eingehender Parse-Webhook Eingehende Domänen
Marketing-Kampagnen Kein Äquivalent

Erhalten eines API-Schlüssels

Zuerst benötigen Sie ein SendGrid-Konto. Als Nächstes sollten Sie einen API-Schlüssel erstellen, den Sie zum Senden verwenden. Gehen Sie zu Einstellungen -> API-Schlüssel oder verwenden Sie diesen Link. Eine Best Practice für SendGrid und Sicherheit besteht darin, für jede Ihrer verschiedenen Apps einen anderen API-Schlüssel zu verwenden. API-Schlüssel verfügen über granulare Berechtigungen, sodass Sie den Lese- oder Schreibzugriff für einzelne Endpunkte aktivieren oder deaktivieren können. Stellen Sie sicher, dass der von Ihnen erstellte API-Schlüssel vollen Zugriff auf Mail Send hat. (Hinweis: Ihr Konto muss die Bereitstellung bestehen, bevor Sie einen API-Schlüssel erstellen können.)

API-Bibliotheken

Wir haben eine Reihe von offiziell unterstützten API-Bibliotheken, um die Integration für unsere Kunden zu vereinfachen. Wenn Sie im Rahmen Ihrer Migration Code umschreiben oder die Kommunikation mit Ihrem ESP umgestalten, ist jetzt ein guter Zeitpunkt, um diese Bibliotheken zu evaluieren:

  • sendgrid-csharp – Offizielle C#-Bibliothek
  • sendgrid-go – Offizielle Go-Bibliothek
  • sendgrid-java – Offizielle Java-Bibliothek
  • sendgrid-nodejs – Offizielle NodeJS-Bibliothek
  • sendgrid-php – Offizielle PHP-Bibliothek
  • sendgrid-python – Offizielle Python-Bibliothek
  • sendgrid-ruby – Offizielle Ruby-Bibliothek

SMTP

Wenn Sie über SMTP senden, gibt es einige Unterschiede, die Sie beachten sollten. Geben Sie zur Authentifizierung die Zeichenfolge „apikey“ als SMTP-Benutzernamen ein und verwenden Sie Ihren API-Schlüssel als Passwort. Zeigen Sie dann mit Ihrem Hostnamen auf smtp.sendgrid.net .

Sie können eine Verbindung mit SMTP über unverschlüsselte oder TLS auf den Ports 25, 2525 und 587 herstellen. Sie können sich auch über SSL auf Port 465 verbinden. Im Allgemeinen empfehlen wir Port 587, da dieser normalerweise zu den wenigsten Problemen mit Hosting-Providern führt.

Der Mechanismus zum Anpassen von E-Mails, die über SMTP gesendet werden, ist unser X-SMTPAPI-Header. Mit diesem Header können Sie Ersetzungen definieren, Anfragen im Stapelformat für Serienbriefe senden und Filter (wie Klick-Tracking) steuern, die für Ihre Sendung aktiv sind.

HTTP

Der Hauptendpunkt zum Senden von E-Mails ist der Mail-Endpunkt. Anfragen an diesen Endpunkt werden über einen Autorisierungsheader authentifiziert, wobei Ihr API-Schlüssel als Trägertoken dargestellt wird. Ein ausführlicheres Beispiel finden Sie in unseren Dokumenten.

Mithilfe von Personalisierungen können Sie Empfänger und Metadaten für jede Nachricht definieren, z. B. Ersatzwerte zum Anpassen von Inhalten oder custom_args zum Zuordnen von Nachrichten zu Benutzer-IDs oder Bestellnummern. Es gibt eine Reihe von Beispielen für Personalisierungen für allgemeine Anwendungsfälle. Sie können auch cURL-Beispielaufrufe finden.

Funktionen wie das Klick-Tracking werden über die Parameter „tracking_settings“ und „mail_settings“ konfiguriert. Sie können den Versand auch bis zu 72 Stunden im Voraus planen, indem Sie den Parameter „send_at“ verwenden.

Über HTTP gesendete Anhänge werden ähnlich wie bei SparkPost behandelt, wo der Inhalt als Base64 codiert und neben MIME-Informationen direkt in die JSON-Nutzlast eingebettet wird. Weitere Informationen zum Einfügen von Anhängen finden Sie im folgenden Abschnitt unseres Dokumentations-Klassenzimmers.

Webhooks

SendGrid bietet zwei Webhooks: den Event-Webhook zum Veröffentlichen von Echtzeitereignissen und den Inbound Parse-Webhook zum Empfangen von E-Mails und zum programmgesteuerten Antworten darauf. Die Datenformen und Nutzlasten unterscheiden sich ein wenig von dem, was SparkPost bereitstellt.

Nicht-E-Mail-API-Endpunkte

Informationen zu API-Endpunkten, die keine E-Mails senden, finden Sie in der API v3-Übersicht. Wir verwenden in den meisten Fällen intuitive HTTP-Methoden und Antwortcodes und erzwingen Ratenbegrenzungen für Anrufe. API v2 ist veraltet, obwohl es keinen Zeitplan gibt, um die Unterstützung einzustellen. Alle neuen Integrationen sollten v3 bevorzugen. Die API v3-Authentifizierung wird durch einen Authentifizierungsheader mit einem Bearer-Token erreicht.

Marketing-Kampagnen

Wir haben eine voll funktionsfähige Plattform zum Verwalten von Kontaktlisten, Erstellen und Entwerfen von Vorlagen, A/B-Testen verschiedener Vorlagen und Planen von Kampagnen. All dies ist in eine Benutzeroberfläche eingebettet, die für Nicht-Entwickler einfach zu verwenden ist. Und natürlich können Sie auf alle diese Funktionen auch über unsere Marketingkampagnen-API zugreifen.

Ein paar FAQs

F: Unterstützen Sie Vorlagen für Transaktions-E-Mails?

A: Ja – und sie sind dynamisch! Die Transaktionsvorlagen von SendGrid bieten native Unterstützung für die Handlebars-Syntax. Zusätzlich zu einfachen Ersetzungen und Ersetzungen können Sie Aufzählungen verwenden/Listen durchlaufen, Bedingungen nutzen und vieles mehr. Um mehr zu erfahren, klicken Sie hier.

F: Gibt es eine Sandbox oder eine Möglichkeit, meine E-Mails zu testen, ohne sie zu senden?

A: Sie können den Sandbox-Modus aktivieren, wenn Sie über HTTP senden. Es gibt auch eine „Senke“-Adresse, die Sie zum Testen verwenden können.

F: Ist es möglich, meine IP-Adresse/Absenderreputation an SendGrid zu übertragen?

A: Wir können keine IP oder Reputation migrieren, aber wir können Ihnen helfen, automatisch eine neue IP aufzuwärmen.

F: Unterstützt SendGrid erzwungenes TLS ?

A: Absolut. Sie können verlangen, dass empfangende Server TLS unterstützen, und Nachrichten an nicht konforme Server verwerfen.

F: Kann ich meinen Empfängern erlauben, die Arten von E-Mails zu definieren, die sie erhalten möchten?

A: Ja. Wenn Sie Ihren Empfängern mehr Kontrolle über ihre E-Mails geben, können Sie E-Mails senden, die die Leute wollen, was für alle besser ist. Weitere Informationen finden Sie in Abmeldegruppen.

Wenn Sie an einer Migration zu SendGrid interessiert sind, finden Sie weitere Informationen unter sendgrid.com/pricing.