E-Mail / SMTP-Einrichtung
FeedbackPulse versendet verschiedene Transaktions-E-Mails. Eine korrekte E-Mail-Konfiguration ist wichtig für:
- Willkommens-E-Mails an neue Mandanten
- Team-Einladungslinks
- E-Mails zum Zurücksetzen des Passworts
- E-Mail-OTP-Verifizierung (für Feedback-Formulare)
- Täglich/wöchentlich Digests
- Geplante Berichte
- Nutzungswarnungen
- Benachrichtigungen bei Planänderungen
Konfigurationsmethoden
Methode 1: Über das Admin-Panel (empfohlen)
- Melden Sie sich als Superadmin an
- Navigieren Sie zu Admin → Einstellungen → E-Mail
- Füllen Sie Ihre SMTP-Daten aus
- Klicken Sie auf Test-E-Mail senden zur Überprüfung
- Speichern
Methode 2: Über die .env-Datei
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="FeedbackPulse"
Anbieterspezifische Einrichtung
Gmail
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_app_password
MAIL_ENCRYPTION=tls
⚠️ Wichtig: Gmail erfordert ein App-Passwort, nicht Ihr reguläres Passwort.
- Navigieren Sie zu Google-Konto-Sicherheit
- Bestätigung in zwei Schritten aktivieren (erforderlich)
- Navigieren Sie zu App-Passwörter → „Mail" auswählen → generieren
- Das generierte 16-stellige Passwort verwenden
🔴 Gmail-Limits: 500 E-Mails/Tag (privat) oder 2.000/Tag (Workspace). Nicht für Produktions-SaaS empfohlen.
Mailgun
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_mailgun_smtp_password
MAIL_ENCRYPTION=tls
- Registrieren Sie sich bei Mailgun
- Domain hinzufügen → DNS-Einträge verifizieren
- Navigieren Sie zu Sending → Domain Settings → SMTP credentials
- SMTP-Passwort kopieren
Amazon SES
MAIL_HOST=email-smtp.us-east-1.amazonaws.com
MAIL_PORT=587
MAIL_USERNAME=your_ses_smtp_username
MAIL_PASSWORD=your_ses_smtp_password
MAIL_ENCRYPTION=tls
- Navigieren Sie zur AWS SES Console
- Ihre Domain verifizieren
- Navigieren Sie zu SMTP Settings → Create SMTP Credentials
- Für Produktion aus dem Sandbox-Modus wechseln
SendGrid
MAIL_HOST=smtp.sendgrid.net
MAIL_PORT=587
MAIL_USERNAME=apikey
MAIL_PASSWORD=your_sendgrid_api_key
MAIL_ENCRYPTION=tls
💡 Hinweis: Der Benutzername ist buchstäblich
apikey(nicht Ihre E-Mail). Das Passwort ist Ihr SendGrid-API-Schlüssel.
Postmark
MAIL_HOST=smtp.postmarkapp.com
MAIL_PORT=587
MAIL_USERNAME=your_postmark_server_api_token
MAIL_PASSWORD=your_postmark_server_api_token
MAIL_ENCRYPTION=tls
ZOHO Mail
MAIL_HOST=smtp.zoho.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_zoho_password
MAIL_ENCRYPTION=tls
Mailtrap (nur zum Testen!)
MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=587
MAIL_USERNAME=your_mailtrap_username
MAIL_PASSWORD=your_mailtrap_password
MAIL_ENCRYPTION=tls
⚠️ Mailtrap ist nur für Entwicklung/Tests. E-Mails werden in Ihrem Mailtrap-Posteingang erfasst und nie an echte Empfänger zugestellt.
E-Mail testen
Über das Admin-Panel
- Navigieren Sie zu Admin → Einstellungen → E-Mail
- Klicken Sie auf Test-E-Mail senden
- Posteingang überprüfen
Über die Befehlszeile
php artisan tinker
Mail::raw('Test email from FeedbackPulse', function ($message) {
$message->to('[email protected]')->subject('SMTP Test');
});
Von FeedbackPulse versendete E-Mails
| Wann | Empfänger | |
|---|---|---|
| Willkommen | Neuer Mandant registriert sich | Mandanten-Admin |
| Team-Einladung | Admin lädt Teammitglied ein | Eingeladene E-Mail |
| Plan geändert | Abonnement ändert sich | Mandanten-Admin |
| Neue Einreichungsbenachrichtigung | Neues Feedback eingegangen | Mandanten-Admin/Staff |
| E-Mail-Digest | Täglich/wöchentlicher Zeitplan | Mandanten-Admin |
| Geplanter Bericht | Täglich/wöchentlich/monatlich | Mandanten-Admin |
| Nutzungswarnung | 90%+ des Plan-Limits | Mandanten-Admin |
| Passwort zurücksetzen | Benutzer fordert Reset an | Anfragender Benutzer |
| E-Mail-Verifizierung | Neue Registrierung | Neuer Benutzer |
| OTP-Code | Feedback-Formular mit OTP | Endbenutzer, der Feedback einreicht |
Fehlerbehebung E-Mail
| Problem | Lösung |
|---|---|
| E-Mails werden nicht gesendet | .env-SMTP-Einstellungen prüfen. MAIL_MAILER=log zum Testen ohne SMTP verwenden. storage/logs/laravel.log überprüfen. |
| E-Mails landen im Spam | SPF-, DKIM- und DMARC-Einträge zur DNS Ihrer Domain hinzufügen. Seriösen SMTP-Anbieter verwenden. |
| „Connection timed out" | Port 587/465 könnte von Ihrem Hosting-Anbieter blockiert sein. Anderen Port oder Anbieter versuchen. |
| Gmail-Fehler „Unsichere Apps" | App-Passwort stattdessen verwenden. Siehe Gmail-Abschnitt oben. |
| E-Mails verzögert | Bei Verwendung von QUEUE_CONNECTION=database sicherstellen, dass der Queue-Worker läuft. |