Sie benötigen ein Mailgun-Konto und Zugriff auf das DNS Ihrer Domain.
Mailguns eigene Dokumentation: Adding and verifying a domain · API keys · Sign up
1. Fügen Sie Ihre Absendedomain zu Mailgun hinzu
Gehen Sie im Mailgun-Dashboard auf Send → Domains → Add New Domain und geben Sie eine Subdomain ein, zum Beispiel mail.yourdomain.com.
⚠️ Mailguns eigene Empfehlung ist eine Subdomain, und das spielt hier eine größere Rolle als bei einigen anderen Anbietern: Mailgun setzt seine eigenen SPF- und DKIM-Einträge auf das, was Sie dort angeben, und wenn Sie auf Ihre Root-Domain verweisen, bedeutet das, dass diese Einträge neben jenen liegen, auf die Ihre geschäftlichen Postfächer angewiesen sind.
Wählen Sie die Region aus, die dem gewünschten Speicherort Ihrer Daten entspricht – US oder EU. Notieren Sie sich diese; Sie werden sie in Schritt 4 benötigen, und es ist der mit Abstand häufigste Fehler.
2. Veröffentlichen Sie die von Mailgun bereitgestellten DNS-Einträge
Mailgun zeigt Ihnen eine Liste an. Fügen Sie jeden einzelnen davon bei Ihrem DNS-Anbieter hinzu.
| Typ | Host | Zweck |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | Öffentlicher DKIM-Schlüssel |
CNAME | email.mail.yourdomain.com | Tracking und Bounce-Verarbeitung |
MX | mail.yourdomain.com | Empfang von Bounces (die beiden MX-Hosts von Mailgun) |
⛔ Wenn Ihre Absende-Subdomain bereits einen SPF-Eintrag hat, bearbeiten Sie diesen – fügen Sie keinen zweiten hinzu. Eine Domain mit zwei SPF-TXT-Einträgen schlägt bei der SPF-Prüfung vollständig fehl, was schlimmer ist, als gar keinen zu haben.
Klicken Sie anschließend in Mailgun auf Verify DNS Settings. Es kann bis zu einer Stunde dauern, bis die Anzeige grün wird.
⭐ Fügen Sie die MX-Einträge hinzu, auch wenn Sie nur E-Mails versenden. Über diese sammelt Mailgun Bounces ein. Ohne sie läuft ein Bounce bei einer ungültigen Adresse ins Leere, Mailgun kann diese nicht unterdrücken, und Sie zahlen weiterhin dafür, an eine Adresse zu senden, die niemals etwas empfangen wird.
3. Rufen Sie Ihren API-Schlüssel ab
Send → Sending → Domain settings → API keys, oder die Seite API Keys Ihres Kontos.
Verwenden Sie einen auf diese Domain beschränkten Sending Key, falls Ihr Tarif einen solchen anbietet, statt des privaten API-Schlüssels Ihres Kontos. Ein Sending Key kann nur E-Mails versenden; der private Schlüssel kann Ihre Logs einsehen und Änderungen an Ihrem Konto vornehmen. Es gibt keinen Grund dafür, dass wir den zweiten Schlüssel speichern.
4. Verbinden Sie ihn in Zinn®
Öffnen Sie E-Mail-Versand in Ihrem Dashboard und füllen Sie Folgendes aus:
- Anbieter — Mailgun
- Von dieser Domain senden —
mail.yourdomain.com (eine Domain, keine Adresse)
- Mailgun-Absendedomain — dieselbe Domain, die Sie in Mailgun hinzugefügt haben
- Region —
us oder eu, passend zu Schritt 1
- Mailgun-API-Schlüssel — der Schlüssel aus Schritt 3
⛔⛔ Achten Sie auf die richtige Region. In der EU gehostete Mailgun-Konten werden über einen völlig anderen API-Host bedient. Das Senden des Schlüssels eines EU-Kontos an den US-Host liefert „401 Unauthorized“ zurück – was genau wie ein falscher Schlüssel wirkt. Wenn Ihr Schlüssel definitiv korrekt ist und Sie den Fehler 401 erhalten, liegt es fast immer daran.
5. Senden Sie den Test und geben Sie den Code ein
Klicken Sie auf Testnachricht senden und verwenden Sie ein Postfach auf einer anderen Domain – eine Gmail-Adresse ist ideal. Lesen Sie den Code in diesem Postfach ab und geben Sie ihn ein. Ihr E-Mail-Versand wird sofort umgestellt.
Wenn es nicht funktioniert
401 Unauthorized — falsche Region (siehe oben), oder Sie haben einen Schlüssel aus einem anderen Mailgun-Konto eingefügt. Generieren Sie den Schlüssel neu, anstatt ihn erneut abzutippen; das vorangestellte key- geht leicht verloren.
Die Testnachricht kommt nie an — prüfen Sie Mailguns Seite Logs. Wenn Mailgun überhaupt keinen Datensatz dazu hat, ist die Anmeldeinformation oder der Domainname falsch. Wenn Mailgun sie akzeptiert hat und sie erst danach fehlschlug, wird der Grund dort im Klartext aufgeführt, und es liegt fast immer am DNS.
„Domain not found“ — das Feld Mailgun-Absendedomain muss exakt der Domain entsprechen, wie sie bei Mailgun aufgeführt ist, einschließlich der Subdomain. yourdomain.com und mail.yourdomain.com sind für Mailgun zwei unterschiedliche Domains.
Es hat funktioniert und dann aufgehört — prüfen Sie, ob Ihre kostenlose Testphase abgelaufen ist. Mailgun-Testkonten können nur an autorisierte Empfänger senden; daher funktioniert die Testnachricht an Ihre eigene Adresse weiterhin, während alle E-Mails an Ihre Kunden stillschweigend fehlschlagen.