Die nShift Notifications API unterstützt den Versand von E-Mails über die eigenen E-Mail-Adressen der Kunden. Dieser Leitfaden erklärt, wie Sie Ihre E-Mail-Adressen für den Versand von Benachrichtigungen mithilfe der Funktion From Email Addresses konfigurieren und verifizieren.
Abschnitte in diesem Artikel:
- Übersicht
- Schritt 1 – E-Mail-Adresse hinzufügen
- Schritt 2 – DNS-Einträge abrufen
- Schritt 3 – DNS-Einträge veröffentlichen
- Schritt 4 – Einträge verifizieren
- Schritt 5 – E-Mail-Adresse in Vorlagen verwenden
- Fehlerbehebung
Übersicht
In der Funktion From Email Addresses müssen drei Elemente konfiguriert werden:
- Absenderadresse – die E-Mail-Adresse, über die Benachrichtigungen versendet werden.
- Empfängeradresse für Bounce-Benachrichtigungen – die E-Mail-Adresse, die Bounce-Benachrichtigungen erhält (wenn eine E-Mail nicht zugestellt werden kann).
- Empfängeradresse für Beschwerde-Benachrichtigungen – die E-Mail-Adresse, die Beschwerde-Benachrichtigungen erhält (bei Spam- oder Missbrauchsmeldungen).
Nach der Konfiguration generiert die Funktion die erforderlichen DNS-Einträge (SPF und DKIM), die bei Ihrem DNS-Anbieter veröffentlicht werden müssen. Nach der DNS-Verifizierung können Sie die konfigurierte E-Mail-Adresse in Ihren Benachrichtigungsvorlagen verwenden.
Schritt 1 – E-Mail-Adresse hinzufügen
- Melden Sie sich bei nShift Portal an und navigieren Sie zu Settings > Services > From email addresses.
- Klicken Sie auf Add new email address und geben Sie die E-Mail-Adressen ein, die Sie konfigurieren möchten.
- Klicken Sie auf Submit.
Hinweis: Die „Mail from address" muss eine Domain sein, die Sie besitzen und deren DNS Sie verwalten können.
Schritt 2 – DNS-Einträge abrufen
Nach der Eingabe Ihrer E-Mail-Adressen generiert die Funktion zwei DNS-Einträge für Ihre Domain:
- SPF-Eintrag – autorisiert unsere Mailserver, E-Mails im Namen Ihrer Domain zu versenden.
- DKIM-Eintrag – stellt eine kryptografische Signatur bereit, die Ihre Nachrichten validiert.
Beispielausgabe (Ihre Werte werden abweichen):
SPF: v=spf1 include:mail.yourprovider.com ~all
DKIM (CNAME): selector1._domainkey.yourdomain.com → dkim.mail.yourprovider.com
Schritt 3 – DNS-Einträge veröffentlichen
- Melden Sie sich bei Ihrem DNS-Anbieter an (z. B. GoDaddy, Cloudflare, Route53).
- Navigieren Sie zum Abschnitt DNS Management.
- Fügen Sie die Einträge genau wie angegeben hinzu:
- Für SPF: fügen Sie MX- und TXT-Einträge für Ihre Domain-Root (@) hinzu.
- Für DKIM: fügen Sie CNAME-Einträge hinzu.
Wenn Ihre Domain bereits einen SPF-Eintrag hat, fügen Sie den neuen include zum bestehenden hinzu, anstatt ihn zu ersetzen.
Schritt 4 – Einträge verifizieren
Nachdem Sie die DNS-Einträge veröffentlicht haben, kehren Sie zur Funktion From email addresses zurück.
Das System prüft automatisch die DNS-Propagierung.
Bei erfolgreicher Verifizierung wird der Status auf Verified aktualisiert.
Schritt 5 – E-Mail-Adresse in Vorlagen verwenden
Nachdem die „From Address" verifiziert wurde, können Sie:
- Navigieren Sie zu Track > Notifications > Templates.
- Wählen Sie Ihre verifizierte E-Mail-Adresse aus den Absenderoptionen aus.
Dadurch wird sichergestellt, dass alle Benachrichtigungen von Ihrer vertrauenswürdigen Domain mit vollständiger Authentifizierung (SPF + DKIM) versendet werden.
Fehlerbehebung
- DNS wird nicht verifiziert? Es kann bis zu 24–48 Stunden dauern, bis DNS-Änderungen propagiert werden.
- SPF bereits vorhanden? Stellen Sie sicher, dass Sie nur einen SPF-Eintrag haben; führen Sie mehrere Einträge in einer einzigen Zeile zusammen.
- Funktioniert es immer noch nicht? Überprüfen Sie Hostnamen und Werte auf Tippfehler und bestätigen Sie, dass Sie die DNS-Einträge mit dem richtigen Typ (TXT oder CNAME) gespeichert haben.