Die SMTP-Integration verbindet jeden SMTP-fähigen E-Mail-Dienst mit Notifuse, mit Passwort-Authentifizierung oder mit OAuth2 für Microsoft 365 und Gmail.
Konfiguration
Gehen Sie zu Einstellungen → Integrationen, klicken Sie auf Integration hinzufügen und wählen Sie dann SMTP unter E-Mail-Versand. Das Formular öffnet sich als ganze Seite.
Grundeinstellungen
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Name | Anzeigename dieser SMTP-Konfiguration | Company SMTP |
| Host | Hostname des SMTP-Servers | smtp.gmail.com |
| Port | Port des SMTP-Servers: 587 für STARTTLS, 465 für TLS ab dem ersten Byte, 25 unverschlüsselt | 587 |
| Verschlüsselung | Der Schalter TLS verwenden. An: STARTTLS, oder TLS ab dem ersten Byte auf Port 465. Aus: Klartext | On |
| EHLO-Hostname | Hostname, der mit dem SMTP-Befehl EHLO gesendet wird. Ohne Angabe wird der Host verwendet. Nützlich, wenn ein Server EHLO localhost ablehnt. | mail.yourdomain.com |
Authentifizierungsart
Wählen Sie im Bereich Authentifizierung unter Methode eine von zwei Optionen:
| Option | Beschreibung | Einsatzzweck |
|---|---|---|
| Benutzername und Passwort | Basic Authentication | Die meisten SMTP-Server, App-Passwörter |
| OAuth2 | Token-basierte Authentifizierung | Microsoft 365, Gmail (seit 2024 Pflicht) |
Basic Authentication
Für SMTP-Server, die ein Passwort annehmen, oder Dienste, die App-Passwörter unterstützen.
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Benutzername | Benutzername für die Authentifizierung. Leer lassen bei einem Server, der Mails ohne Anmeldung annimmt | your-email@gmail.com |
| Passwort | Passwort für die Authentifizierung | your-app-password |
OAuth2-Authentifizierung
Microsoft 365 und Gmail haben Basic Authentication abgekündigt und verlangen deshalb OAuth2.
Microsoft 365 OAuth2
Microsoft 365 nutzt für die Authentifizierung zwischen Servern den Client Credentials Flow.
Voraussetzungen
- Ein Microsoft 365 Business-Konto (kein privates Outlook.com)
- Administratorzugriff auf Azure AD
- Administratorzugriff auf Exchange Online
Schritt 1: Azure-AD-Anwendung registrieren
- Gehen Sie im Azure Portal zu Azure Active Directory → App registrations
- Klicken Sie auf New registration
- Geben Sie einen Namen ein (z. B. „Notifuse SMTP“)
- Wählen Sie Accounts in this organizational directory only (Single Tenant)
- Klicken Sie auf Register
- Notieren Sie Application (client) ID und Directory (tenant) ID
Schritt 2: Client Secret erstellen
- Gehen Sie in Ihrer App-Registrierung zu Certificates & secrets
- Klicken Sie auf New client secret
- Geben Sie eine Beschreibung ein und wählen Sie die Gültigkeitsdauer
- Klicken Sie auf Add
- Kopieren Sie den Wert des Secrets sofort (er wird nicht noch einmal angezeigt)
Schritt 3: API-Berechtigung hinzufügen
- Gehen Sie zu API permissions → Add a permission
- Wählen Sie APIs my organization uses
- Suchen Sie nach Office 365 Exchange Online
- Wählen Sie Application permissions
- Kreuzen Sie SMTP.SendAsApp an
- Klicken Sie auf Add permissions
- Klicken Sie auf Grant admin consent for [Your Organization]
Schritt 4: Service Principal in Exchange Online registrieren
Dieser Schritt wird oft vergessen, und ohne ihn schlägt die Authentifizierung fehl. Verbinden Sie sich mit Exchange Online PowerShell:
# Install module if needed
Install-Module -Name ExchangeOnlineManagement
# Connect to Exchange Online
Connect-ExchangeOnline -UserPrincipalName admin@yourdomain.com
# Register the service principal
New-ServicePrincipal -AppId <Application-Client-ID> -ObjectId <Object-ID>
Warnung
Die ObjectId muss aus Enterprise Applications stammen, nicht aus App Registrations.
So finden Sie die richtige Object ID:
- Gehen Sie im Azure Portal zu Microsoft Entra ID → Enterprise Applications
- Suchen Sie nach dem Namen Ihrer App
- Kopieren Sie die Object ID von der Übersichtsseite
Schritt 5: Postfachberechtigung erteilen
Erteilen Sie dem Service Principal die Berechtigung, im Namen eines bestimmten Postfachs zu senden:
# Grant full access to the mailbox
Add-MailboxPermission -Identity "sender@yourdomain.com" -User <Object-ID> -AccessRights FullAccess
# Grant send-as permission
Add-RecipientPermission -Identity "sender@yourdomain.com" -Trustee <Object-ID> -AccessRights SendAs
Schritt 6: SMTP AUTH für das Postfach aktivieren
Aktivieren Sie SMTP AUTH für das sendende Postfach, im Microsoft 365 Admin Center oder per PowerShell:
Option A: Microsoft 365 Admin Center
- Gehen Sie zu Users → Active users
- Wählen Sie den Absender-Benutzer aus
- Klicken Sie auf den Reiter Mail → Manage email apps
- Kreuzen Sie Authenticated SMTP an
- Klicken Sie auf Save changes
Option B: PowerShell
# Enable SMTP AUTH for the mailbox
Set-CASMailbox -Identity "sender@yourdomain.com" -SmtpClientAuthenticationDisabled $false
Warnung
Wenn in Ihrem Microsoft-Entra-Mandanten Security Defaults aktiviert ist, ist SMTP AUTH für die gesamte Organisation gesperrt. Unter Umständen müssen Sie die Security Defaults deaktivieren oder stattdessen Richtlinien für bedingten Zugriff verwenden.
Schritt 7: In Notifuse einrichten
| Feld | Wert |
|---|---|
| Host | smtp.office365.com |
| Port | 587 |
| TLS verwenden | On |
| Methode | OAuth2 |
| OAuth2-Anbieter | Microsoft 365 / Office 365 |
| Postfachadresse | E-Mail-Adresse des Absenders (z. B. sender@yourdomain.com) |
| Mandanten-ID | Ihre Directory (tenant) ID aus Azure AD |
| Client-ID | Application (client) ID aus Azure |
| Client Secret | Wert des Secrets aus Schritt 2 |
Warnung
Die Postfachadresse muss dem Postfach entsprechen, dem Sie in Schritt 5 Berechtigungen erteilt haben.
Gmail OAuth2
Gmail nutzt für die Authentifizierung den Refresh Token Flow.
Voraussetzungen
- Ein Google-Konto (privates Gmail oder Google Workspace)
- Zugriff auf die Google Cloud Console
- Ein Terminal mit installiertem
curl
Schritt 1: Google-Cloud-Projekt erstellen
- Gehen Sie zur Google Cloud Console
- Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus
- Aktivieren Sie die Gmail API:
- Gehen Sie zu APIs & Services → Library
- Suchen Sie nach „Gmail API“ und aktivieren Sie sie
Schritt 2: OAuth-Zustimmungsbildschirm einrichten
- Gehen Sie zu APIs & Services → OAuth consent screen
- Wählen Sie den Nutzertyp External (oder Internal bei Workspace)
- Geben Sie die App-Informationen ein:
- App name: „Notifuse“ (oder ein Name Ihrer Wahl)
- User support email: Ihre E-Mail-Adresse
- Developer contact: Ihre E-Mail-Adresse
- Klicken Sie auf Save and Continue
- Klicken Sie auf der Seite Scopes auf Add or Remove Scopes
- Fügen Sie den Scope
https://mail.google.com/hinzu - Klicken Sie auf Save and Continue
- Fügen Sie auf der Seite Test users Ihre Gmail-Adresse hinzu
- Klicken Sie auf Save and Continue, um den Assistenten abzuschließen
Schritt 3: App veröffentlichen (nötig für langlebige Tokens)
Warnung
Im Modus „Testing“ laufen Refresh-Tokens nach 7 Tagen ab. Veröffentlichen Sie Ihre App, um dauerhafte Refresh-Tokens zu erhalten.
- Gehen Sie zu APIs & Services → OAuth consent screen
- Klicken Sie auf Publish App
- Bestätigen Sie mit Confirm
Der Status der App wechselt von „Testing“ zu „In production“.
Hinweis
Keine Google-Verifizierung für den persönlichen Gebrauch nötig
Eine Veröffentlichung Ihrer App erfordert KEINE Verifizierung durch Google, wenn:
- Sie weniger als 100 Nutzer haben
- Sie die App für persönliche oder interne Zwecke nutzen
Wenn beim Autorisieren die Warnung „unverified app“ erscheint, klicken Sie auf Advanced → Go to [App Name] (unsafe), um fortzufahren.
Schritt 4: OAuth-Zugangsdaten erstellen
- Gehen Sie zu APIs & Services → Credentials
- Klicken Sie auf Create Credentials → OAuth client ID
- Wählen Sie Web application
- Geben Sie einen Namen ein (z. B. „Notifuse SMTP“)
- Klicken Sie unter Authorized redirect URIs auf Add URI
- Geben Sie
http://localhostein - Klicken Sie auf Create
- Ein Dialog zeigt Ihre Client ID und Ihr Client Secret: Speichern Sie beide
Schritt 5: Autorisierungscode abrufen
Öffnen Sie diese URL in Ihrem Browser und setzen Sie Ihre Client-ID anstelle von YOUR_CLIENT_ID ein:
https://accounts.google.com/o/oauth2/v2/auth?client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&scope=https://mail.google.com/&response_type=code&access_type=offline&prompt=consent
Wichtige URL-Parameter:
scope=https://mail.google.com/: nötig für den SMTP-Zugriffaccess_type=offline: nötig, um ein Refresh-Token zu erhaltenprompt=consent: zwingt Google, ein neues Refresh-Token auszugeben
Nachdem Sie sich angemeldet und die Berechtigung erteilt haben, leitet der Browser auf eine Adresse wie diese weiter:
http://localhost/?code=4/0AQSTgQF...LONG_CODE...&scope=https://mail.google.com/
Kopieren Sie den gesamten Wert von code (alles zwischen code= und &scope).
Tipp
Enthält der Code %2F, ersetzen Sie es vor der Verwendung durch /.
Schritt 6: Code gegen ein Refresh-Token tauschen
Führen Sie diesen curl-Befehl in Ihrem Terminal aus und ersetzen Sie die Platzhalter durch Ihre Werte:
curl -X POST https://oauth2.googleapis.com/token \
-d "code=YOUR_AUTHORIZATION_CODE" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "redirect_uri=http://localhost" \
-d "grant_type=authorization_code"
Erfolgreiche Antwort:
{
"access_token": "ya29.a0AfH6SMBx...",
"expires_in": 3599,
"refresh_token": "1//0eHusbKw...",
"scope": "https://mail.google.com/",
"token_type": "Bearer"
}
Warnung
Speichern Sie Ihr refresh_token jetzt. Google gibt es nur bei der ersten Autorisierung zurück. Wenn Sie es verlieren, müssen Sie den Zugriff widerrufen und erneut autorisieren.
Schritt 7: In Notifuse einrichten
| Feld | Wert |
|---|---|
| Host | smtp.gmail.com |
| Port | 587 |
| TLS verwenden | On |
| Methode | OAuth2 |
| OAuth2-Anbieter | Google Workspace / Gmail |
| Postfachadresse | Ihre Gmail-Adresse |
| Client-ID | Client ID aus Schritt 4 |
| Client Secret | Client Secret aus Schritt 4 |
| Refresh-Token | Refresh-Token aus Schritt 6 |
Lebensdauer des Refresh-Tokens
Bei einer veröffentlichten App bleibt das Refresh-Token unbegrenzt gültig, außer wenn:
| Bedingung | Folge |
|---|---|
| Das Token 6 Monate lang nicht genutzt wird | Das Token läuft ab |
| Sie Ihr Google-Passwort ändern | Das Token wird widerrufen |
| Sie 50 Refresh-Tokens pro Client überschreiten | Das älteste Token wird automatisch widerrufen |
| Sie den Zugriff unter myaccount.google.com/permissions manuell widerrufen | Das Token wird widerrufen |
Hinweis
Wird Ihr Token ungültig, wiederholen Sie die Schritte 5 und 6, um ein neues Refresh-Token zu erzeugen.
Absenderliste
Fügen Sie die Absenderadressen hinzu, die diese SMTP-Integration verwenden darf:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Name | Anzeigename des Absenders | Support Team |
| E-Mail-Adresse des Absenders | support@yourdomain.com |
Klicken Sie auf Absender hinzufügen, um weitere Absenderadressen anzulegen.
Verwendungszwecke
Legen Sie fest, was diese SMTP-Integration versendet: im Menü ⋯ ihrer Karte unter Einstellungen → Integrationen (Für Marketing verwenden, Für Transaktionales verwenden) oder im Bereich E-Mail-Versand derselben Seite:
| Option | Beschreibung |
|---|---|
| Für Transaktionales verwenden | Passwort-Zurücksetzungen, Bestellbestätigungen, Benachrichtigungen |
| Für Marketing verwenden | Newsletter, Werbekampagnen, Ankündigungen |
Wählen Sie beides, um alle Arten von E-Mails über dieselbe SMTP-Konfiguration zu versenden.
Einschränkungen
SMTP hat keine Webhooks. Notifuse erhält von einer SMTP-Integration daher keine Statusmeldungen zur Zustellung, keine Bounce-Benachrichtigungen und keine Spam- oder Missbrauchsbeschwerden.
Info
Notifuse fügt allen E-Mails Öffnungs- und Klick-Tracking hinzu, unabhängig vom E-Mail-Anbieter.
Für Zustell-Webhooks und die weiteren Funktionen eines Anbieters verwenden Sie einen E-Mail-Dienstleister wie Mailgun, Postmark oder SparkPost.
Gängige SMTP-Server
| Anbieter | Host | Port | TLS | Authentifizierung |
|---|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | Ja | OAuth2 (Pflicht) |
| Microsoft 365 | smtp.office365.com | 587 | Ja | OAuth2 (Pflicht) |
| Amazon SES | email-smtp.region.amazonaws.com | 587 | Ja | Basic Auth |
| SendGrid | smtp.sendgrid.net | 587 | Ja | Basic Auth |
| Mailgun | smtp.mailgun.org | 587 | Ja | Basic Auth |
Hinweis
Gmail und Microsoft 365 haben Basic Authentication abgekündigt: Verwenden Sie dort OAuth2.
Fehlerbehebung
Microsoft 365: “535 5.7.3 Authentication unsuccessful”
Dieser Fehler bedeutet meist:
- Der Service Principal ist nicht in Exchange Online registriert (Schritt 4)
- Die Postfachberechtigungen wurden nicht erteilt (Schritt 5)
- Die Postfachadresse entspricht nicht dem berechtigten Postfach
Gmail: “unauthorized_client”
Dieser Fehler bedeutet:
- Das Refresh-Token wurde mit einer anderen Client-ID oder einem anderen Client Secret erzeugt
- Erzeugen Sie das Refresh-Token mit Ihren aktuellen Zugangsdaten neu
Gmail: “invalid_grant”
Dieser Fehler bedeutet:
- Das Refresh-Token ist abgelaufen (7 Tage im Modus Testing)
- Der Nutzer hat sein Google-Passwort geändert
- Das Token wurde widerrufen, oder die Grenze von 50 Tokens wurde überschritten
Lösung: Erzeugen Sie ein neues Refresh-Token nach den Schritten 5 und 6.
Testen
Klicken Sie oben im Integrationsformular auf Test-E-Mail senden oder auf der Karte auf Test senden, um Ihre Konfiguration zu prüfen.
