Configuring simple SMS replies

You can configure xMatters to accept simple SMS responses to notifications. These simple replies require Users to enter only a single digit as a response to a notification, rather than entering a phrase that includes the notification key. For example, the response choices for a notification with simple responses enabled might resemble the following:

Network Server 1211 is offline. Reply 1 to Acknowledge, 2 to Ignore, or 3 to Clear.
 

The User responding to this notification could respond with "1", and the event would be marked as acknowledged.

Because SMS is "stateless" and does not contain hidden information that can be used to link related messages together, xMatters uses the phone number of the text phone Device to associate the response with the correct notification.

When simple SMS replies are enabled, xMatters maintains a mapping of SMS Device numbers and response options, retaining the information for 72 hours. Because a Device may receive multiple notifications for different events, the integers used for the response options will change for each notification on a Device based on the number of response choices and the number of active notifications. For example, a User might receive a notification prompting them to respond with 1 to acknowledge, and the next notification, for a separate event, may prompt them to respond with 5 to acknowledge.

Before implementing the simple SMS replies feature, please note the following:

This feature requires the following configuration steps:

  1. Ensure that all User Service Providers for Text Phone Devices do not have a mixture of protocols; any text phone User Service Provider that includes the SMPP protocol must not have any other protocols listed.
  2. Enable response validation and simple responses on the Global Configuration page, and specify the validation pattern and template; for more information about these settings, see Global Configuration, and the following section, Specifying SMS validation patterns and templates.
  3. Edit the Response Message field on the Device Engine to indicate the new response process for Users. The notification message delivered is configured as <message payload> + "Response Message" (which must include the key, %Response Choices%). The recommended value is "Reply %Response Choices%"; for more information, see Device Engines.