Notifications log & outbox: how it works
The notifications log is the outbox of the system. It lists every email, WhatsApp message and in-app notice that was queued, sent, failed or canceled, so you can check whether a customer really got a message, read exactly what was sent and send a failed one again.
Lesson 6 of 13 · How it works
How it works
«System → Maintenance → Notifications log A list of every email, WhatsApp message, SMS and push that the system sent, tried to send or canceled. More words in the glossary» shows the cards «Queued», «Sent (24h)» and «Failed» and a «Delivery channels» card that says whether email and WhatsApp are set up or only simulated.
The table lists each message with its subject, event and recipient, the linked customer, the status, the attempts and the time. Filter by «Status» and «Channel», pick a date range or search for a recipient, subject or event.
The statuses are QUEUED (waiting), SENDING, SENT, FAILED (every attempt used up) and CANCELLED (for example because the address is on the suppression list).
Click a row or «Preview» to see the message exactly as it was sent, with its attachments. If something went wrong, «Last error» shows the reason given by the mail server or by WhatsApp.
The system empties the outbox by itself every 20 seconds, and also right after the action that created a message. A failed attempt is repeated later with a longer wait each time, up to 5 attempts.
«Retry» on a queued or failed row, or «Retry now» in the preview, sends that message again at once and starts its attempts from zero. «Run queue now» sends everything that is due.
At the top of the page you can switch Push notifications A short message that pops up on your phone or computer, even when the admin is closed. For example a new order or a payment. More words in the glossary on for this device, so alerts reach you like on a mobile app even when the admin is closed.
Where to find it
- System → Maintenance → Notifications log
/admin/notifications - Notification preferences
/admin/notifications/preferences - System → Automations
/admin/automations
Settings that change it
- Settings → Notifications
/admin/settings/notifications - Settings → Privacy & retention (how long the log is kept)
/admin/settings/privacy - Setup wizard (email and WhatsApp)
/admin/setup
Checklist
Before you move on, check that you can:
- Open System → Maintenance → Notifications log
- System → Maintenance → Notifications log shows the cards Queued, Sent (24h) and Failed and a Delivery…
- The table lists each message with its subject, event and recipient, the linked customer, the status, the…
- The statuses are QUEUED (waiting), SENDING, SENT, FAILED (every attempt used up) and CANCELLED (for example…
- Click a row or Preview to see the message exactly as it was sent, with its attachments.
Tips and common mistakes
- A message shows SENT but the customer has nothing? If the channel card says simulated, nothing left the server. Otherwise ask them to check the spam folder and check the address on their record.
- Many FAILED rows with the same error point to the sending setup, not to the customers. Fix SMTP or WhatsApp in the setup wizard, then retry the rows.
- No row at all for an event means the message was never created. Check the event's switch in «Settings → Notifications» and whether the customer has an email address or phone number.
- Old log entries are deleted after the number of months set in «Settings → Privacy & retention». Queued messages are never deleted.