Email Troubleshooting: Why Is No Email Being Sent?
Published:
Updated:
The diagnostic tools
FMWeb offers three places to get to the bottom of email sending:
- E-Mail-Überwachung (Email Monitoring) (
/applications/protokolle/email-skips) with three tabs:
- Metriken (Metrics) – queue status (Pending / Failed / Sent 24h), success rate, trend
- Zustellstatus (Delivery status) – the last 100 emails with their status (Sent / Pending / Failed), attempts, error code and error text; clicking opens the full email detail view
- Übersprünge (Skips) – why notifications were never generated in the first place (no driver assigned, invalid email, driver block …), summarised by reason
- Protokolle (Logs) (
/applications/protokolle/overview) – the check run of each notification type leaves entries here (type HU / UVV / tyre change / driving licence / leasing, status Successful / Failed / Skipped) - Hintergrundaufgaben → „Logs" (Background Tasks → Logs) tab – technical errors of the Mail Task itself (e.g. „Mail nicht versendet: {Betreff}", i.e. Mail not sent: {subject}, for SMTP problems)
In addition, the Fahrerakte → „E-Mails" (driver record → Emails) tab shows all mails generated for a driver, including a preview of the content.
Checklist: no email arrives
Work through the points from top to bottom:
| # | Check | Where |
|---|---|---|
| 1 | Is the Mail Task active and the SMTP server correct? | Hintergrundaufgaben → E-Mail Task |
| 2 | Is the client included in the Mandanten-Auswahl (client selection) of the Mail Task? Without selection, mails stay „Pending" forever. | Hintergrundaufgaben → E-Mail Task |
| 3 | Is „Infomails sollen versendet werden?" (Send info mails?) enabled? | E-Mail Einstellungen → Allgemein |
| 4 | Is today actually the configured send weekday? Notifications are only generated once a week. | E-Mail Einstellungen → Allgemein |
| 5 | Is the notification type enabled and a template assigned? | E-Mail Einstellungen → respective tab |
| 6 | Does the recipient driver have a valid email address, no Fahrersperre (driver block), no Selbstfahrer (self-driver) flag, no „Keine E-Mail" (No email)? | Fahrerakte / Monitoring → Übersprünge |
| 7 | Is the repeat protection taking effect? Reminders sent recently are not generated again. | Monitoring → Übersprünge |
| 8 | Is the mail set to „Fehlgeschlagen" (Failed)? Then check the error code/error text (usually SMTP: authentication, port, SSL). | Monitoring → Zustellstatus |
Meaning of the statuses
| Status | Meaning |
|---|---|
| Ausstehend (Pending) | In the queue, waiting for the next run of the Mail Task |
| Gesendet (Sent) | Successfully handed over to the SMTP server |
| Fehlgeschlagen (Failed) | Sending failed – error text in the detail view; after resolving the cause, contact support if needed to re-queue the mails |
Important for test/development environments
In development/test environments, real SMTP sending is disabled for security reasons – there, mails are only marked as „Gesendet" (Sent) without contacting the mail server.
Related articles
AH
