✉️ Infrastruktur

Transaktionale E-Mails über Resend

Your Office AI sends transactional email through Resend. You need two things: an API key and a verified sending domain. Both are configured on the Auth server, which is the service that owns sign-up and account flows.

ℹ️
E-Mail liegt auf dem Auth-Server

Unlike most secrets, the Resend key goes in the Auth server's config: command_center_server/config/passwords.yaml. The Auth server handles identity, so it is the one that sends verification and invitation mail.

Was Resend versendet

E-Mail ist für den Konto-Lebenszyklus erforderlich — ohne sie können Nutzer ihre Adresse nicht bestätigen, kein Passwort zurücksetzen und keine Einladung annehmen.

📝RegistrierungBestätigungscode
🔑PasswortzurücksetzungReset-Link / -Code
👥Organisations-EinladungEinem Arbeitsbereich beitreten
Die drei transaktionalen E-Mails, die Your Office AI versendet.
E-MailWann sie versendet wird
BestätigungscodeBei der Registrierung, zur Bestätigung der E-Mail-Adresse des Nutzers.
PasswortzurücksetzungWenn ein Nutzer eine Zurücksetzung vom Anmeldebildschirm anfordert.
Organisations-EinladungWenn ein Administrator jemanden zu einer Organisation einlädt.

Einrichtung

  1. Resend-Konto und API-Schlüssel erstellen

    Registrieren Sie sich auf resend.com und öffnen Sie dann API Keys → API-Schlüssel erstellen mit Sendezugriff. Kopieren Sie den Schlüssel (er sieht aus wie re_…) sofort — Resend zeigt ihn nur einmal an.

  2. Absender-Domain verifizieren (empfohlen)

    Fügen Sie in Resend → Domains Ihre Domain hinzu und erstellen Sie die SPF-, DKIM- und DMARC-DNS-Einträge, die Resend bei Ihrem DNS-Anbieter bereitstellt. Eine verifizierte Domain sorgt für deutlich bessere Zustellbarkeit und verhindert, dass E-Mails im Spam landen. Ohne eine verifizierte Domain werden E-Mails vom gemeinsam genutzten Testsender onboarding@resend.dev von Resend versandt.

  3. Auth-Server konfigurieren

    Setzen Sie in command_center_server/config/passwords.yaml resendApiKey und — sobald Ihre Domain verifiziert ist — resendFromEmail auf eine Adresse auf dieser Domain (z. B. noreply@ihredomain.com). Verwenden Sie für jede Umgebung (development / staging / production) einen eigenen Schlüssel.

  4. Versand prüfen

    Starten Sie den Auth-Server und registrieren Sie sich mit einer Testadresse. Der Server protokolliert "[EmailService] Email sent successfully", die Bestätigungs-E-Mail trifft im Posteingang ein, und der Versand erscheint unter Logs im Resend-Dashboard.

Wohin die Werte gehören

WertDateiSchlüssel
Resend-API-Schlüsselcommand_center_server/config/passwords.yamldevelopment.resendApiKey
Absenderadresse (verifizierte Domain) (optional)command_center_server/config/passwords.yamldevelopment.resendFromEmail
💡
Domain-Verifizierung ist wichtig

Until you set resendFromEmail to an address on a verified domain, mail sends from onboarding@resend.dev and is likely to be filtered as spam. For any real deployment, verify your domain and set a from-address on it.

ℹ️
Robust by design

Schlägt ein Versand fehl, protokolliert der Auth-Server eine Warnung und speichert den Bestätigungscode dennoch in seinen Logs, bevor er einen Fehler an den Aufrufer zurückgibt — die App funktioniert weiter, auch wenn E-Mail vorübergehend nicht verfügbar ist. Beobachten Sie die Server-Logs und die Logs-Ansicht im Resend-Dashboard, um die Zustellung zu bestätigen.

Lieber SMTP?

If you would rather use SMTP — Resend's SMTP relay, or another provider such as SendGrid or AWS SES — the Auth server accepts SMTP credentials instead of the Resend HTTP API. Set the SMTP host, port, username, password, TLS flag, and from-address in the same passwords.yaml. For Resend's relay the host is smtp.resend.com on port 465 (SSL) or 587 (STARTTLS), with username resend and your API key as the password.

ℹ️
Weiter

That completes the external-service chain. Return to the Setup- und Infrastrukturübersicht to review the full checklist, or read about Sicherheit & Datenschutz.