E-Mail-Versand mit Mailtrap einrichten

Diese Anleitung beschreibt die Einrichtung einer Mailtrap-Anbindung und die Nutzung als Mail-Account in der Application Platform. Mailtrap ist als eigener Anbindungstyp in der Plattform integriert: Du hinterlegst lediglich ein API-Token, die Plattform übernimmt Versand, Status- und Domain-Überwachung. Alternativ kannst du weiterhin einen generischen SMTP-Zugang anlegen (z. B. für andere Anbieter) – siehe SMTP, IMAP und Co..

Überblick als Diagramm

Der Versandpfad: deine Anwendung nutzt das in der Plattform hinterlegte Mail-Account-Credential (Mailtrap oder SMTP) und spricht mit Mailtrap; Mailtrap liefert die Nachricht an die Empfänger-Domain aus.

flowchart LR
  subgraph platform["Application Platform"]
    cred["Mailtrap-Credential der Organisation"]
  end
  subgraph app["Projekt-Backend"]
    svc["E-Mail-Versand"]
  end
  subgraph mailtrap["Mailtrap"]
    api["Sending API"]
  end
  subgraph dest["Empfänger"]
    mx["Empfänger-Mailserver"]
  end
  svc -->|"liest Konfiguration"| cred
  svc -->|"API-Token"| api
  api --> mx

Schritte bei Mailtrap

1. Konto anlegen oder öffnen unter mailtrap.io und anmelden.
2. Sending Domain hinzufügen: Unter Sending Domains deine Absender-Domain eintragen. Mailtrap zeigt dir die DNS-Einträge (SPF, DKIM, DMARC), die du bei deinem Domain-Anbieter setzt – erst nach der Verifizierung ist der Versand freigeschaltet. Diesen Schritt kannst du auch direkt aus der Application Platform heraus erledigen (siehe unten).
3. API-Token erzeugen: Unter Settings → API Tokens ein Sending-API-Token erstellen und kopieren.

Anbindung in der Application Platform anlegen

1. Öffne im Projekt-Menü Anbindungen und klicke auf Anbindung hinzufügen.
2. Wähle die Kachel Mailtrap.
3. Trage dein API-Token ein sowie optional Absendername und Absender-Adresse für den Versand.
4. Speichern – das Credential steht danach in Projekten als Mail-Account zur Auswahl.

Status und Domains direkt in der Plattform

Über die Kachel der Mailtrap-Anbindung (unter Anbindungen) öffnest du die Detailansicht mit:

• Status (verbunden/Fehler) sowie Plan und Sendevolumen des Mailtrap-Accounts,
• der Liste deiner Sending Domains inklusive Verifizierungsstatus,
• den DNS-Einträgen je Domain (Typ, Name, Wert, Prüfstatus) – dieselben Werte, die du bei deinem Domain-Anbieter setzt,
• der Möglichkeit, neue Sending Domains direkt anzulegen.

Damit musst du für die laufende Überwachung nicht mehr zwischen Mailtrap-Dashboard und Plattform wechseln.

Mail-Account in Projekten auswählen

Im Projekt-Composer bzw. in den Backend-Einstellungen eines Projekts wählst du unter Mail-Account entweder einen Mailtrap- oder einen SMTP-Zugang aus – beide Anbindungstypen erscheinen gemeinsam in dieser Auswahl.

Fehlersuche

• Status zeigt Fehler: API-Token prüfen (ggf. neu erzeugen und Credential aktualisieren).
• Versand abgelehnt / nicht zugestellt: Sending Domain noch nicht verifiziert – prüfe die DNS-Einträge (SPF/DKIM/DMARC) in der Detailansicht der Anbindung.
• Domain fehlt in der Liste: Über „Domain hinzufügen“ in der Detailansicht neu anlegen und die angezeigten DNS-Einträge setzen.

Siehe auch

• E-Mail-Versand (Übersicht)
• Anbindungen
• SMTP, IMAP und Co.