Configuring xMatters SMS

The following sections explain how to configure xMatters to send SMS messages via HTTP using the xMatters SMS feature.

Note that the instructions in this section assume that you are using a default installation of xMatters; if you have customized your installation, you may need to adjust the described process accordingly.

Overview

The HTTP protocol allows you to send and receive voice and text notifications and responses via HTTP requests. The xMatters SMS feature uses the HTTP protocol to provide global coverage of SMS and simple SMS replies. The service is available on a subscription basis to xMatters customers; contact your xMatters Sales or Client Assistance representative for more information.

Configuring external access

Note that you can also configure your system to receive inbound SMS responses to your xMatters server without exposing the web user interface to the Internet by reverse proxying a small portion of the xMatters URL space. The required syntax is as follows:

<protocol>://<domain>:<port>/services/xmsms
 

Note that the <protocol> should ideally be "https", and <domain> must be a fully qualified domain name that is resolvable from the Internet. The <port> is required only if it does not match the specified protocol. For example:

https://myserver.xmatters.com:8443/services/xmsms

Getting started

The first step in preparing your deployment for xMatters SMS is to contact the xMatters Client Assistance team and set up your xMatters SMS account. The configuration settings in the xMatters web user interface will require your account information.

Once you have your account information, perform the following steps to configure the xMatters SMS feature on your deployment:

  1. Create an HTTP-Client Device Engine.
  2. Configure the HTTP-XM-SMS Protocol Provider to connect to the xMatters SMS service.
  3. Create a new User Service Provider for xMatters SMS.
  4. Configure SMS validation and simple SMS responses in the Global Configuration settings.
  5. Add a User and a text phone Device.

These steps are explained in detail in the following sections.