Notification History
The results of the email, SMS and WhatsApp messages sent for alarm notifications are listed on the History > Notification History screen. The screen can be opened by users with the Editor or AlarmManagement role and by the SystemAdmin group.
The screen shows the records of the last 30 days; older records are deleted automatically. Recipient details are shown masked.
Filters
| Field | Description |
|---|---|
| Start date | The first day to list. The default and the earliest date you can select is the first day of the retention period (the last 30 days, including today). |
| End date | The last day to list. The latest date you can select is today. |
| Channel | All channels, Email, SMS or WhatsApp. The list is refreshed immediately when you change the channel. |
After changing the dates, press Apply. The refresh button next to it reloads the list with the same filters. The button in the screen header opens the list in full screen.
Columns
| Column | Description |
|---|---|
| Created | The time the send record was created. |
| Channel | Email, SMS or WhatsApp. |
| User | The user the notification was sent to. |
| Masked recipient | The partly hidden email address or phone number. |
| Provider | The provider that sent the message. |
| Status | The last status of the send (see the table below). |
| Segments | How many parts the SMS was split into. Empty for email and WhatsApp records. |
| Attempts | The number of send attempts. |
| Error code | The error code returned for a failed send. |
The list is paged; 20, 50 or 100 records can be shown per page.
Statuses
| Status | Meaning |
|---|---|
| Queued | Waiting to be sent. |
| Processing | Being passed to the provider. |
| Accepted | The provider accepted the request. |
| Sent | Sent. |
| Delivered | A delivery report was received. |
| Failed | The send failed; see the Error code column. |
| Validation failed | Not sent because the recipient details are invalid. |
| Cancelled | The send was cancelled. |
| Delivery unknown | The send was interrupted; it is not known whether it arrived. It is not retried automatically. |
| Suspended by license | Held because the license lost the send right. |
| Unknown | The status could not be read. |
If the provider does not offer delivery reports, an SMS record may stay in the Accepted or Sent status.
WhatsApp records
To see WhatsApp records, select WhatsApp in the Channel list. The Provider column shows MetaCloudApi.
- Accepted is the final status of WhatsApp records and shows that Meta accepted the message. Delivery and read information does not reach SCADA, so WhatsApp records do not move to the Delivered status.
- Recipients without consent are not skipped; they appear as records in the Validation failed status.
- If consent is withdrawn or the phone number changes before the message is sent, the record becomes Cancelled.
- WhatsApp records in the Suspended by license status cannot be requeued; they only remain in the history.
For WhatsApp records, the Error code column shows known codes with their description, for example Recipient has no WhatsApp consent (WhatsAppConsentMissing):
| Error code | Meaning |
|---|---|
Recipient has no WhatsApp consent (WhatsAppConsentMissing) | The user's WhatsApp consent is not recorded or has been withdrawn. |
Phone number changed after consent (WhatsAppConsentPhoneMismatch) | Consent was given for the old number; consent must be obtained again for the new number. |
Daily WhatsApp limit reached (WhatsAppDailyLimitReached) | The daily hard limit in WhatsApp Settings has been reached. |
Invalid phone number (InvalidPhoneNumber) | The user's phone number is not a valid mobile phone number. |
Provider unavailable (ProviderUnavailable) | WhatsApp was turned off or the provider was changed while the message was queued. |
Not allowed by license (RuntimeLicenseDenied) | The license lost the WhatsApp right before the message was sent; the record is in the Suspended by license status. |
Meta:<code> | An error returned by Meta. For their meanings, see WhatsApp Settings – Error codes. |
Reviewing suspended SMS
For users in the SystemAdmin group, the list shows check boxes and the Resume selected SMS and Cancel selected SMS buttons. These buttons are used only for SMS in the Suspended by license status; they do not apply to WhatsApp records:
- Select, one by one, the suspended SMS you want to send or cancel. There is no select all; at most 100 records can be selected.
- Press the relevant button and check the number of selected SMS in the confirmation window.
- If the selection contains a record in another status or a record of a channel other than SMS, the buttons are not enabled.
- Requeuing requires a valid SMS right and is subject to the provider's fees. Cancelling is also possible when the license has expired.
- If you get the Selected SMS records changed. Refresh notification history. message, refresh the list and select again.
For the steps to follow after a license change, see the SMS Settings page.
Troubleshooting
| Message | What to do |
|---|---|
| Notification service is unavailable. (3703) | Contact your system administrator. |
| Notification service database schema is not up to date. (3706) | Contact your system administrator. |
| The decision could not be applied. Check the current license and refresh notification history. | Check that the license includes the SMS right and refresh the list. |