System Notifications: sending 'pop-up' messages to users of Roam and the Web Application

What are System Notifications?

System notifications are messages, consisting of a header and message body, which are sent to Users. They are visible in the web application, and Roam.

If a user is logged into either a Roam device, or the web application, when the notification is sent, then the notification will "pop-up" (for about 5 seconds in the web application).

Notifications sent to a user while they are not logged in to any device, the system will 'catch up' and display all the notifications which they have missed when they log in next.

Users can open the specific record in Roam or the Web Application when they tap on the Notification.

System Notification Designer

The System Notification Designer is a cut-down version of the Email Designer, and therefore the same principles apply when it comes to adding the content for the Subject and Message fields.

• The main difference is around the To: field:
  • System Messages will be sent to Users of Roam and the web application, and not to an email address.
  • Therefore, as a Designer you can only select one or several relationships to a Person related Component for the To: field.
    Examples are: Assigned To, Responsible Supervisor.
    You cannot select or define fields, or enter hard-coded addresses.
• Due to technical constraints outside our apps, the number of characters in the notification payload needs to be limited (e.g. current maximum payload for notifications in iOS is 2048kb). The limits are as follows:
  
  - Title: max of 255 bytes
  - Message body: max of 1245 bytes