SMTP

SMTP er den fælles konfiguration for, hvordan alle apps i Simulant sender emails — fakturaer fra Expense, password-resets fra Stack Auth, kvitteringer fra Nordbank.

I stedet for at hver app skal have sine egne SMTP-credentials, henter alle apps konfigurationen herfra. Det betyder at du kan skifte email-leverandør ét sted og få det til at slå igennem i hele økosystemet.

Siden er kun synlig for superadmins. Den ligger under Indstillinger → SMTP.

Hvad du skal udfylde

SMTP-server:

• Host — fx smtp.sendgrid.net, smtp-relay.brevo.com eller egen mailserver.
• Port — typisk 587 (TLS) eller 465 (SSL).
• Brug TLS — ja for de fleste cloud-services.
• Username — afhænger af leverandøren. Hos SendGrid er det apikey, hos Brevo er det din konto-email.
• Password — selve API-nøglen eller adgangskoden. Vises som "•••" når den er gemt.

Default afsender — bruges når en app ikke har sit eget override:

• Default sender email — fx noreply@simulant.shop. Skal være verificeret hos email-leverandøren.
• Default sender name — fx "Simulant".

Sådan tester du

Knappen Send test-email sender én email til din egen indlogget-email. Hvis den lander, virker konfigurationen. Hvis ikke, vises en fejlmeddelelse — tjek host, port og credentials.

Per-app overrides

Sektionen Per-app overrides nederst viser hver registreret app og dens nuværende afsender. Hvis felterne er tomme, bruges global default. Du sætter overrides på den enkelte app — gå til Connected apps → find appen → udfyld Sender og klik Gem.

Brug overrides hvis du vil have:

• Forskellige afsender-navne pr. app — fx "Nordbank" på bank-emails og "Simulant SKAT" på skatte-kvitteringer.
• Forskellige afsender-emails — fx nordbank@simulant.shop og expense@simulant.shop.

Sådan kommer du i gang

1. Vælg en email-leverandør (SendGrid, Brevo, Mailgun, Postmark — alle virker).
2. Verificér en afsender-email eller en hel domæne hos leverandøren.
3. Lav en API-nøgle med send-tilladelse.
4. Indtast host, port, username og password på SMTP.
5. Sæt default sender til verifikeret email.
6. Send en test-email til dig selv.
7. (Valgfrit) Sæt per-app overrides på Connected apps.

Tips

• Test før produktion. Send altid en test-email efter du har ændret konfigurationen.
• Email-leverandøren skal verificere afsender-emailen. Ellers ender mails i spam.
• TLS er standard — undgå at sende uden kryptering selv på interne servere.
• Password gemmes krypteret. Du kan ikke læse det tilbage — kun erstatte det.

Når noget ikke virker

• Test-email ankommer ikke — tjek spam-mappen først, derefter at hosten er rigtig (typisk smtp.<leverandør>.com).
• "Authentication failed" — username eller password er forkert. Hos SendGrid skal username være apikey (bogstaveligt) og password være selve API-nøglen.
• "Connection refused" — porten er forkert eller blokeret. Prøv 587 hvis 465 fejler, eller omvendt.
• Emails sendes, men ender i spam — afsender-emailen er ikke verificeret hos leverandøren, eller jeres domæne mangler SPF/DKIM-records.
• Tom Per-app overrides liste — du har ikke registreret nogen apps i Connected apps endnu.