Platform guides
Mailgun-API-Schlüssel für deinen E-Mail-Versand einrichten
Mit dem privaten API-Schlüssel von Mailgun verbindest du eine bereits verifizierte Versanddomain mit deinem ONE LOOP Standort.
Kurz erklärt
Mit dem privaten API-Schlüssel von Mailgun verbindest du eine bereits verifizierte Versanddomain mit deinem ONE LOOP Standort. Danach kannst du diese Domain in den E-Mail-Diensteinstellungen auswählen, E-Mails zuverlässig versenden und Antworten über die eingerichtete Empfangsroute verarbeiten.
Der Schlüssel ist ein geheimer Zugang. Gib ihn nie in Tickets, Chat-Nachrichten oder Screenshots weiter.
Voraussetzungen
Du hast ein Mailgun-Konto mit mindestens einer verifizierten Versanddomain.
Die DNS-Einträge der Versanddomain sind vollständig eingerichtet: SPF, DKIM, MX und – falls genutzt – der CNAME für Link-Tracking.
Die Domain ist bei Mailgun in der US-Region angelegt und als verifiziert markiert.
Du kannst in deinem ONE LOOP Standort die E-Mail-Diensteinstellungen öffnen.
Falls bei Mailgun eine IP-Positivliste aktiv ist, kannst du sie für die Verbindung vorübergehend anpassen.
Vor dem Verbinden
Richte den Schlüssel erst ein, wenn deine Versanddomain in Mailgun als verifiziert angezeigt wird. Die Verbindung liest nur verifizierte Domains aus dem US-Bereich ein. Eine Domain aus dem EU-Bereich oder eine noch nicht bestätigte Domain erscheint deshalb nicht zur Auswahl.
Der Private API Key ist ein geheimer Zugang zu deinem Mailgun-Konto. Kopiere ihn nur direkt in das dafür vorgesehene Feld. Speichere ihn nicht in Notizen, E-Mails oder Screenshots und sende ihn niemals an andere Personen. Wenn du vermutest, dass der Schlüssel bekannt geworden ist, erstelle einen neuen und ersetze den bisherigen Schlüssel.
Lege vor dem Speichern fest, welche Versanddomain du anschließend auswählen möchtest. So kannst du direkt erkennen, ob die Verbindung die erwartete Domain geladen hat.
Schritt für Schritt
Melde dich bei Mailgun an und öffne oben rechts dein Profil.
Wähle API Security.
Kopiere einen vorhandenen Private API Key oder lege einen neuen privaten Schlüssel an.
Öffne in deinem ONE LOOP Standort die E-Mail-Diensteinstellungen.
Wähle Mailgun als E-Mail-Dienst aus.
Füge den privaten API-Schlüssel ein und speichere die Verbindung.
Wähle anschließend die verifizierte Versanddomain aus der Domain-Auswahl aus.
Speichere die Einstellungen.
Sende eine Test-E-Mail an eine Adresse, auf die du Zugriff hast.
Ergebnis prüfen
Prüfe diese Punkte direkt nach dem Speichern:
Deine verifizierte Versanddomain erscheint in der Domain-Auswahl.
Die Domain ist bei Mailgun als verifiziert markiert.
Die Test-E-Mail wird zugestellt.
Wenn eine Empfangsroute eingerichtet ist, werden Antworten dem richtigen Kontakt im ONE LOOP Standort zugeordnet.
Praxisbeispiel
Du nutzt bereits die Versand-Subdomain mg.beispiel-firma.de und sie ist in Mailgun als verifiziert markiert. Du öffnest dort API Security, kopierst einen neu angelegten privaten Schlüssel und fügst ihn unmittelbar in die E-Mail-Diensteinstellungen deines ONE LOOP Standorts ein. Nach dem Speichern erscheint mg.beispiel-firma.de in der Domain-Auswahl. Du wählst sie aus, speicherst erneut und schickst eine E-Mail an deine eigene Testadresse. Erst wenn diese Nachricht ankommt, ist die Umstellung abgeschlossen.
Häufige Fehler
Die Domain erscheint nicht in der Auswahl
Prüfe zuerst die Region: Es werden nur verifizierte Mailgun-Domains aus der US-Region übernommen. Eine Domain aus der EU-Region erscheint nicht in der Auswahl.
Kontrolliere danach, ob die Domain bei Mailgun wirklich als verifiziert markiert ist. Bei einer IP-Positivliste kann die Domain-Synchronisierung blockiert sein. Passe die Positivliste nur so weit wie nötig an und stelle die gewünschte Einschränkung nach der Prüfung wieder her.
Ich habe den öffentlichen Schlüssel eingefügt
Für die Verbindung brauchst du den Private API Key. Ein öffentlicher Schlüssel authentifiziert den E-Mail-Dienst nicht.
Nach einem Schlüsselwechsel funktioniert der Versand nicht mehr
Erstelle in Mailgun einen neuen privaten Schlüssel, hinterlege ihn in den E-Mail-Diensteinstellungen und speichere erneut. Teste danach den Versand. Widerrufe einen alten Schlüssel erst, wenn der neue Schlüssel erfolgreich funktioniert.
Die Test-E-Mail kommt nicht an
Prüfe nacheinander die Verifizierung der Domain, die DNS-Einträge, den eingefügten privaten Schlüssel und die gewählte Versanddomain. Prüfe außerdem den Spam-Ordner der Empfängeradresse.
Gut zu wissen
Eine Versanddomain muss vor der Auswahl bei Mailgun verifiziert sein.
Ein privater Schlüssel kann aus Sicherheitsgründen regelmäßig gewechselt werden. Aktualisiere ihn danach immer auch im ONE LOOP Standort.
Nutze für unterschiedliche Bereiche getrennte Subdomains, wenn du Versand und E-Mail-Empfang klar voneinander trennen möchtest.
Änderungen an DNS, API-Schlüssel oder Versanddomain sollten immer mit einer Test-E-Mail überprüft werden.
Klicks und Öffnungen für eine Mailgun-Domain auswerten
Damit du Öffnungen, Linkklicks, Abmeldungen, Unzustellbarkeiten und Spam-Beschwerden im Standort auswerten kannst, braucht jede verwendete Mailgun-Versanddomain zwei Einstellungen: die Ereignisweitergabe und das Tracking direkt an der Domain.
Ereignisse pro Versanddomain weitergeben
Die Ereignisweitergabe wird in Mailgun auf Domain-Ebene eingerichtet. Öffne dort Send → Webhooks, wähle den Tab für die Versanddomain und füge eine neue Ereignisweitergabe hinzu.
Gib ihr eine klare Bezeichnung, etwa „E-Mail-Ereignisse Standort“.
Verwende ausschließlich die für den Standort vorgesehene Ereignisadresse. Ist sie in deinen Verbindungsdaten nicht hinterlegt, fordere sie beim ONE LOOP Support an; verwende keine frei erfundene oder fremde Adresse.
Wähle die richtige Versanddomain.
Aktiviere alle Ereignistypen: angenommen, zugestellt, geöffnet, geklickt, dauerhafter oder vorübergehender Fehler, Spam-Beschwerde und Abmeldung.
Teste die Erreichbarkeit, wenn Mailgun eine Testfunktion anbietet, und speichere anschließend.
Eine Einrichtung gilt immer nur für die ausgewählte Domain. Wiederhole sie daher für jede weitere Versanddomain.
Link- und Öffnungs-Tracking aktivieren
Öffne in Mailgun Send → Domains und wähle die Versanddomain.
Öffne Settings und den Bereich für Tracking.
Aktiviere Link-Tracking und Öffnungs-Tracking.
Stelle sicher, dass das Tracking über HTTPS läuft und das Tracking-Zertifikat aktiv ist.
Speichere jede Änderung.
Für das Link-Tracking muss der von Mailgun verlangte CNAME-Eintrag im DNS der Domain vorhanden sein. Solange das Zertifikat nicht aktiv ist, fehlt der Eintrag möglicherweise noch oder die DNS-Änderung ist noch nicht weltweit übernommen. Linkziele können dann nicht zuverlässig funktionieren.
Ergebnis prüfen
Sende eine Test-E-Mail mit mindestens einem Link an eine eigene Testadresse.
Öffne die E-Mail und wähle den Link aus.
Prüfe in Mailgun die Übermittlung der Ereignisse.
Prüfe anschließend die E-Mail-Kennzahlen im Standort.
Wiederhole den Test für jede Versanddomain.
Fehlen Öffnungen oder Klicks, kontrolliere zuerst, ob Tracking wirklich aktiviert ist und die Ereignisweitergabe für die Domain – nicht nur auf Kontoebene – eingerichtet wurde. Bei einem fehlerhaften Test kontrollierst du die Zieladresse Zeichen für Zeichen und öffnest die Fehlerprotokolle in Mailgun.