Domains
Produktions-E-Mail erfordert eine verifizierte Versanddomain. Truncus unterstützt die Konfiguration pro Tenant.
Schritt 1 — Domain hinzufügen
Dashboard → Domains → Domain hinzufügen
Truncus generiert die DNS-Einträge, die Sie hinzufügen müssen.
Schritt 2 — DNS konfigurieren
SPF
Type: TXT
Name: @
Value: v=spf1 include:truncus.co ~all
Wenn bereits ein SPF-Eintrag vorhanden ist, fügen Sie include:truncus.co hinzu, statt einen zweiten TXT-Eintrag zu erstellen.
DKIM
Type: TXT
Name: truncus._domainkey.ihredomain.de
Value: [Im Dashboard angezeigt]
DMARC (empfohlen)
Type: TXT
Name: _dmarc.ihredomain.de
Value: v=DMARC1; p=none; rua=mailto:dmarc@ihredomain.de
Beginnen Sie mit p=none. Wechseln Sie zu p=quarantine oder p=reject, sobald legitimer Traffic ausgerichtet ist.
Schritt 3 — Verifizieren
Die Verifizierung läuft automatisch nach DNS-Propagation.
Typische Propagationszeit: 1–5 Minuten bei Cloudflare. Bis zu 48 Stunden bei älteren Registraren.
Domain-Aufwärmung
Neue Domains starten mit einem konservativen Sendelimit zum Schutz der Zustellbarkeitsreputation.
| Tag | Tageslimit |
|---|---|
| 1 | 500 E-Mails |
| 2 | 2.000 E-Mails |
| 3 | 10.000 E-Mails |
| 4 | 25.000 E-Mails |
| 5+ | Plan-Limit |
Die Aufwärmung erfolgt automatisch. Fortschritt im Dashboard sichtbar.
Multi-Tenant-Domains
Plattformen, die E-Mails im Auftrag ihrer Kunden senden, können pro-Kunden-Domains konfigurieren.
Jede Domain pflegt eine unabhängige Reputation und Unterdrückungsliste. Ein Bounce auf Domain A beeinträchtigt Domain B nicht.
Geteilte Domain (Entwicklung)
Im Free-Plan können Sie von mail.truncus.co senden ohne Domain-Konfiguration. Nur für Tests empfohlen.
Produktionssendungen sollten immer eine verifizierte Domain verwenden.
Eine Domain entfernen
Um eine Versanddomain zu entfernen, rufen Sie DELETE /v1/domains/{id} mit einem API-Schlüssel auf, der den Scope read_domains besitzt. Sie können nur Domains entfernen, die zu Ihrem eigenen Projekt gehören.
curl -X DELETE https://truncus.co/api/v1/domains/dom_123 \
-H "Authorization: Bearer tr_live_..."
Das Entfernen einer Domain bewirkt Folgendes:
- Löscht ihre SES-Sender-Identität.
- Gibt ihren Scaleway-TEM-Slot frei, sofern einer belegt war.
- Löscht die operativen Alert-Einträge der Domain.
- Setzt die Domain auf gelöscht (soft-delete) und gibt den Domain-Slot in Ihrem Plan frei. Die Domain sendet nicht mehr und verschwindet aus Ihrem Konto.
Der Aufruf ist idempotent: Eine unbekannte oder bereits entfernte Domain gibt 404 zurück, eine Domain eines anderen Projekts gibt 403 zurück.
Was erhalten bleibt: Ihre Sende-Logs und Unterdrückungseinträge bleiben als Audit-Trail gemäß der Aufbewahrungsrichtlinie erhalten. Sie werden beim Entfernen einer Domain nicht gelöscht.