ServiceNow Mobile App Push Notifications

Overview

This discussion applies to the ServiceNow native mobile apps for iOS and Android. For information on integrating notifications with a custom mobile application, please see Setup Push Notifications for a Custom Push App.

Push notification payloads sent from an instance to the ServiceNow mobile apps support the following attributes:

• Message: The message text to display in the notification alert.
• Notification category: An optional category used to determine which predefined actions (buttons) should be displayed and whether the mobile app should be opened in response to an action.
• Scripts: The script to run when a specific button is tapped. Scripts are stored in the sys_push_notif_act_script table.
• Record: An optional record to open in response to the notification.
• Web Path: An optional web path or URL to open in response to the notification. This takes precedence over the record attribute.

Supported Categories

A notification category is used to determine which predefined actions (buttons) should be displayed and whether the mobile app should be opened in response to an action.

Note: Custom button titles are not supported by the ServiceNow mobile apps. A notification category is the only way to specify predefined button titles. Notification categories are not stored on the instance and can not be modified.

The ServiceNow mobile apps support the following categories:

Category Identifier	Button 1 Title	Button 1 Identifier	Button 1 Mode	Button 2 Title	Button 2 Identifier	Button 2 Mode
approve_reject_foreground	Approve	approve_foreground	foreground	Reject	reject_foreground	foreground
approve_reject_background	Approve	approve_background	background	Reject	reject_background	background
yes_no_foreground	Yes	yes_foreground	foreground	No	no_foreground	foreground
yes_no_background	Yes	yes_background	background	No	no_background	background
accept_decline_foreground	Accept	accept_foreground	foreground	Decline	decline_foreground	foreground
accept_decline_background	Accept	accept_background	background	Decline	decline_background	background

Generating Payloads

Push Notification Message Content records are stored in the sys_push_notif_msg_content table. These records are used to generate push notification payloads. Below are example scripts that demonstrate how to generate payloads with different behavior and buttons.

Record Payload

This payload will open the app to the current record when the notification is opened. The notification will not have any buttons.

(function buildJSON(/*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) {

    var json = {};

    json = {
        "aps" : {
            "sound" : "default"
        },
        "record" : {
            "table" : current.getTableName(),
            "sys_id" : current.sys_id
        }
    };

    return json;

})(current, message, attributes);

Web Path Payload

This payload will open the app to a custom web path or URL when the notification is opened. The notification will not have any buttons.

(function buildJSON(/*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) {

    var json = {};

    json = {
        "aps" : {
            "sound" : "default"
        },
        "web_path" : "$vtb.do"
    };

    return json;

})(current, message, attributes);

Approve / Reject Foreground Payload

This payload will open the app to the current record when the notification is opened or a button is tapped. The notification will have "Approve" and "Reject" buttons that will trigger a script in the foreground and cause the app to open.

(function buildJSON(/*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) {

    var json = {};

    json = {
        "aps" : {
            "sound" : "default",
            "category" : "approve_reject_foreground"
        },
        "record" : {
            "table" : current.getTableName(),
            "sys_id" : current.sys_id
        },
        "scripts" : {"approve_foreground" : "333ecc6253020200601fa3fc9ec58727",
                     "reject_foreground" : "632ecc6253020200601fa3fc9ec58708" }
    };

    return json;

})(current, message, attributes);

Yes / No Background Payload

This payload will open the app to the current record when the notification is opened, but not when a button is tapped. The notification will have "Yes" and "No" buttons that will trigger a script in the background without opening the app.

(function buildJSON(/*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) {

    var json = {};

    json = {
        "aps" : {
            "sound" : "default",
            "category" : "yes_no_background"
        },
        "record" : {
            "table" : current.getTableName(),
            "sys_id" : current.sys_id
        },
        "scripts" : {"yes_background" : "333ecc6253020200601fa3fc9ec58727",
                     "no_background" : "632ecc6253020200601fa3fc9ec58708" }
    };

    return json;

})(current, message, attributes);