Push Notifications

caution

If your instance is hosted in the SimpleOne cloud, when requesting update to versions 1.34.0 and higher, you may specify in the Description field of the update request an email address to be used by the browser delivery service (Chrome/Firefox/Safari) to send messages in case of incorrect use of Web Push notifications (notification limits exceeded, spam complaints and other) in accordance with RFC 8292.

If no email address is specified in the update request, a dedicated vendor's email address is used for these notifications.

SimpleOne supports sending push notifications to the users' browsers. This functionality is implemented by system logic with the use of SimplePushNotification class methods. Some default parameters can be configured using system properties.

This article describes the tables used in the system to implement this functionality.

Push Notification table

---

The Push Notification (sys_push_notification) table stores push notifications created by the system logic using the SimplePushNotification class methods.

Push Notification form fields

Field	Description
Title	Notification title. Maximum length is 35 characters.
Body	Notification body. Maximum length is 255 characters.
Icon	Absolute URL address to the icon with the http or https scheme. If the value is not set or set incorrectly, the system uses the value of the push_notifications.default_icon_url system property.
URL	Absolute URL address with the http or https scheme used to redirect user after they interact with the notification.
Urgency	Level of urgency of the notification. Possible values: Very Low (very-low) Low (low) Normal (normal) – default value High (high)
Time to live	Notification time to live in seconds. Allowed values: integer numbers from 0 to 2419200. Default value: 86400.
Click to close	Determines the notification behavior after it has been shown. Possible values: true — the notification remains on screen until the user clicks it or closes manually false — the notification is closed automatically after a period of time set by the browser If the value is not set, invalid or the URL field does not contain a valid link, this parameter is not set.

Push Notification Recipient table

Field	Description
Push notification	A reference to a record in the Push Notification (sys_push_notification) table that contains the notification to be delivered to the user specified in the User field.
User	A reference to a record in the User (user) table. The user that will receive the notification specified in the Push notification field.
Delivery state	The current delivery state of the notification. Possible values: Pending (pending) – default value Queued (queued) Delivering (delivering) Delivered (delivered) No subscriptions (no-subscriptions) Failed (failed) Read (read)