ObjectOSKonfigurieren Sie Anbieter und Vorlagen für die Zustellung von Transaktions-E-Mails.
ObjectOS versendet Transaktions-E-Mails über das E-Mail-Plugin des Frameworks, wenn die Anwendung dies erfordert (Passwort-Zurücksetzung, Einladungen, Genehmigungsbenachrichtigungen, geplante Berichte). Das Plugin wird mit drei Transports ausgeliefert.
Transports
| Anbieter | Verwenden, wenn | Erforderliche Umgebungsvariable |
|---|---|---|
log | Lokale Entwicklung; protokolliert die E-Mail nach stdout, anstatt sie zu versenden | keine |
resend | SaaS-Zustellbarkeit über Resend | OS_EMAIL_API_KEY |
postmark | SaaS-Zustellbarkeit über Postmark | OS_EMAIL_API_KEY |
Der Standardwert ist log. ObjectOS greift auf den Log-Transport zurück,
wenn ein echter Anbieter konfiguriert ist, aber kein API-Schlüssel
angegeben wurde — nützlich, um zu verhindern, dass Nicht-Produktions-
umgebungen versehentlich E-Mails versenden.
Was ist mit SMTP?
Ein nativer SMTP-Transport ist derzeit nicht in die Laufzeit integriert. Falls Ihre Umgebung SMTP erfordert (Unternehmens-Relay, On-Prem-Mail, Air-Gapped-Bereitstellung), haben Sie zwei produktionsreife Optionen:
- Betreiben Sie ein SMTP-zu-API-Relay vor ObjectOS. Resend, Postmark und selbst gehostete Alternativen (Postal, Cuttlefish) akzeptieren alle SMTP-Eingang und geben über ihre HTTP-API weiter — ObjectOS kommuniziert wie gewohnt über HTTPS mit ihnen.
- Betreiben Sie die Laufzeit mit einem benutzerdefinierten
E-Mail-Plugin. Die API des E-Mail-Plugins ist klein (eine einzige
send(message)-Funktion); ein Projekt-Plugin, dasnodemailerumschließt, wird über dierequires-Liste eingebunden. Siehe den Leitfaden zur Plugin-Entwicklung im Spec-Repository.
Ein nativer SMTP-Transport ist in der Roadmap geplant; verfolgen Sie den Fortschritt unter github.com/objectstack-ai/objectos/issues.
Umgebungsvariablen
| Variable | Zweck |
|---|---|
OS_EMAIL_PROVIDER | log, resend oder postmark |
OS_EMAIL_API_KEY | API-Schlüssel des Anbieters (Resend oder Postmark) |
OS_EMAIL_FROM | Standard-Absenderadresse. Unterstützt sowohl das Format addr@x als auch Name <addr@x> |
OS_EMAIL_RETRIES | Anzahl der Transport-Wiederholungsversuche bei Sendefehlern (Standard 0) |
Umgebungsvariablen überschreiben übereinstimmende Werte im
email-Konfigurationsblock des Artefakts, sodass Betreiber die
Zustellung umleiten können, ohne das Artefakt neu zu erstellen.
Vorlagen
Wiederverwendbare Vorlagen werden in sys_email_template gespeichert.
Vorlagen unterstützen die Variableninterpolation, die von der
Template-Engine des Frameworks ausgewertet wird. Anwendungscode (oder
ein Flow) ruft den E-Mail-Dienst mit einer Vorlagen-ID und einem
Variablenbündel auf; der Dienst materialisiert Betreff/Inhalt und
übergibt ihn an den konfigurierten Transport.
Zustellung überprüfen
Stellen Sie für Resend / Postmark sicher, dass die sendende Domain im Dashboard des Anbieters konfiguriert ist (SPF, DKIM, optional DMARC). Die schnellste End-to-End-Prüfung ist die Aktion Test-E-Mail senden in der Console auf der Seite der E-Mail-Einstellungen — sie verwendet den Live-Transport und zeigt Transportfehler direkt an.
Betriebshinweise
- Behandeln Sie den API-Schlüssel als Geheimnis. Speichern Sie ihn im Secret-Manager des Kunden, niemals im Artefakt.
- Beobachten Sie die Transportfehler-Protokolle: Ratenbegrenzungen des Anbieters, Unterdrückungen und Bounces erscheinen alle dort.
- Audit-relevante Transaktions-E-Mails (Passwort-Zurücksetzung, MFA-Challenge) sollten gemäß der Richtlinie des Kunden aufbewahrt werden — legen Sie die Aufbewahrung im Audit-Log fest, nicht im Transport.
- Ausgehende E-Mails blockieren keine Geschäftstransaktionen: Sendefehler werden als Fehler angezeigt, machen aber die ursprüngliche Datensatzänderung nicht rückgängig.