Integration
E-Mail-Server
Konfigurieren Sie E-Mail-Server für Versand ihrer Dokumente und E-Mails
E-Mail-Serverkonfigurationen steuern, über welche externen Server und Absenderadressen Output.Rocks E-Mails verschickt. Die Liste erlaubt es, produktive SMTP-Accounts zentral zu verwalten, Aktivierungen nachzuverfolgen und Mandanten-spezifische Setups voneinander zu trennen.
E-Mails werden oft auch von Kunden-Systemen verschickt. In diesem Fall sollten generierte E-Mails über Webhooks an den Kunden-Server zurückgeleitet werden – Details hierzu finden Sie in der Einführung zum Input & Output Flow.
Diese Seite zeigt eine Liste aller Elemente, und darüber diverse Aktionen, die du ausführen kannst:
E-Mail-Server-Liste
Die Tabelle zeigt pro Konfiguration Identifier, Absender und Aktivierungsstatus. Über die Mandanten-Spalten sehen Sie sofort, ob ein Server global oder nur für einen bestimmten Untermandanten verfügbar ist.
ID, Identifier, Aktiv ab, Aktiv, Absender
| ID | Identifier | Gruppen-Identifier | Aktiv ab | Aktiv | Absender |
|---|---|---|---|---|---|
| identifier_name | Null | Aktiv |
ID
Eindeutige Nummer zur internen Identifikation des E-Mail-Servers.
Identifier
Eindeutiger Name des E-Mail-Servers für Rendering und API-Aufrufe.
Eindeutiger Name für eine optionale Gruppierung von verwandten E-Mail-Servern. Elemente einer Gruppe werden gemeinsam verarbeitet und optionale Validatoren können dabei einzelne Elemente aktivieren oder ignorieren.
Aktiv ab
Startdatum eines E-Mail-Servers. E-Mail-Servers werden erst ab diesem Datum beim Rendern beachtet.
Aktiv
Schnellübersicht, ob das E-Mail-Server derzeit freigegeben ist. Deaktivierte Elemente behalten ihre Historie, werden aber nicht mehr automatisch verwendet.
Absender
Konfigurierte SMTP-Absenderadresse, z.B. hello@output.rocks.
Verwenden Sie je Mandant unterschiedliche Identifier wie or-ses oder stadtwerk-smtp, damit sich Zustellwege eindeutig zuordnen und überwachen lassen.
Mandant, Standard für Umgebungs-Mandanten
| Umgebungs-Mandant | Standard für Umgebungs-Mandanten | Benutzerdefinierte ID | Farbe |
|---|---|---|---|
| (1880) Submarke 1 | NO | Null | |
| Null | YES | <<payload.value>> |
Zugeordneter Mandant des/der E-Mail-Server. Ermöglicht Mandanten-spezifische Konfiguration.
Kennzeichnet E-Mail-Server als Standard und vererbt (verfügbar) für alle Umgebungs-Mandanten.
Optionale benutzerdefinierte Kennung nach dem Rendering für externe Systeme. Wird als Referenzen des/der E-Mail-Server bei Callbacks übergeben und beherrscht Vorlagen-Syntax inkl. Zugriff auf Payload-Daten.
Visuelle Kennzeichnung für schnelle Identifikation des/der E-Mail-Server. Vor allem nützlich für Dashboard-Statistiken und Charts.
Mandanten-Spalten spiegeln exakt die Zuweisungen aus dem Backend wider – inklusive Links zum jeweiligen Untermandanten. So erkennen Sie sofort, ob eine Konfiguration exklusiv oder vererbbar ist.
Erstellt am, Aktualisiert am
| Validatoren | Pausiert | Aktiv | Erstellt am | Aktualisiert am |
|---|---|---|---|---|
| Null | NO | Ja | ||
| missing_street | YES | Nein |
Zugewiesene Validierungsregeln für das E-Mail-Server. Prüfen Ihre Bedingungen vor der Verarbeitung und aktivieren/deaktivieren das Rendering entsprechend.
Temporäre Deaktivierung des E-Mail-Servers. Pausierte Elemente werden nicht verarbeitet.
Aktivierungsstatus des E-Mail-Servers. Nur aktive Elemente werden beim Rendern berücksichtigt.
Erstellt am
Zeitstempel der E-Mail-Server-Erstellung.
Aktualisiert am
Zeitstempel der letzten Änderung. Zeigt wann E-Mail-Server-Konfiguration zuletzt bearbeitet wurde.
Kontext-Aktionen
Aktions-Dropdown
Aktions-Dropdown
Klicken Sie auf das Drei-Punkte-Menü am Ende jeder Zeile für Aktionen mit dem jeweiligen E-Mail-Server.
Testen
Öffnet eine E-Mail-Server-Testumgebung zum lokalen Rendern mit bearbeitbaren Validatoren und JSON-Testdaten.
E-Mail-Server herunterladen
Lädt die Quell-Datei des E-Mail-Server auf Ihren Computer herunter.
Anzeigen
Öffnet eine reine Detailansicht der kompletten Meta-Informationen und Einstellungen des E-Mail-Server.
Ändern
Öffnet das Bearbeitungsformular für alle Einstellungen und den Upload einer neuen E-Mail-Server-Version.
Löschen
Entfernt das E-Mail-Server dauerhaft aus dem System. Diese Aktion kann nicht rückgängig gemacht werden.
Nur Anzeigen und Ändern stehen direkt im Dropdown bereit. Löschaktionen laufen über die separate Batch-Auswahl, damit produktive SMTP-Zugänge nicht versehentlich entfernt werden.
Filter
- Filtern öffnet das Modal mit Kriterien wie Identifier, Aktiv-Status oder Mandant.
- Zurücksetzen entfernt alle Filter.
- Anwenden übernimmt die Auswahl und aktualisiert die Liste unmittelbar.
Spalten konfigurieren
Passen Sie die Anzeige der E-Mail-Server-Liste für bessere Übersichtlichkeit an. Spalten können per Drag-and-Drop neu angeordnet und über Checkboxen ein-/ausgeblendet werden.
Für mich anwenden : Spalten-Konfiguration wird nur für Ihren Account gespeichert und beeinflusst andere Benutzer nicht.
Als Standard anwenden : Konfiguration wird für alle Benutzer der Instanz übernommen und als neue Standard-Ansicht gesetzt.
Das Spalten-Modal bietet drei Speicheroptionen:
- Für mich anwenden – persönliche Ansicht.
- Als Standard anwenden – Konfiguration für das gesamte Team übernehmen.
- Auf Standard zurücksetzen – Ausgangszustand wiederherstellen.
E-Mail-Serverkonfiguration erstellen
Aktions-Buttons zum Speichern und Verwalten der E-Mail-Serverkonfiguration-Konfiguration.
Verwenden Sie "Erstellen und weiteres Element hinzufügen" für effizientes Batch-Erstellen mehrerer Elemente.
Formularfelder
Identifier
Eindeutige Kennung für dieses/r E-Mail-Server zur programmatischen Verwendung, Einbindung in Vorlagen, Lookups und API-Zugriff.
Identifiers sollten 'snake_case' sein, also klein geschrieben und Unterstriche verwenden, z.B. 'kunde_name' oder 'rechnung_nummer'.
DSN
Vollständiger Transport-String nach dem Muster smtp://user:pass@smtp.mailprovider.tld:587. Verwenden Sie <<credentials.*>> für Benutzername oder Passwort.
Verwenden Sie Zugangsdaten-Platzhalter wie <<credentials.smtp_password>> innerhalb der DSN, um Passwörter zentral zu pflegen. Details finden Sie unter Zugangsdaten-Verwaltung.
Absender
Adresse, die im From-Feld aller über diesen Server versendeten E-Mails erscheint.
Headers
[
{
"key": "value",
"items": [1, 2, 3]
},
{
"nested": {
"property": "value"
}
}
]Optionales JSON-Array für zusätzliche SMTP-Header, z.B. Custom-Tracking oder Sicherheitskennzeichnungen.
Beispiel: Tracking-Header mit Credentials und Payload-Werten
[
{
"X-OR-Account": "<<credentials.wert_mail_account>>",
"X-OR-Customer": "<<payload_objekt_kunde.id>>",
"X-OR-Request": "<<payload_objekt_metadata.request_id>>"
},
{
"Authorization": "Bearer <<credentials.wert_mail_api_token>>"
}
]Verwenden Sie mehrere Objekte, um unterschiedliche Header-Sets zu hinterlegen. Zugriff auf Secrets erfolgt über <<credentials.t*>>, dynamische Werte über <<payload_objekt.*>>.
Aktiv ab & Aktiv
Startdatum des E-Mail-Servers. E-Mail-Servere werden erst ab diesem Datum beim Rendern beachtet.
Die Aktiv-Checkbox ermöglicht eine sofortige De-/Aktivierung unabhängig vom Datum.
Vor-Terminierung: Mit diesem Feld können E-Mail-Servere vor-terminiert werden. Setzen Sie ein zukünftiges Datum, um das Element automatisch ab diesem Zeitpunkt zu aktivieren.
Mehrere Elemente mit gleichem Identifier: unterschiedliches 'Aktiv ab' staffelt die Version; bei einer Anfrage gilt das aktive Element mit dem spätesten Aktiv ab (nicht Erstell- oder Änderungsdatum).
Mandant & Standard für Umgebungs-Mandanten
Zuordnung zu einem spezifischen Umgebungs-Mandanten oder Standard-Verwendung für alle Mandanten.
Markiert Element als Standard-Element, das automatisch an alle Umgebungs-Mandanten vererbt wird.
Fehlermeldung: Die Kombination "Standard für Umgebungs-Mandanten" + ausgewählter "Umgebungs-Mandant" erzeugt die Fehlermeldung: Tenant defaults can not be set on tenant assigned entities. Ein Element kann entweder für einen spezifischen Mandant ODER als Standard für alle Umgebungs-Mandanten konfiguriert werden.
Verwandte Backend-Bereiche
- E-Mail-Vorlagen – definieren, welche Absender in Vorlagen verwendet werden.
- E-Mail-Anhänge – binden Dokumente an die über den Server versendeten E-Mails.
- Zugangsdaten – hinterlegen Sie SMTP-Passwörter zentral und referenzieren Sie sie per
<<credentials.*>>in Webhook-Konfigurationen.