Set country code overrides

You can set country-specific overrides for the HTTP xMatters SMS protocol provider's source address: if a country override exists that matches the country specified for a user's text phone device details, the protocol provider will use the source address overrides.

You can also use the country code overrides to specify a different request body or name/value parameters. If a country code override has no defined body or parameters on the Country Override Details page, then requests using that country code will use the body or parameters defined on the protocol provider. If a country code override includes a defined body or parameters, requests using that country code will use ONLY the configuration defined on the override page and none of the protocol provider's body or parameters.

You cannot change the request type on the protocol provider if you have already defined country code overrides. Ensure that you have completed and saved your protocol provider configuration before creating overrides.

For example, assume that you have a protocol provider set with two default parameters, ParamA and ParamB, A US country override is configured with no defined parameters, and a Canada country override is configured with one parameter, ParamC.

  • When sending a message to the US, the provider will use ParamA and ParamB.
  • When sending a message to Canada, the provider will use only ParamC.
  1. On the HTTP xMatters SMS Protocol Provider page, under the Country-specific Overrides heading, click Add New.
    1. xMatters displays the Country Override Details page:

Country code overrides page for HTTP xMatters SMS protocol provider

  1. Specify the following information in the fields provided:
    1. Country: Select the country for which you want to specify the override.
    2. Short Code Compliance: Select an option to specify when xMatters should send a notification explaining terms of service to each SMS Device. (For more information about the options, see the description for the Short Code Compliance setting on the protocol provider page.)
    3. Source TON: Specify the type of number (TON) for the source address to be used during the server session.
    4. From: Type the phone number to use as the caller ID that identifies the source of outgoing messages. Must be a valid outgoing caller ID for your account.
    5. Reply To: Specify a separate address to which recipients should send their responses. If you use this feature, the response portion of the SMS message includes "Send reply to <address>." Note that this does not override or affect the original source of the message; it provides a visual reminder to the recipient that they should respond to a different address.
    6. Encoding Type: Select an encoding type to use for this country.
  2. In the Request Type section, specify the request body or any name/value pairs you want to use when this override is active.
    1. Note that if a different request body or any name/value pair is specified, then the protocol provider will use the override settings instead of the request body or parameters defined on the protocol provider.
  3. Click Save to create the override and return to the protocol provider page.

This feature requires that you have configured simple SMS replies, as described in Configure simple SMS replies.