Skip to main content
Version: 8.3

Desktop notifications in Freedom UI

Level: advanced

Users often miss important events when they work in other apps or browser tabs. Desktop notifications solve this by showing a browser pop-up about new chat messages, reminders, business process tasks, and other events. Creatio lets each user choose which notification types to receive, and developers can add custom notification types that users manage the same way as out-of-the-box types. Desktop notifications are available only in Freedom UI.

Notification types​

Each notification type corresponds to a system setting of the "Boolean" type in the "Notification settings" folder of the System settings section. The folder already contains out-of-the-box notification types, for example, the "Chats browser notifications" and "Reminders browser notifications" system settings. Creatio shows every system setting from this folder on the Notification settings tab of the user profile page and uses the Name property of the system setting as the notification type checkbox. When a user selects or clears the checkbox, Creatio saves the value for the current user only and does not change the value for other users.

Conditions to show a notification​

Creatio shows a notification only if all of the following conditions are met:

  • The system setting exists, the current user can read it, and its value for the current user is "true."
  • The browser allows notifications for the Creatio instance. If the browser permission is not set yet, Creatio asks the user for permission when it shows the first notification.
  • The Creatio instance uses HTTPS. Browsers block notifications on instances that use HTTP.
  • The operating system allows notifications from the browser, and the "Do not disturb" mode is off.
  • The browser window is not active.
  • For a custom notification type, the page that receives the message about the event is open in a browser tab.

If any condition is not met, Creatio skips the notification and does not display an error.

Add a custom notification type​

A custom notification type usually informs a user about a server-side event, for example, when another user creates a request assigned to them.

To add a custom notification type, follow the detailed example: Notify the assignee about a new request.

note

Creatio checks only the value of the system setting, not the folder that contains it. If you do not add a custom system setting to the "Notification settings" folder, users cannot select the checkbox on the profile page. Add only system settings of the "Boolean" type to this folder. System settings of other types break the Notification settings tab.

See also​

Manage the system setting values

Notify the assignee about a new request

"handlers" schema section