Push notification setup with a custom push application

If you are using your own custom mobile or push application, you must configure your app for use and set up the push contents.

Setting up a push notification infrastructure that uses a custom push app involves a push admin (also called push app developer or mobile app developer) and system administrator. When push admins create a customized push app, they also configure the app, its push message content (payload generators), and optional attributes, such as push action scripts. The admin creates and updates the push notifications for the custom push app. After users install the custom push app and initially log in to their instance from their mobile device, the system automatically creates a device (channel) for the custom app.

Note: These instructions are intended for users who develop their own customized push application. You do not need to configure the ServiceNow mobile application.
Push notification setup tasks for a custom push app

What to do — push admin

Create the PKCS file that contains the certificate for publishing your custom push app
The PKCS (.p12) file contains the iPhone developer certificate and the private key used to sign the certificate. The instance uses the information in the PKCS file to communicate with the APNs. Attach the .p12 file to the X.509 Certificates (sys_certificate) record (System Definition > Certificates) and change the Type to PKCS12 Key Store.
Note: For details on generating the .p12 file with the required certificate and private key, see Configure push notifications and Communicate with APNs using a TLS certificate in Xcode Help for Apple developers.
Configure the custom push application
  1. Create a push application record in the Push Application [sys_push_application] table for the custom push app.

    The instance uses this push application record to identify the device + push application combination necessary to determine a push notification recipient.

  2. Create push message content.

    Create a JSON content payload for different types of push notifications. The content determines how a push notification appears on the push application, and whether the user can send a message in response to the push notification. The push admin can create attribute definitions that specify a default push action script or string, for use in the push message content (next step).

  3. Create an attribute value or action for a push message.

    You can create attribute values that override the default attribute definitions used in the push message content.

  4. (Optional) Create a push action, a server-side script that tells the instance how to handle responses to push notifications.

For an example of a customized push notification, see Push notification example for a custom push app.

What to do — admin

Create the push messages and push notifications
The administrator creates the push messages, sets up push notifications for the custom push app, and if desired, the content.

Next steps

If you are a push admin, begin the configuration process by creating the push application record for your custom push app.

If you are an admin, create the push messages and push notifications for the custom push app.