E-Mail-APIs: Definition, Vorteile und wie sie funktionieren

Erstellen Sie eine E-Commerce-Website, die Transaktions-E-Mails an Kunden senden muss? Oder entwickeln Sie eine Webanwendung, die Nachrichten an E-Mail-Listen senden soll? Oder sind Sie im E-Mail-Marketing tätig und haben die Aufgabe, Zehntausende von Kunden durch gezielte, personalisierte E-Mail-Kampagnen zu erreichen? Oder benötigen Sie in einer Führungsposition einen automatisierten Leistungsbericht, um zu sehen, wie Ihre E-Mail-Marketing-Kampagnen laufen?

Wenn einer dieser Punkte auf Sie zutrifft, benötigen Sie eine E-Mail-API.

E-Mail-APIs sind ein großer Teil dessen, was wir hier bei Mailgun tun. Deshalb möchten wir uns die Zeit nehmen, sie für Sie zu entmystifizieren. In diesem Artikel beginnen wir mit den Grundlagen: Was ist eine E-Mail-API und welche Vorteile bietet sie? Danach betrachten wir den Unterschied zwischen der Nutzung von SMTP und einer E-Mail-API für den Versand Ihrer Massen- oder Transaktions-E-Mails und zeigen anhand einiger Beispiele unserer Mailgun-API, wie E-Mail-APIs Ihren Workflow verbessern können.

Legen wir los.

Eine Application Programming Interface (API) ist ein Mechanismus, der es zwei Anwendungen ermöglicht, miteinander zu kommunizieren. Sie gibt verschiedenen Plattformen die Möglichkeit, auf die Ressourcen der jeweils anderen zuzugreifen, ohne die Sicherheit oder Kontrolle zu beeinträchtigen.

Eine E-Mail-API ist eine spezielle Art von API, mit der Sie Ihre Web-App oder Plattform mit einem E-Mail-Service-Provider (ESP) verbinden können, um dessen Funktionen innerhalb Ihrer eigenen App-Umgebung zu nutzen. Das bedeutet, dass Sie nicht mehr separat zum ESP navigieren müssen, um Ihre Marketing-E-Mails zu versenden. Stattdessen können Sie jetzt eine E-Mail-API verwenden, um Nachrichten programmgesteuert direkt aus Ihrer App heraus zu senden.

Hier ist eine Übersicht, wie die E-Mail-API von Mailgun funktioniert:

1. Die E-Mail-API von Mailgun ermöglicht es Ihnen, Ihre App in Mailgun zu integrieren – einen E-Mail-Service-Provider, der sich auf die Zustellung Ihrer E-Mails konzentriert.
2. Von Ihrer App aus können Sie eine API-Anfrage stellen, um Ihre E-Mail-Nachrichten zu versenden. Diese API-Anfrage ist oben als „HTTP“ gekennzeichnet. Warum das so ist, besprechen wir weiter unten im Abschnitt darüber, wie APIs funktionieren.
3. Mailgun empfängt Ihre E-Mail-Versandanfrage und stellt sie zusammen, bevor sie in die Warteschlange eingereiht wird. Anbieter von Transaktions-E-Mails wie Mailgun helfen Ihnen, Ihre E-Mail-Aktivitäten zu optimieren, indem sie Fehlerbehebung, Statusprotokolle, Speicherlösungen, Antwortverarbeitung, E-Mail-Analysen und eine optimierte Zustellung bieten.
4. Anschließend stellt Mailgun Ihre Nachricht per API oder Simple Mail Transfer Protocol (SMTP) an die E-Mail-Clients Ihrer Abonnentinnen und Abonnenten zu, wie beispielsweise Microsoft Outlook, AOL, Gmail oder Yahoo. Wir gehen weiter unten näher auf SMTP ein.
5. Die E-Mail-Clients Ihrer Abonnentinnen und Abonnenten stellen die Nachrichten dann in deren Posteingänge zu.

Eine E-Mail-Marketing-API ist eine spezielle Art von E-Mail-API, die dafür entwickelt wurde, Marketing-Kampagnen programmgesteuert zu verwalten und zu automatisieren. Sie ermöglicht es Ihnen, E-Mails für Werbeaktionen, Newsletter und getriggerte Automatisierungen direkt aus Ihrer Anwendung oder Software zu versenden. Zudem bietet sie Tools zur Verwaltung von Abonnentenlisten, zur Personalisierung von Inhalten und für detaillierte Analysen der Kampagnenleistung. 

Die Nutzung einer E-Mail-API bietet viele Vorteile in Bezug auf Effizienz, Sicherheit und Skalierbarkeit. Die Vorteile jeder API bestehen darin, Prozesse zu optimieren, ohne die Sicherheit zu beeinträchtigen. Zudem behalten Sie den Vorteil, Dienste innerhalb Ihrer eigenen Umgebung zu betreiben. Das macht es viel einfacher, Metriken abzurufen und das Reporting zu überwachen. Hier sind einige der Vorteile:

• Verbesserte Zustellbarkeit: E-Mail-APIs basieren auf einer robusten Infrastruktur und halten sich an Best Practices, die dabei helfen, dass Ihre Nachrichten die gewünschten Posteingänge erreichen. Durch die automatische Verarbeitung von Bounces und Abmeldungen sorgt die API dafür, dass Ihre Listen sauber bleiben. Das signalisiert E-Mail-Service-Providern (ESPs), dass Sie ein seriöser Absender sind, und verringert die Wahrscheinlichkeit, als Spam markiert zu werden. 

• Mehr Effizienz und Automatisierung: Die API macht manuelle, zeitaufwändige Aufgaben wie das Erstellen und Versenden einzelner E-Mails überflüssig. Dies ist besonders wichtig für Transaktions-E-Mails (Passwortzurücksetzungen, Bestellbestätigungen) und groß angelegte Marketing-Kampagnen.  

• Bessere Personalisierung und mehr Engagement: E-Mail-APIs können in Ihre Kundendaten integriert werden, um den Inhalt jeder Nachricht dynamisch zu personalisieren. Diese Funktion ermöglicht es Ihnen, hochgradig relevante E-Mails zu versenden, was zu höheren Öffnungsraten, Klickraten und einer stärkeren Bindung zu Ihren Kunden führen kann. 

• Echtzeit-Analysen und Einblicke: Nutzen Sie E-Mail-Analysen, um Metriken zu verfolgen und Ihre E-Mail-Kampagnen auszuwerten. Verwenden Sie eine E-Mail-API, um Zustellbarkeitsmetriken wie die Öffnungsrate abzurufen und zusammenzustellen, zu erfassen, wie viele Abonnenten auf Ihren Call-to-Action-Button (CTA) geklickt haben, oder wie viele E-Mails zu Konversionen geführt haben. Diese Echtzeit-Feedbackschleife ermöglicht es Ihnen, datengesteuerte Entscheidungen zu treffen und Ihre E-Mail-Kampagnen für bessere Ergebnisse zu optimieren. 

• Gewährleistung von Datensicherheit und Compliance: Schützen Sie Ihr Unternehmen und Ihre Kunden mit fortschrittlichen Sicherheitsprotokollen. E-Mail-Marketing-APIs verwenden sichere Authentifizierung und Verschlüsselung, um vertrauliche Kundendaten zu schützen.  

• Ereignisgesteuerte Automatisierung: Erstellen Sie Webhooks, die E-Mail-Ereignisdaten an ein CRM senden. Verwenden Sie Webhooks, um Ihre Ereignisdaten an externe Customer-Relationship-Management-Tools (CRM) zu senden. Sie können E-Mail-APIs nutzen, um Webhooks zu erstellen, die Sie benachrichtigen, wenn ein bestimmtes Ereignis eingetreten ist – etwa wenn ein Abonnent ein Passwort zurücksetzen möchte. So können Sie eine Folgeaktion programmieren, wie den Versand einer E-Mail zum Zurücksetzen des Passworts. 

• Skalierbarkeit: Wenn Sie SMTP für den E-Mail-Versand verwenden, sollten Sie sowohl Ihr Versandvolumen als auch die Sicherheit berücksichtigen. Wenn Ihr normales Versandvolumen sprunghaft ansteigt, könnten E-Mail-Clients Ihr Verhalten als Spam markieren. Bei API-Aufrufen, die über Cloud-Server laufen, haben Sie bei großen Skalierungen nicht dieselben Probleme. Darüber hinaus bietet SMTP nicht automatisch die Möglichkeit, Authentifizierungsebenen einzubauen, wir vergleichen API und SMTP hier genauer 

Gut, jetzt wissen wir, was eine E-Mail-API macht und welche Vorteile sie bietet. Doch wie funktioniert das? Wir werden nicht auf alle kleinsten Details von APIs eingehen, aber wir können Ihnen das große Ganze zeigen. Wir beginnen mit der Architektur einer API. Danach besprechen wir die Anfragen, die Sie an eine API stellen können, und die Antworten, die Sie erhalten.

E-Mail-APIs wie die von Mailgun entsprechen einer modernen Konvention namens REST (REpresentational State Transfer), einem API-Architekturstil, der sich auf die Manipulation von Ressourcen konzentriert. Bei diesen Ressourcen handelt es sich um Datenobjekte wie Textdateien, HTML-Seiten oder Datensätze.

Sie können Anfragen für den Zugriff auf oder die Änderung dieser Ressourcen über Unique-Resource-Indicator-Endpunkte (URI) stellen. URIs ähneln URLs, aber sie können eine Ressource nur identifizieren, während URLs die Ressource lokalisieren.

Dies ist zum Beispiel der E-Mail-Versand-Endpunkt der E-Mail-API von Mailgun:

                                

                                    v3/<domain>/messages
                                
                            

Senden Sie Anfragen an diesen Endpunkt, um E-Mails zu verschicken.

RESTful-APIs verwenden Endpunkte zur Verwaltung von Ressourcen und ermöglichen es Nutzern, Datensätze zu erstellen, zu lesen, zu aktualisieren und zu löschen, indem mit diesen Endpunkten kommuniziert wird.

Dies sind einige der gängigsten Mailgun-Endpunkte:

Bei der Nutzung einer API verwalten und aktualisieren Sie Daten, indem Sie Anfragen stellen:

• POST erstellt eine neue Ressource
• GET fordert eine Ressource an
• PUT ersetzt eine Ressource
• PATCH aktualisiert eine Ressource
• DELETE löscht eine Ressource

Diese Anfragen verwenden Standardmethoden des Hypertext Transfer Protocol (HTTP). Manchmal lesen Sie den Begriff „eine HTTP-Anfrage senden“ anstelle von „eine Anfrage über die API senden“, wie in der Abbildung der Mailgun-API oben. Beide bedeuten dasselbe.

Hier ist ein Beispiel für eine POST-Anfrage, die an den Messages-Endpunkt der E-Mail-API von Mailgun gesendet wurde:

                                

                                    curl -s --user 'api:YOUR_API_KEY' 
n    https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/messages 
n    -F from='Excited User <mailgun@YOUR_DOMAIN_NAME>' 
n    -F to=foo@example.com 
n    -F to=bar@example.com 
n    -F subject='Hello' 
n    -F text='Testing some Mailgun awesomeness!'
                                
                            

Diese Anfrage weist die API an, eine Klartext-E-Mail von Excited User unter mailgun@YOUR_DOMAIN_NAME an foo@example.com und bar@example.com zu senden. Die E-Mail hat die Betreffzeile „Hello“ und enthält die Nachricht: „Testing some Mailgun awesomeness!“

Es gibt nichts Schlimmeres, als E-Mails oder Codezeilen einfach ins Leere zu schicken, oder? Deshalb erhalten Sie, je nach Art der gesendeten HTTP-Anfrage, eine spezifische Antwort zurück. Die Antwort besteht entweder aus den angeforderten Daten (wie einer gespeicherten E-Mail-Nachricht, die Sie abrufen möchten) oder einer Bestätigung, dass die gewünschte Aktion ausgeführt wurde. Antworten sind in Formaten wie XML, JSON, YAML oder anderen formatiert. Mailgun gibt beispielsweise JSON-Antworten zurück.

Hier ist zum Beispiel die JSON-Antwort, die Sie von der Mailgun-API erhalten sollten, wenn die obige POST-Anfrage korrekt gesendet wurde:

                                

                                    {rn  "message": "Queued. Thank you.",rn  "id": "<20111114174239.25659.5817@samples.mailgun.org>"rn}
                                
                            

Bei Mailgun glauben wir, dass Einfachheit und Effizienz der Schlüssel zu einem guten E-Mail-Erlebnis sind. Verwenden Sie die Mailgun-API mit Programmiersprachen und Frameworks wie Node.js, curl, Python, PHP, Microsoft.NET, Java und weiteren. Sehen Sie sich unsere Bibliotheken , um loszulegen.

Hier sind einige Anwendungsfälle für unsere E-Mail-APIs:

• Verwenden Sie unsere Sending API, um mühelos und in großem Maßstab eine HTML-E-Mail zu versenden.
• Verwenden Sie unsere E-Mail-Validierungs-API, um eine E-Mail-Adresse zu überprüfen.
• Nutzen Sie unsere Templates API, um eine HTML-E-Mail-Vorlage zu erstellen, hochzuladen, zu speichern und zu versionieren.

Lassen Sie uns auf jeden dieser Punkte im Folgenden genauer eingehen.

Verwenden Sie eine POST-Anfrage, um eine HTML-E-Mail mit Anhängen über die Sending API von Mailgun zu versenden.

Wir beginnen mit dem folgenden Code:

                                

                                    curl -s --user 'api:YOUR_API_KEY' 
n    https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/messages 
n    -F from='Excited User <YOU@YOUR_DOMAIN_NAME>' 
n    -F to='foo@example.com' 
n    -F cc='bar@example.com' 
n    -F bcc='baz@example.com' 
n    -F subject='Hello' 
n    -F text='Testing some Mailgun awesomeness!' 
n    --form-string html='<html>HTML version of the body</html>' 
n    -F attachment=@files/cartman.jpg 
n    -F attachment=@files/cartman.png
                                
                            

Im obigen Beispiel haben wir eine Nachricht von Excited User unter YOU@YOUR_DOMAIN_NAME an drei Empfänger gesendet: foo@example.com, bar@example.com und baz@example.com. Wir haben den Inhalt der HTML-E-Mail angehängt, indem wir ihn direkt zwischen die -Tags eingefügt haben. Außerdem haben wir zwei Anhänge hinzugefügt: cartman.jpg und cartman.png.

Sie müssen YOUR_API_KEY durch Ihren eigenen ersetzen API-Schlüssel. Denken Sie auch daran: Wenn Sie ein Nutzer in der EU sind, verwenden Sie bitte die Basis-URL für unsere EU-Umgebung: https://api.eu.mailgun.net/.

Für unseren API-Aufruf sollten wir die folgende Antwort erhalten:

                                

                                    {rn  "message": "Queued. Thank you.",rn  "id": "<20111114174239.25659.5817@samples.mailgun.org>"rn}
                                
                            

Kommen wir zu einem weiteren Anwendungsfall. Wir verwenden eine GET-Anfrage, um eine E-Mail-Adresse über die E-Mail-Validierungs-API zu überprüfen:

                                

                                    curl --user 'api:PRIVATE_API_KEY' -G 
n    https://api.mailgun.net/v4/address/validate 
n    --data-urlencode address='foo@mailgun.net'
                                
                            

Auf unseren API-Aufruf sollten wir die folgende Antwort erhalten:

                                

                                    {rn    "address": "foo@mailgun.net",rn    "is_disposable_address": false,rn    "is_role_address": false,rn    "reason": [],rn    "result": "deliverable",rn    "risk": "low"rn}
                                
                            

Für unseren letzten Anwendungsfall versuchen wir, eine Vorlage zu speichern, indem wir eine POST-Anfrage über die Templates API stellen:

                                

                                    curl -s --user 'api:YOUR_API_KEY' -X POST 
n      https://api.mailgun.net/v3/YOUR_DOMAIN_NAME/templates 
n      -F name="billing" rn      -F description="template description"rn      -F tag="v0" rn      -F template="template contents"
                                
                            

In dieser Anfrage gibt der Parameter name den Namen der Vorlage an. Dieser wird verwendet, um in anderen API-Aufrufen auf die Vorlage zu verweisen. Der Parameter tag identifiziert die spezifische Version dieser Vorlage. Der Parameter template spezifiziert den eigentlichen Inhalt der Vorlage. Fügen Sie hier den HTML-Inhalt der Vorlage direkt in die Anfrage ein.

Wir sollten die folgende Antwort erhalten:

                                

                                    {rn  "template": {rn      "createdAt": "Wed, 29 Aug 2021 23:31:13 UTC",rn      "description": "template description",rn      "name": "billing",rn      "version": {rn          "createdAt": "Wed, 29 Aug 2021 23:31:14 UTC",rn          "tag": "v0",rn      }rn  },rn  "message": "template has been stored"rn}
                                
                            

E-Mail-APIs tragen zur E-Mail-Zustellbarkeit bei, indem sie das Messaging sowohl für Absender als auch für Empfänger erleichtern. Eine API stellt sicher, dass eine Nachricht an eine vordefinierte Zielgruppe gesendet wird – meist über eine vom Absender erstellte Liste – und eliminiert die Notwendigkeit einer Vielzahl zeitaufwändiger, manuell generierter Nachrichten.

Die Reduzierung des manuellen Versands sorgt auch dafür, dass weniger menschliche Fehler passieren, wie etwa falsch geschriebene E-Mail-Adressen oder E-Mails, die nicht zum richtigen Zeitpunkt versendet werden. Dies verbessert die Genauigkeit und Konsistenz der gesendeten E-Mail-Nachrichten und führt zu einem stärkeren Engagement der Zielgruppe.

Die Rolle von APIs bei der Verbesserung von Zustellbarkeit und Engagement ist besonders wichtig für Organisationen, die mit großen Zielgruppen kommunizieren. Wenn 100 Kunden innerhalb einer Stunde bei einem Unternehmen das Zurücksetzen ihres Passworts anfordern, wäre diese Nachfrage fast unmöglich zu bewältigen, wenn das Unternehmen versuchen würde, 100 E-Mails manuell für seine Kundschaft zu erstellen (denken Sie an die Schokoladenfabrik-Folge von I Love Lucy).

APIs sind nicht immer leicht zu durchschauen, aber sie machen Ihr E-Mail-Programm zuverlässiger und effizienter. Wünschen Sie weitere Informationen darüber, wie die E-Mail-APIs von Mailgun Ihnen helfen können? Sehen Sie sich unsere API-Dokumentation oder setzen Sie sich mit unseren Fachleuten für Zustellbarkeit in Verbindung.

Autor: Mary Dolan Mary Dolan is a former Community Marketing Manager and Copywriter at Sinch Mailgun. She was our social media guru and community leader. She was dialed into the email network and writes about the email topics and trends you're probably talking about.