Notifications

1392 views

Description


ServiceNow supports standard Email, SMS and Push notifications. SMS notifications can be sent via either Notify or Email Notification.

Notify is another independent topic as it requires integration with the 3rd-party Twilio software and specific workflows to send out SMS notification.

This article only focuses on how to configure and troubleshoot a SMS Notifications based on standard email configurations in ServiceNow.

Procedure


  1. Create an email notification
    • First of all it is necessary to create a normal email notification on the instance.
    • SMS messages are normally limited to 140 characters so make sure the message length in the email notification is under this limit otherwise it may be truncated.
    • Note: There is a "SMS alternate" field on the [What it will contain] tab in the Advanced view of any email notification.
    • Users can create a brief short message dedicated for SMS when this email notification could be used for multiple purposes, both email and SMS device, at the same time.

  2. Create a SMS service provider
    • Please consult the documentation: Create a service provider (London)
    • All the created notification service provider records are stored in the table cmn_notif_service_provider.list on the instance.
    • Note 2.1: Make sure the Active box is checked for the service provider used to send the SMS notification.

    • Note 2.2: When troubleshooting any SMS notification issue it is necessary to narrow down the scope to check whether the SMS notification or the SMS service provider have any issues. In that case, you can test SMS notification by switching to any OOB service provider.
    • If the email notification can be triggered successfully then the system will always create an SMS notification record in the sys_email table, just like an email record. This will prove email notification has no wrong configuration and the issue is related to the SMS service provider. If not, then it is easy to know something wrong must be in the email notification configuration.
  3. Create and select a SMS device for a specific user
    • When any specific user is chosen to receive the SMS notification then it is necessary to create a SMS device for this user if there is no one on the instance.
    • Steps can be referred from below docs link. Select a service provider (London)
    • Note 3.1: When creating a new SMS device, please make sure you use the following values:
        • Type : SMS
        • User : sys_user record which is being selected as the recipient for the SMS notification
        • Phone number : phone number to receive the SMS notification, SMS will be sent to address with format <phone number>@<SMS Provider Email Suffix>. The latter part after @ is the the email suffix configured on the SMS service provider record in step 2. In below screenshot, the address would be "123-456-7890@tmomail.net".
        • Service provider : service provider record created in step 2
        • Primary email : false (because this device is used for SMS only)
        • Active : true

    • Note 3.2: In ServiceNow all the notification related devices are stored in cmn_notif_device.list table. This includes standard email, SMS and Push notification devices.

    • When troubleshooting SMS notification issue it is necessary to look up customer's SMS notification device record in this table to see if any misconfigurations.

  4. Enable the SMS device and the SMS Notification in User Notification Preference
    • Note 4.1: Make sure the SMS device is enabled in the Notification Preference for the recipient user. In this screenshot, the "Mobile" SMS device is enabled.

    • Note 4.2: Make sure SMS email notification is enabled for this SMS device in user Notification Preference as well.
    • In this screenshot, the email notification "Incident commented_1" is enabled for the "Mobile" SMS device.

Set up an SMS Email Notification Subscription


Sometimes users may only want to subscribe to an SMS email notification without being selected as a recipient in the SMS email notification.

The configuration steps are nearly the same with only two differences.

  1. Create an email notification
    • Same as the previous step 1. The only difference is to make the notification subscribable by checking the [Subscribable] check box on the [Who will receive] tab in the email notification.

  2. See above
  3. See above
  4. See above
  5. Create a Notification Subscription record

    For notification subscription, ServiceNow stores all user subscription records in sys_notif_subscription.list table for all notifications.

    The user needs to create a new one if there is no subscription record in this table. Please make sure these values are used:

    • User : sys_user record which subscribed to the SMS notification
    • Notification : SMS notification name. In below screenshot, notification name is "Incident commented_1"
    • Send to : SMS device name. In below screenshot, SMS device name is "Mobile"
    • Table : Table name on which the SMS notification is created. In below screenshot, table name is "incident"
    • Active : true

Note: When troubleshooting SMS Notification Subscription issues, first check if there is a corresponding SMS subscription record created in the sys_notif_subscription.list table. If any, then continue to check to see if there is any misconfiguration in that SMS subscription record.

After all above steps are completed correctly, trigger the SMS notification. A new sys_email record will be created and sent to the SMS email address.

 

Applicable Versions


The documentation links used in this article are for the London release, which is the latest at the time of writing. However, SMS notification is a core function of the ServiceNow platform available from all the supported versions starting from Geneva.

 

Article Information

Last Updated:2018-11-24 23:51:18
Published:2018-09-19