doppelt.digital Application Platform Dokumentation
English Deutsch

Funktionen

SMTP mit Mailtrap einrichten

Mailtrap als SMTP-Relay mit der Application Platform verbinden – Schritt für Schritt.

Auf dieser Seite

Diese Anleitung beschreibt die Einrichtung eines SMTP-Zugangs bei Mailtrap und die Übernahme der Werte in die Application Platform. Mailtrap bietet zwei Produkte: Email Sending für den echten Versand (das richten wir hier ein) und eine Email Sandbox zum gefahrlosen Testen.

Überblick als Diagramm

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

flowchart LR
  subgraph platform["Application Platform"]
    cred["SMTP-Credential der Organisation"]
  end
  subgraph app["Projekt-Backend"]
    svc["E-Mail-Versand"]
  end
  subgraph mailtrap["Mailtrap"]
    relay["SMTP-Relay (Email Sending)"]
  end
  subgraph dest["Empfänger"]
    mx["Empfänger-Mailserver"]
  end
  svc -->|"liest Konfiguration"| cred
  svc -->|"TLS, Port 587"| relay
  relay --> 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.
  3. SMTP-Zugangsdaten abrufen: Öffne bei der verifizierten Domain die Integration → SMTP. Mailtrap zeigt dir Host, Port, Benutzername und das API-Token als Passwort an.
  4. Optional: Testmail senden, um die Einrichtung zu prüfen.

Eintrag in der Application Platform

Lege unter E-Mail-Versand einen neuen SMTP-Zugang an und trage die Werte aus der Mailtrap-Integrationsseite ein:

Plattform-Feld Wert bei Mailtrap (Email Sending)
SMTP Host live.smtp.mailtrap.io
SMTP Port 587 (STARTTLS)
SMTP User api
SMTP Passwort Dein Mailtrap-API-Token
Absender-Adresse Eine Adresse deiner verifizierten Sending Domain
Absendername Anzeigename für Empfänger

Speichern – danach können deine Projekte das Credential für den Versand nutzen.

Achtung
Verwechsle die Zugangsdaten nicht mit der Email Sandbox (sandbox.smtp.mailtrap.io): Die Sandbox stellt nichts an echte Empfänger zu, sondern fängt Mails in einer Test-Inbox ab. Für den Produktivversand brauchst du die Werte aus Email Sending.

Tipp: Sandbox zum Testen

Für Entwicklung und Staging kannst du ein zweites SMTP-Credential mit den Sandbox-Zugangsdaten anlegen: Alle Mails landen dann in der Mailtrap-Test-Inbox statt bei echten Empfängern – inklusive HTML- und Spam-Check.

Fehlersuche

  • Authentifizierung fehlgeschlagen: Benutzername muss api sein, das Passwort ist das API-Token – prüfe, ob es vollständig kopiert wurde.
  • Versand abgelehnt / nicht zugestellt: Sending Domain noch nicht verifiziert – prüfe die DNS-Einträge (SPF/DKIM/DMARC) unter Sending Domains.
  • Mails landen in der Test-Inbox: Du nutzt versehentlich die Sandbox-Zugangsdaten statt Email Sending.

Siehe auch