E-Mail-Adressen-Validierung mit externen Diensten verstehen

Bounce.

Das möchten Sie beim Versand Ihrer E-Mail-Kampagne nicht hören.

Sie haben Marktforschung betrieben, eine responsive HTML-E-Mail-Vorlage erstellt, brillante Texte geschrieben und auffällige Grafiken hinzugefügt. Ihre E-Mail-Marketing-Kampagne wird bestimmt erfolgreich sein, oder?

Alles hängt von Ihrer E-Mail-Zustellbarkeit und Ihrer E-Mail-Zustellrate ab. Die Zustellbarkeit beschreibt, welcher Anteil Ihrer E-Mails im Spam-Ordner anstatt im Posteingang des Empfängers landet. Ihre Zustellrate gibt hingegen an, wie viele Ihrer E-Mails überhaupt zugestellt werden.

Das Problem mit der E-Mail-Zustellrate lässt sich auf verschiedene Weise lösen, etwa durch die Implementierung von Validierungsregeln mit regulären Ausdrücken (Regex) und anderen benutzerdefinierten Validierungen, während Sie E-Mail-Adressen für Kampagnen sammeln. Letztlich haben diese Optionen jedoch ihre Grenzen. Keine Sorge – deshalb unterstützt Mailgun Sie mit unserer E-Mail-Validierungs-API.

In diesem Artikel stellen wir drei Möglichkeiten vor, um E-Mail-Validierungen mit Mailgun durchzuführen. Anschließend besprechen wir, wie Sie die Mailgun-API in einen externen Client wie Salesforce integrieren. So nutzen Sie unsere E-Mail-Validierungs-API, um Ihr digitales Marketing plattformübergreifend zu optimieren.

Die E-Mail-Adressen-Validierung, auch E-Mail-Verifizierung genannt, ist ein Prozess, bei dem geprüft wird, ob eine E-Mail-Adresse zustellbar – oder einfach gesagt – eine gültige E-Mail-Adresse ist.

Beispielsweise machen viele Ihrer Nutzer Tipp- oder Formatierungsfehler bei der Eingabe ihrer E-Mail-Adresse, insbesondere auf Mobilgeräten mit kleinen Bildschirmen. Die E-Mail-Validierung erkennt diese Syntax- oder Tippfehler und bewertet, ob es sich bei den falschen Daten um ein Versehen, eine absichtliche Täuschung oder eine potenzielle Bedrohung der Cybersicherheit handelt.

Die Validierung von E-Mail-Adressen ist wichtig, weil sie Folgendes ermöglicht:

• Zustellrate erhöhen: Senken Sie Ihre Bounce-Rate, indem Sie E-Mail-Adressen verifizieren und ungültige Nutzer ausschließen, die Mailserver nicht erreichen.
• Mailingliste bereinigen und strukturieren: Halten Sie Ihre Mailingliste aktuell und strukturiert, indem Sie veraltete oder ungültige E-Mail-Adressen aussortieren.
• Konversionsrate steigern: Da Sie sich auf validierte E-Mails konzentrieren, verschwenden Sie keine Nachrichten an ungültige E-Mail-Adressen. Dadurch sprechen Sie aktive E-Mail-Empfänger an und erzielen eine höhere Konversionsrate.
• Absenderreputation schützen: Ihre IP-Adresse und Ihre Domain-Reputation sind die Metriken des E-Mail-Clients, anhand derer entschieden wird, ob Ihre Nachrichten zugestellt werden oder nicht. Sie beeinflussen zudem, ob Ihre E-Mails im Posteingang Ihrer Empfänger oder im Spam-Ordner landen. Sorgen Sie für eine gute Absenderreputation, indem Sie E-Mail-Adressen gültiger Nutzer ansprechen.

Warum den Erfolg Ihrer E-Mail-Kampagne dem Zufall überlassen, wenn sich E-Mail-Adressen ganz einfach validieren lassen?

Wir bei Mailgun bieten eine E-Mail-Verifizierungsdienst , die vollständig in unsere Suite von Funktionen und Diensten für die E-Mail-Zustellbarkeit integriert ist. Sie müssen nicht zwischen verschiedenen Plattformen und Datenquellen hin- und herwechseln, um zu prüfen, ob Ihre E-Mail-Kampagnen zu Bounces führen.

Unser E-Mail-Validierungs-API wird über den folgenden Endpunkt abgefragt: https://api.mailgun.net/v4/address/validate. Die API prüft programmgesteuert mehrere Aspekte einer E-Mail-Adresse, um Folgendes zu kontrollieren:

• Ob die Syntax der E-Mail-Adresse korrekt ist.
• Ob die Domain für den Empfang von E-Mails eingerichtet ist.
• Ob die E-Mail-Adresse existiert.
• Ob für die Adresse keine zwischengespeicherten Bounce-Ereignisse aus dem Mailgun-Netzwerk vorliegen.
• Ob die E-Mail-Adresse nicht als Adresse mit hohem Risiko eingestuft ist.
• Die E-Mail-Adresse ist keine rollenbasierte Adresse wie etwa info@mailgun.com oder admin@mailgun.com.
• Die E-Mail-Adresse ist keine Wegwerfadresse.
• Die E-Mail-Adresse enthält keinen Tippfehler in der Domain.
• Die E-Mail-Adresse gehört zu keiner Catch-all-Domain.
  • Wenn es sich um eine Catch-all-Domain handelt, markieren wir die Adresse als zustellbar, sofern ein Engagement unter dieser Adresse vorliegt.

Wir wissen, wie wichtig eine Liste verifizierter und zustellbarer E-Mail-Adressen ist, um die Quote unzustellbarer E-Mails zu senken, die Ihrer Absenderreputation schaden könnten.

Mailgun bietet drei Möglichkeiten zur E-Mail-Adressen-Verifizierung an:

• Verifizierung der E-Mail-Adressen einer Mailingliste
• Verifizierung einer einzelnen E-Mail-Adresse
• Verifizierung von E-Mail-Adressen, die in großen Mengen als CSV bereitgestellt werden

Wenn Sie sich noch nicht mit dem Code befassen möchten, werfen Sie einen Blick auf die Mailinglisten-Funktion unserer Plattform (siehe unten). Verifizieren Sie die Kontakte einer Mailingliste per Mausklick über Ihr Control Panel. Denken Sie daran, dass Ihre Mailingliste maximal 2,5 Millionen Einträge enthalten darf.

Wenn Sie bereit für etwas Code sind, sehen wir uns nachfolgend an, wie Sie eine einzelne E-Mail-Verifizierung oder eine Massen-E-Mail-Verifizierung über unsere API durchführen.

Bevor Sie in die Tutorials eintauchen, stellen Sie sicher, dass Sie sich angemeldet haben für Mailgun falls Sie dies nicht bereits getan haben. Sobald Sie ein Konto haben, navigieren Sie im Dashboard zur Registerkarte API Security und kopieren Sie Ihren Private API Key, wie unten gezeigt. Sie benötigen diesen zur Authentifizierung.

Die folgenden Tutorials verwenden unsere Mailgun-API. Kenntnisse über RESTful-APIs, curl und JSON werden daher dringend empfohlen, sind aber nicht zwingend erforderlich.

Beginnen wir mit dem grundlegendsten Anwendungsfall: der Verifizierung einer einzigen E-Mail-Adresse. Eine GET-Anfrage an die E-Mail-Validierungs-API sieht wie folgt aus:

                                

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

Denken Sie daran, Ihren Private API Key anstelle des PRIVATE_API_KEY aus dem obigen Beispiel anzugeben. Darüber hinaus können Sie die zu verifizierende E-Mail-Adresse als Parameter für address angeben.

Falls Sie Ihre Abfrage korrekt formuliert haben, sollten Sie 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"rnrn}
                                
                            

Die beiden wichtigsten Bestandteile dieser Antwort sind die Parameter result und risk.

Der Parameter result liefert unsere primäre Bewertung der E-Mail-Adresse, die Sie zur Verifizierung übermittelt haben. Er kann folgende Werte enthalten:

• deliverable: Die Empfängeradresse ist gültig und sollte eine E-Mail von Ihnen annehmen.
• undeliverable: Die Empfängeradresse ist ungültig und führt zu einem Bounce, falls Sie eine Nachricht versenden.
• do_not_send: Die Empfängeradresse ist hochgradig riskant und wirkt sich negativ auf Ihre Absenderreputation aus, falls Sie eine Nachricht an diese Adresse versenden.
• catch_all: Die Gültigkeit der Empfängeradresse kann nicht ermittelt werden, da der E-Mail-Service-Provider (ESP) alle E-Mails annimmt, unabhängig davon, ob das Postfach existiert.
• unknown: Die Gültigkeit der Empfängeradresse kann aus verschiedenen Gründen nicht festgestellt werden. Bitte beachten Sie dazu das entsprechende Array „reason“, das in der Antwort ausgegeben wird.

Der Parameter risk bewertet, wie sich der Versand von Nachrichten an eine bestimmte Adresse auf Ihre Absenderreputation auswirken könnte. Dieser Parameter kann die folgenden Werte annehmen:

• low: Die E-Mail-Adresse ist sehr wahrscheinlich legitim. Das Senden einer E-Mail an diese Adresse beschädigt Ihre Absenderreputation kaum, sofern die Adresse auf rechtmäßige Weise erfasst wurde. 
• medium: Dies ist unser Standard- bzw. neutraler Status für die Risikokalkulation. Eine E-Mail-Adresse, die weder als niedriges noch als hohes Risiko eingestuft wird, erhält standardmäßig den Status für mittleres Risiko.
• high: Eine E-Mail-Adresse, die ein hohes Risiko für Ihre Absenderreputation birgt oder bei der Verifizierung auf Ihrer Plattform auffällig wird. Sie sollten diese E-Mail-Adresse genauer auf ihre Gültigkeit überprüfen.

Hier ist eine kurze Erklärung der weiteren Parameter im Response-Body:

• address: Dies gibt die verifizierte E-Mail-Adresse zurück.
• is_disposable_address: Dieser Schlüssel gibt den Wert true oder false zurück, je nachdem, ob es sich bei der verifizierten E-Mail um eine Wegwerfadresse handelt.
• is_role_address: Dieser Parameter gibt den Wert true oder false zurück, je nachdem, ob es sich bei der verifizierten E-Mail-Adresse um eine rollenbasierte Adresse handelt.
• reason: Dieses Array liefert zusätzliche Informationen, falls wir eine E-Mail-Adresse nicht richtig verifizieren können, wie beispielsweise mailbox_does_not_exist oder high_risk_domain. Falls Ihr risk als medium oder high eingestuft wird, liefert dieses Array eine entsprechende Begründung.

Und das war’s auch schon zur Durchführung einer grundlegenden E-Mail-Adressen-Validierung. Bitte beachten Sie, dass Sie eine einzelne E-Mail-Verifizierung auch über eine POST-Anfrage durchführen können. Sehen Sie sich unsere API-Dokumentation für weitere Details.

Aber was ist, wenn Sie Hunderte (oder Tausende) E-Mail-Adressen verifizieren müssen? Jede einzeln zu versenden, wäre reine Verschwendung Ihrer Zeit und Rechenleistung.

Die Massenverifizierung ermöglicht es Ihnen, eine komplette Liste von E-Mail-Adressen zu überprüfen. Sobald alle Verifizierungen abgeschlossen sind, greifen Sie über den Link download_url auf die Ergebnisse zu. Denken Sie daran, dass Sie Ihre Liste der E-Mail-Adressen als unformatiertes CSV oder als GZIP bereitstellen müssen. Außerdem müssen Sie Ihre Datei als multi-part/form-data hochladen, wobei die Datei als file definiert ist. 

Sehen wir uns im Folgenden zwei API-Anfragen an, um Ihre Massenverifizierungen zu verwalten:

• einen Massenverifizierungsauftrag erstellen
• den Status eines Massenverifizierungsauftrags abrufen

Sobald Sie Ihre E-Mail-Adressliste gemäß den oben genannten Vorgaben vorbereitet und hochgeladen haben, erstellen Sie ganz leicht einen Massen-E-Mail-Verifizierungsauftrag. Wir verwenden dafür eine POST-Anfrage an unsere E-Mail-Validierungs-API (siehe unten):

Achten Sie darauf, Ihren Private API Key anstelle von YOUR_API_KEY einzusetzen, Ihre Liste bei LIST_NAME zu benennen und den Pfad Ihrer Datei für file anzugeben.

Sie sollten die folgende Antwort erhalten:

                                

                                    {rn "id":"myemails"rn "message": "The validation job was submitted."rn}
                                
                            

Sie erhalten eine Nachricht (message), die bestätigt, dass Ihr Auftrag erfolgreich eingereicht wurde. Die id entspricht dem von Ihnen angegebenen Listennamen.

Wir versprechen, dass Ihre Massenverifizierungen nicht lange dauern – in der Regel nur Minuten, keine Stunden. Das ist möglich, weil unser E-Mail-Verifizierungstool primär auf unseren Cache aus Milliarden von E-Mail-Adressen zugreift, was eine blitzschnelle Überprüfung ermöglicht. Falls Sie jedoch den Status Ihres Massenverifizierungsauftrags überprüfen möchten, nutzen Sie folgende GET-Anfrage:

                                

                                    curl -s --user 'api:YOUR_API_KEY' -G 
n    https://api.mailgun.net/v4/address/validate/bulk/LIST_NAME
                                
                            

Achten Sie darauf, Ihren Private API Key anstelle von YOUR_API_KEY einzusetzen und Ihre Liste bei LIST_NAME zu benennen. Hier ist eine Beispielantwort auf Ihre Anfrage:

                                

                                    {rn  "created_at": "Tue, 26 Feb 2021 21:30:03 GMT",rn  "download_url": {rn    "csv": "<download_link>",rn    "json": "<download_link>"rn  },rn  "id": "bulk_validations_sandbox_mailgun_org",rn  "quantity": 207665,rn  "records_processed": 207665,rn  "status": "uploaded",rn  "summary": {rn    "result": {rn      "deliverable": 181854,rn      "do_not_send": 5647,rn      "undeliverable": 12116,rn      "catch_all" : 2345,rn      "unknown": 5613rn    },rn    "risk": {rn      "high": 17763,rn      "low": 142547,rn      "medium": 41652,rn      "unknown": 5613rn    }rn  }rn}
                                
                            

Sie sehen eine Zusammenfassung Ihrer E-Mail-Verifizierungen, einschließlich der Aufschlüsselungen für result und risk. Außerdem sehen Sie den Status Ihres Auftrags ein. Dieser zeigt den aktuellen Bearbeitungsstand der Verifizierungsanfrage für die Liste an, beispielsweise created, processing, completed, uploading, uploaded und failed.

Sobald Ihr Massenverifizierungsauftrag erfolgreich hochgeladen wurde, greifen Sie über die Links unter download_url auf Details zu jeder einzelnen E-Mail-Adresse in Ihrer Liste zu.

Und schon sind Ihre E-Mails verifiziert und Sie können Ihre E-Mail-Kampagne auf den Weg bringen.

Sehen wir uns an, wie Sie als zuständige Person für die Salesforce-Administration Salesforce für die Nutzung der E-Mail-Validierungs-API von Mailgun konfigurieren können. Dazu verwenden wir External Services – eine Möglichkeit, Salesforce ohne Code-Aufwand mit externen APIs zu verbinden. Danach führen wir direkt aus Salesforce heraus eine E-Mail-Validierung durch. Wir gehen in folgenden Schritten vor:

1. Erstellen Sie ein Named Credential für die Mailgun-API in Salesforce.
2. Richten Sie External Services auf der Salesforce-Plattform ein.
3. Erstellen Sie einen Screen Flow zur Nutzung der Mailgun E-Mail-Validierungs-API in Salesforce.
4. Führen Sie eine E-Mail-Validierung über Salesforce aus.

Gehen wir diese Schritte im Detail durch. Denken Sie daran, dass Sie ein Mailgun-Konto mit einem Abonnement benötigen, das unsere E-Mail-Validierungsfunktion Mailgun Optimize umfasst.

Wir beginnen mit der Erstellung eines Named Credential. Gehen Sie wie folgt vor:

1. Gehen Sie in der Salesforce-Plattform auf Setup > Named Credentials.

2. Klicken Sie auf die Schaltfläche New, um ein neues Named Credential zu erstellen.

3. Geben Sie die folgenden Werte an:

• Label = Mailgun Email Address Verifications
• Name = Mailgun_Email_Verification_API
• Certificate = leer lassen
• Identity Type = Named Principal
• Authentication Protocol = Password Authentication
• Username = api
• Password = Ihr Private API Key aus Ihrem Mailgun-Konto.
• Generate Authorization Header = true

4. Klicken Sie auf Save.

Lassen Sie uns nun die External Services der Salesforce-Plattform nutzen, um die Mailgun-API zu integrieren. Wir gehen dafür in folgenden Schritten vor:

1. Gehen Sie in Salesforce zu Setup > External Services.

2. Wählen Sie New External Service aus.

3. Wählen Sie From API Specification aus und klicken Sie auf Next

4. Geben Sie diese Werte für die folgenden Felder ein:

• External Service Name = MailgunEmailVerificationsExternalService 
• Select a Named Credential = der Name des Named Credentials, das Sie oben erstellt haben (in diesem Beispiel Mailgun Email Address Verifications)
• Description = Mailgun’s Email Address verification service
• Ändern Sie den Optionsschalter auf „Service Schema Complete JSON“ und geben Sie das folgende Swagger-Schema ein:

                                

                                    {rnrn    "swagger": "2.0",rnrn    "info": {rnrn        "description": "Mailgun Email Address Validation API",rnrn        "version": "4.0",rnrn        "title": "Mailgun Email Address Validation API"rnrn    },rnrn    "host": "api.mailgun.net",rnrn    "schemes": [rnrn        "https"rnrn    ],rnrn    "paths": {rnrn        "/v4/address/validate": {rnrn            "get": {rnrn                "summary": "Validate an Email Address",rnrn                "produces": [rnrn                    "application/json"rnrn                ],rnrn                "parameters": [rnrn                    {rnrn                        "in": "query",rnrn                        "name": "address",rnrn                        "description": "Email Address to be Verified",rnrn                        "required": true,rnrn                        "type": "string"rnrn                    }rnrn                ],rnrn                "responses": {rnrn                    "200": {rnrn                        "description": "Result of the Email Address Validation",rnrn                        "schema": {rnrn                            "$ref": "#/definitions/validationResponse"rnrn                        }rnrn                    }rnrn                }rnrn            }rnrn        }rnrn    },rnrn    "definitions" : {rnrn        "validationResponse" : {rnrn            "properties": {rnrn                "result": {rnrn                    "description": "result",rnrn                    "type": "string"rnrn                }rnrn            }rnrn        }rnrn    }rnrn}
                                
                            

Ihr External Service sollte ungefähr so aussehen:

5. Wählen Sie den Vorgang getv4AddressValidate und klicken Sie auf Next.

6. Klicken Sie auf Done.

Nachdem wir Salesforce mit Mailgun aufgerüstet haben, erstellen wir nun einen Screen Flow, um die Mailgun E-Mail-Validierungs-API in Salesforce zu nutzen.

1. Gehen Sie im Salesforce Setup zu Flows > New Flow.

2. Wählen Sie Screen Flow und klicken Sie auf Create.

3. Der Flow besteht ganz einfach aus drei Elementen: einem Screen-Element, einem Action-Element und einem weiteren Screen-Element

4. Fügen Sie das erste Screen-Element hinzu:

Der Elementname kann „Email Address Entry“ lauten, und dieses Element wird nur ein einziges Text-Feld enthalten. Nennen Sie dieses Feld „Email Address“, wie unten gezeigt.

5. Fügen Sie unter dem Screen-Element ein Action-Element ein. Erstellen Sie im Flow eine neue Ressource, indem Sie auf die Schaltfläche „New Resource“ klicken. Fügen Sie der neuen Ressource diese Feldwerte hinzu und speichern Sie sie ab:

• Resource Type = Variable
• API Name = Mailgun External Service
• Data Type = Apex-Defined
• Apex Class = ExternalService__MailgunEmailVerificationsExternalService_validationResponse (oder wie auch immer Sie Ihren External Service in Schritt 3 oben genannt haben)
• Available for input und Available for output sollten beide auf True gesetzt werden

6. Fügen Sie dem Flow ein Action-Element hinzu, dessen Type External Service ist. Das Feld Action sollte Ihr External Service sein, und als Eingabewerte (Input) wird lediglich die Email Address aus dem ersten Screen-Element oben benötigt. Stellen Sie sicher, dass Sie Advanced > outputs auswählen und die oben erstellte Apex-definierte Variable namens MailgunExternalServices eingeben. Ihr Action-Element sollte in etwa so aussehen:

7. Fügen Sie nun Ihr letztes Screen-Element hinzu. Dieses Element hat lediglich ein Feld vom Typ Display Text und gibt das Ergebnis der Aktion aus dem obigen Aufruf des External Services aus.  Der Bildschirm sollte so aussehen (beachten Sie, dass Sie den Ausgabewert {!MailgunExternalService.result} über dem Display-Text finden, indem Sie auf Insert a Resource klicken und anschließend die Ausgabe Ihrer External Service-Variable wie unten dargestellt auswählen):

Das ist schon alles. Jetzt wollen wir uns das Ganze in Aktion ansehen.

Sie haben die Mailgun-API erfolgreich in Ihre Salesforce-Organisation integriert. Sehen wir uns an, wie alles funktioniert.

Um den oben erstellten Flow zu testen:

1. Klicken Sie auf die Schaltfläche Run im Flow.
2. Klicken Sie dann auf Enter any email address.
3. Geben Sie eine E-Mail-Adresse ein.
4. Klicken Sie auf Next.

Sie sollten ein Ergebnis von der Mailgun-API erhalten, das anzeigt, ob die eingegebene E-Mail-Adresse zustellbar (deliverable) oder unzustellbar (undeliverable) ist. Möchten Sie mehr erfahren? Sehen Sie sich dieses Video an, um diesen Flow im praktischen Einsatz zu betrachten.

Wir haben einige Methoden vorgestellt, um Ihre E-Mail-Adressen mit unserer Benutzeroberfläche und unserer Mailgun E-Mail-Validierungs-API zu verifizieren. Außerdem haben wir Ihnen Tipps zur Integration unserer API mit externen Clients wie Salesforce gegeben.

Nun sind Sie bestens darauf vorbereitet, Ihre E-Mail-Adressen auf deren Gültigkeit in Echtzeit zu überprüfen, um mit dem Versand zu starten. Haben Sie noch Fragen? Zögern Sie nicht, uns zu kontaktieren.

Autor: Danny Carranza Product Manager at Sinch Mailgun

Co-Autor: Peter Trinder Peter Trinder is a Sr. Product Manager at Sinch Mailgun. He works to build and implement product strategies, and provides guidance for our roadmap and operations. He writes about new features and how to use and understand them to improve performance.