So migrieren Sie von der Mailchimp-Transaktions-API zu SendGrid

Im Jahr 2016 wurde Mandrill – jetzt bekannt als Mailchimp Transactional API – zu einem exklusiven Zusatzdienst für Mailchimp. Dies bedeutete, dass nur monatliche Mailchimp-Mitglieder auf die E-Mail-Transaktionsfunktionen von Mandrill zugreifen konnten. Andere Benutzer mussten entweder eine andere Plattform wählen oder sich für ein Mailchimp-Konto entscheiden, das sie nicht immer benötigen würden.

Wir haben damals verstanden, dass viele Kunden einen alternativen Anbieter suchen würden, der E-Mails effizient versenden kann. Twilio SendGrid wollte dazu beitragen, diesen Prozess so reibungslos wie möglich zu gestalten.

Migration von Mailchimp Transactional API zu SendGrid

Als reines Add-On ist die Mailchimp Transactional API nicht darauf ausgelegt, E-Mails zuverlässig in dem Umfang zuzustellen, den Sie für Ihr Unternehmen benötigen. Aber hier bei Twilio SendGrid sind wir führend in der vertrauenswürdigen, sicheren E-Mail-Zustellung und verarbeiten über 100 Milliarden E-Mails pro Monat für unsere führenden Versender, darunter Uber, Airbnb und Spotify.

In diesem Tutorial gehen wir die wichtigsten Vorteile durch, die Sie beim Senden von E-Mails mit Twilio SendGrid erwarten können. Unser Schritt-für-Schritt-Migrationsleitfaden sorgt für einen reibungslosen und optimierten Übergang.

Die Twilio SendGrid-Dokumentation ist die beste Ressource für diejenigen, die eine Antwort auf alle SMTP-, API- und E-Mail-bezogenen Anfragen suchen. Es ist ein großartiger Ort, um zu beginnen, bevor Sie in die feineren Details des Verschiebens von E-Mails und des Durchführens von API-Aufrufen eintauchen.

Aber zuerst, wenn Sie nach dem Twilio SendGrid-Äquivalent bestimmter Mailchimp-Transaktions-API-Funktionen suchen, kann die folgende Tabelle hilfreich sein:

Erhalten eines API-Schlüssels

Zu Beginn benötigen Sie ein Twilio SendGrid-Konto. Dann möchten Sie einen API-Schlüssel erstellen, den Sie zum Senden verwenden. Gehen Sie zu Einstellungen → API-Schlüssel oder verwenden Sie diesen Link, wenn Sie in Ihrem Konto angemeldet sind. Es ist eine kluge Sicherheitspraxis, für jede Ihrer verschiedenen Apps einen anderen API-Schlüssel zu verwenden. Sie können auch Berechtigungen für API-Schlüssel definieren, indem Sie den Lese- oder Schreibzugriff für einzelne Endpunkte aktivieren oder deaktivieren. Im Moment brauchen Sie nur einen, der vollen Zugriff auf Mail Send hat. (Hinweis: Sie müssen die Bereitstellung bestehen , bevor Sie einen API-Schlüssel erstellen können.)

API-Bibliotheken

Wir haben eine Reihe von offiziell unterstützten API-Bibliotheken , die den E-Mail-Versandprozess weiter optimieren. Wenn Sie im Rahmen Ihrer Migration Code umschreiben oder die Art und Weise, wie Sie mit Ihrem E-Mail-Dienstanbieter (ESP) kommunizieren, umgestalten, ist jetzt ein guter Zeitpunkt, um eine dieser Bibliotheken zu verwenden, um Ihre Integration zu beschleunigen:

• sendgrid-csharp – Offizielle C# -Bibliothek
• sendgrid-go – Offizielle Go-Bibliothek
• sendgrid-java – Offizielle Java-Bibliothek
• sendgrid-nodejs – Offizielle Node.js-Bibliothek
• sendgrid-perl – Offizielle Perl-Bibliothek
• sendgrid-php – Offizielle PHP-Bibliothek
• sendgrid-python – Offizielle Python-Bibliothek
• sendgrid-ruby – Offizielle Ruby-Bibliothek
• ti.sendgrid – Offizieller Titanium-Wrapper

SMTP

Wenn Sie keine unserer Bibliotheken verwenden und über Simple Mail Transfer Protocol oder SMTP senden, gibt es einige Unterschiede, die Sie kennen sollten. Um sich beim Senden über SMTP zu authentifizieren, geben Sie als SMTP-Benutzernamen die Zeichenfolge „apikey“ ein und verwenden Sie Ihren API-Schlüssel als Passwort. Richten Sie dann Ihren Hostnamen auf smtp.sendgrid.net.

Sie können sich mit SMTP über unverschlüsselte oder TLS auf den Ports 25, 2525 und 587 verbinden. Oder 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.send- Endpunkt. Sie können Anfragen an diesen Endpunkt über einen Autorisierungsheader authentifizieren, wobei Ihr API-Schlüssel als Bearer-Token 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 mehrere Beispiele für Personalisierungen für allgemeine Anwendungsfälle. Sie können auch cURL-Beispielaufrufe finden .

Funktionen wie das Klick-Tracking können über die Parameter „tracking_settings“ und „mail_settings “ konfiguriert werden .

Behandeln Sie Anhänge, die über HTTP gesendet werden, ähnlich wie die Mailchimp Transactional API, bei der der Inhalt als Base64 codiert und direkt in die JSON-Nutzlast neben Mehrzweck-Internet-Mail-Erweiterungen oder MIME-Informationen eingebettet wird, wie z .

Beachten Sie, dass der mail.send-Endpunkt von Twilio SendGrid vollständig asynchron ist. Wir akzeptieren die Anfrage – sofern sie wohlgeformt ist – und versuchen, die E-Mail-Zustellung so schnell wie möglich zu bearbeiten. Mailchimp Transactional API ermöglicht die synchrone Ausführung von Anfragen für weniger als 10 E-Mails. Twilio SendGrid bietet jedoch keinen synchronen Modus.

Sie können den Versand auch bis zu 72 Stunden im Voraus planen, indem Sie den Parameter „send_at“ verwenden.

Webhooks

Twilio SendGrid bietet zwei Webhooks: den Event -Webhook zum Veröffentlichen von Echtzeitereignissen und den Inbound Email Parse-Webhook zum Empfangen von E-Mails und zum programmgesteuerten Antworten darauf. Die Datenformen und Nutzlasten unterscheiden sich ein wenig von dem, was die Mailchimp Transactional API bietet – Twilio SendGrid hat kein Äquivalent zum „Sync“-Webhook.

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. Obwohl es keinen Zeitplan gibt, um die Unterstützung einzustellen, ist API v2 immer noch minimal verfügbar. Alle neuen Integrationen sollten jedoch in Richtung v3 tendieren. Die API v3-Authentifizierung ist über einen Authentifizierungsheader mit einem Bearer-Token zugänglich .

Häufig gestellte Fragen zur Migration zu Twilio SendGrid

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

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

F: Kann ich meine E-Mails testen, ohne sie versenden zu müssen?

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

F: Ist es möglich, meine IP-Adresse/Absenderreputation an Twilio 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 Twilio SendGrid erzwungenes TLS?

A: Absolut. Unsere Empfangsserver unterstützen TLS und verwerfen ausgehende Nachrichten, die nicht konform sind.

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 geben, können Sie E-Mails an Abonnenten senden, die sie wirklich wollen, was auf lange Sicht für alle besser ist. Weitere Informationen finden Sie in unseren Abmeldegruppen .

F: Können Sie E-Mails pro Anfrage an mehrere Empfänger senden?

A: Ja. API v3-Kunden, die Personalisierungen verwenden, können bis zu 1.000 Empfänger pro Anfrage einbeziehen. SMTP-Benutzer können bis zu 10.000 Empfänger pro Nachricht einbeziehen – wir empfehlen jedoch oft, dass Sie mit 1.000 Empfängern pro Anfrage arbeiten.

Erfahren Sie mehr über den Wechsel von Mailchimp Transactional API zu Twilio SendGrid