Skip to main content
Matrix42 Self-Service Help Center

Push Notifications

Overview

Push Notifications Center is designed to instantly inform you about important events like news, newly received emails, and other messages you would like to receive not only while actively working with DWP. With Push Notifications, you will know all the latest events within the organization and will get in touch with your day-to-day activities just in one click when the browser window is minimized or even closed.

On this page you may find how to configure, send, receive and manage Push Notifications in DWP.

As of June 2024, GCM legacy APIs will no longer be supported and will be retired. To avoid any disruption in your push notification service, you must update the client app to register under the FCMv1 platform.

Do the following actions:

  • Re-setup Push notification under the Administration Global settings
  • Re-login in Matrix42 application

Prerequisites

Browser Push Notifications are shown if the following prerequisites are met:

  1. Browser Push Notifications feature is available only with DWP subscription
  2. Supported browsers:
    • Chrome
    • Firefox
    • Edge
  3. Configured and enabled push notifications:
    1. Enabled by DWP Administrator;
    2. Enabled in your Profile (Person settings);
    3. Allowed in your browser.

      Browser Push Notifications feature is not supported for Internet Explorer and Safari browsers.

  4. Access to Administration application for push notifications configuration.

  5. Access to Matrix42 Push Service

  6. Matrix42 Account in role "Push Notification Administrators"
    To check and manage access to the Push Service you need a valid Company administrative account: open Matrix42 Accounts page → My Company → Groups → Push Notification Administrators System Group → click Edit:

    CompanyProfile_Groups.png
    Here you can find a list of current Push Notification Administrators or revoke access by removing the selected for the user checkbox:
    push_notifications_admin_group.png

Notifications Center and Notifications Monitor

Notifications Center is a new and stand-alone area of the application that can be accessed via the Screen Shot 2021-03-02 at 3.46.17 PM.png bell icon and requires Push Notifications license:

notification_center.png

Notifications Monitor is managed separately and is available in the application under the Screen Shot 2021-03-02 at 3.13.57 PM.png monitor icon:

Notifictions_monitor.png

Notifications Monitor is not related to the Notifications Center with push notifications. It doesn't require an additional license and is available in the default version of the DWP.

Notifications Monitor is available only in those applications that have Show Notification Monitor checkbox enabled in the Application settings.

Push Notifications Configuration

You will receive the Push Notifications after the following configuration steps:

  1. The Administrator has enabled and configured Push Notifications in the Global System Settings;
  2. The employee has enabled Push Notifications in personal Profile;
  3. The employee has enabled push notifications via Notifications Center and has agreed to allow push notifications in the browser.

Administration

The Administrator can enable and configure Push Notifications both for mobile devices and browser as follows:

  1. Open Administration application → Settings → Edit → Push Notifications;
  2. Select the Push Notifications Enabled checkbox;
  3. Click on the Setup Push Notification to configure Matrix42 push server and generate the token. Proceed according to the instructions suggested on the push server.

PN_administration_settings2.png

Push Notifications configuration example in the Global System Settings of the Administration application

Push Notifications settings in the Administration application enable push notifications both for the browser and mobile devices.

The registered token will be displayed as follows:

PN_settings_token.png

Later on, you can unbind the registered for the Push Notifications Services environment on the Matrix42 Mobile Portal:

PN_mobile-portal.png

Person profile

Push Notification Settings are applied for mobile and browser notifications. Employees define which push notifications they would like to receive in their personal Profile settings:


PN_person_profile_2.png
Person Profile: Push Notifications Settings example

Push Notification Settings are available if the Administrator has enabled Push Notifications in Administration application.

Push Notification Settings options:

  • Show all notifications (including emails): default option. This option also enables Notification Center in the browser application;
  • Selected notification types: choose from the list of available options which types of messages you would like to receive. This option also enables Notification Center in the browser application;
  • Don't show notifications: the person will not receive any push notifications. Notification Center in the browser application is not available;

Selected notification types option allows you to see the list of all notification types and choose which of them you would like to receive:

PN_Profile_selected_notification_types.png

Selected notification types option example

Browser Settings

The last step to enable push notifications is to allow them in the browser you use:

PN_disabled_allow_in_browser2.png

 

To disable Push Notifications change your profile settings.

Push notifications are supported in the following browsers (including links for manual browser push notification settings):

Notification Center 

The Notification Center has 2 modes:

  • clipboard_e5d7abe1416bd460fd6b90f9a817b0f49.png - push notifications are disabled. Click on the icon, enable push notifications, and allow your browser to send notifications. If the "Show notifications" message is not shown, check the browser push notification settings and adjust them accordingly. The system also
    • Highlights your current browser
    • Informs you about the supported browser
    • Suggests links for manual adjustments for the push notifications for supported browsers.
  • Screen Shot 2021-03-02 at 3.46.17 PM.png - push notifications are enabled. You will receive notifications according to your profile settings. Additionally, the badge on the icon shows how many new messages you have.

PN_notification_badge2.png

Notification Center with 2 new messages received

 

Click on the Notification Center icon to see the messages:

PN_Notification_Center overview.png

All messages are ordered by time, starting from the most recent. Other messages are grouped and labeled as 1 hour ago, 2 hours ago, etc.

Other options of the Notifications Center:

  • Screen Shot 2021-03-11 at 1.39.22 PM.png icon pins the Notifications Center as a sidebar of the application so that it is always open;
  • Screen Shot 2021-03-11 at 1.39.38 PM.png closes the Notifications Center sidebar

Push notification structure

Each push notification message has a standard structure and consists of the following elements:

  1. Colored icon
  2. Title
  3. Date and time
  4. Body of the message
  5. Link

notification_structure.png

The look&feel of some elements can be adjusted as described in this chapter, but the structure is the same for all types of messages.

Managing push notifications

Notifications Center allows you to view the messages and manage them as follows:

  • Screen Shot 2021-03-11 at 1.39.38 PM.pngicon on the notification closes the message. Once closed, the message is no longer available, as the notifications are not stored in the application database.
  • Screen Shot 2021-03-11 at 1.39.49 PM.png Delete all action clears all messages from the Notifications Center. The notifications will no longer be available and cannot be restored after you run this action.

Push notifications storage

Browser push notifications are not stored in the application database and when they are closed or deleted from the Notifications Center they are no longer available, cannot be restored, or resend.

All notifications are received in real-time when the user is logged in to the DWP application. The browser tab with the active application can be opened, closed, or even the browser can be closed and the user will still receive the notifications. Notifications can be received until the user session expires. Once logged in, the notifications are sent again according to the current browser and user profile settings.

Notifications are stored in the IndexedDB of your browser.

Notification types

Default types

By default, the system has 4 types of notifications, each marked with a specific icon, color, and template for the title and body of the message:

  1. Escalation
  2. Approval
  3. Email
  4. News

PN_notif_types_ui copy.png

Default push notification types examples starting from the top: Escalation, Approval, Email, News

 

How to create a new notification type 

All push notification types are stored in SPSPushNotificationEventPickupType. This pickup defines the content of the push notification. 

PN_type_ SPSPushNotificationEventPickupType.png

SPSPushNotificationEventPickupType with default types of the push notifications

To create a new custom notification type click Add and fill out the following fields:

  • Icon: an icon that will be shown for this type of messages in the Notification Center;
  • Value: set the value in the 20000-49999 range for the new record;
  • Display String: the name of the notification type;
  • Color: the color of the selected icon;
  • Internal Name: a technical name that can be used in the custom implementation for this notification type, for instance, in the Send Push Notification Workflow activity.
  • Title: this text is shown in the push notification message title and is visible for the end-users in the Notification Center;
  • Body: this text is shown in the push notification message body and is visible for the end-users in the Notification Center;

Internal name supports only Latin letters, numbers and characters dot(.), minus(-), underscore(_) and at sign(@)

Beware that using other characters might break the push notifications flow.

Notification Source

By default, there are several sources of Push Notifications.

Notifications for New Email received

Push Notification is sent when the new email for the user was created and saved to the database. This notification can be received if the user has subscribed to this notification type in the user Profile settings.

The notification body contains the subject of the e-mail. Click on the link to instantly view the e-mail details:

PN_notic_center_push_email_view_details.png

Push notifications about the new emails are sent only when the email is saved to the database. Nevertheless, when the user subscribes to receive the email notifications no extra email settings are required.

Adjustments of the e-mails mode in the Global System Settings of the Administration application are not required or related to the push notifications, but the sending of the e-mails must be enabled and configured. 

Notifications from workflow

Notifications are sent when the Order Approval related workflow activities are adjusted accordingly, for instance, Send Push Notification property in the standard 1 Step Approval workflow:

wf_push_notifications_approval.png

Additionally, push notifications can be configured for the news or other event types in the standard Send Push Notification workflow activity.

Fill out mandatory fields:

  • Alert Body: the body of the push notification message;
  • Alert Title: the title of the message;
  • Event name: choose from the suggested options. The list of options stores all available notification types and is taken from the SPSPushNotificationEventPickupType pickup, see Internal Name field.
  • Users: set users or user role.

wf_send_push_notification.png

Custom Notifications

To create a custom push notification:

  1. Create a new push notification type;
  2. Configure a Send Push Notification workflow activity in your workflow.

Troubleshooting

Ensure that the endpoints, described in the next articles are not blocked by any software/hardware:

https://support.apple.com/en-us/102266

https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall

  • Was this article helpful?