So migrieren Sie von der Dyn-E-Mail-Zustellung zu SendGrid

Veröffentlicht: 2016-11-23

Mit der jüngsten Nachricht, dass Dyn von Oracle für sein DNS-Verwaltungsgeschäft übernommen wird, haben die Leute nach Lösungen gesucht, die sich vollständig auf E-Mail konzentrieren. Unser Team hatte eine Zunahme der Fragen zur Migration von der Dyn-E-Mail-Zustellung zu SendGrid, daher haben wir uns entschieden, diesen Leitfaden zusammenzustellen.

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.

Wir sind seit unserer Gründung ein API-orientiertes, reines E-Mail-Unternehmen, und Sie werden feststellen, dass sich dies in unseren Produkten widerspiegelt. Unser HTTP-E-Mail-Endpunkt, Webhooks, SMTP und Nicht-E-Mail-API sind der Kern unseres Geschäfts, und Sie werden sehen, dass sich dies in ihren Fähigkeiten widerspiegelt. Dieser Leitfaden soll Ihnen die Grundlagen für die Einrichtung von SendGrid vermitteln und nützliche Funktionen hervorheben, die Ihrem aktuellen Anbieter fehlen.

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

Während Dyn offizielle SDKs in Python und PHP bereitstellt, haben wir sieben offiziell unterstützte 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. Erstens müssen Sie sich keine Gedanken über die Verwendung eines bestimmten SMTP-Servers machen, der auf Ihrer Nachrichtengröße basiert, wie es Dyn erfordert. Wir akzeptieren auch Nachrichten bis zu ~19,5 MB gegenüber Dyns Limit von 10 MB. 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 .

Wir bieten auch zusätzliche Portoptionen im Vergleich zu Dyn. 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. Dieser Header ermöglicht es Ihnen, Schlüssel/Wert-Ersetzungen zu definieren, Anfragen im Stapelformat für Serienbriefe zu senden und Filter (wie Klick-Tracking) zu steuern, die für Ihre Sendung aktiv sind. Sie können E-Mails nach Kategorie gruppieren oder Metadaten pro E-Mail mit unique_args verfolgen. Dies sind leistungsstarke Funktionen, die Ihre Sendezeit und die für Ihre E-Mail-Transaktionen erforderliche Bandbreite reduzieren können und die es wert sind, erkundet zu werden.

HTTP

Der Hauptendpunkt für das Senden von E-Mails ist der Mail/Send-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.

Im Vergleich zur HTTP-API von Dyn bietet unser Endpunkt mehr Funktionen, mit denen Sie Ihre Empfänger anpassen und verwalten und sogar mehrere verschiedene Nachrichten in einer einzigen Anfrage senden können.

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.

Wir machen es auch super einfach, Anhänge zu Ihrer API-Anfrage hinzuzufügen. Codieren Sie Ihre Datei einfach als Base64-String und betten Sie sie direkt in die JSON-Nutzlast neben MIME-Inhaltsinformationen ein. 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 Echtzeit-E-Mail-Ereignissen wie Abmeldungen, Bounces usw. und den Inbound Parse-Webhook zum Empfangen von E-Mails und zum programmgesteuerten Antworten darauf.

Diese Funktionen sind auf Dyn nicht verfügbar, können aber großartig sein, um Ihrer E-Mail-Verwaltung zusätzliche Automatisierung hinzuzufügen. Sie sind einen Blick wert, wenn Sie mit der Einrichtung beginnen.

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

Eine weitere Funktion, die wir anbieten, ist eine robuste Plattform für Marketingkampagnen, mit der Sie Ihre Listen verwalten, dynamische Segmente erstellen, Ihre Assets hochladen und Ihre E-Mail-Vorlage mit einem visuellen Editor entwerfen, automatische A/B-Tests durchführen und vieles mehr. Und natürlich steckt hinter all diesen Features auch eine offene API.

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.