Use Case: Configuring Burst SMS as a provider with PingOne - PingOne Cloud Platform - PingOne

PingOne Cloud Platform
bundle
pingone
ft:publication_title
PingOne Cloud Platform
Product_Version_ce
PingOne Cloud Platform
PingOne
category
Administratorguide
ContentType
Guide
Product
Productdocumentation
p1
p1cloudplatform
ContentType_ce
Guide
Product documentation
Guide > Administrator Guide

Add Burst SMS as your organization's provider account, to send SMS notification messages in place of the Ping service.

To add Burst SMS as your organization's provider account:

  1. Go to Settings > Sender.
  2. Select SMS/Voice.
    The default Ping Server appears, until a Custom Server or Custom Provider is configured for the environment.
  3. Select Custom Provider.
    Warning:

    Selecting Ping Identity or Custom Server deletes any existing custom provider configuration, if one exists.

  4. Provider Name: Enter a meaningful name for your Burst SMS provider account.
  5. Authorization: Select Basic and then enter
    1. User Name: Enter the username for your Burst SMS provider account.
    2. Password: Enter the password for your Burst SMS provider account.
      Note:

      When editing an existing configuration, you can click Change Account to enter a new password for the custom provider account.

  6. Origination Number: Click + Add Sender Phone Number to configure a sender phone number. A new row is added. Enter the following information:
    1. Sender Phone Number: Enter the phone number that sends the notification. You can leverage shortcodes and toll-free numbers for increased throughput for US numbers.
    2. Phone Number Type: Enter the type of phone number you are using:
      • Standard: The Sender Phone Number must conform to the valid format of a full international phone number.
      • Toll-free: The Sender Phone Number should be a valid toll-free phone number (US only). It is the customer's responsibility to confirm that the number is toll-free.
      • Short code: The Sender Phone Number must conform to the valid format of a short code phone number (US only). It is the customer's responsibility to confirm that the number is a short code.
    3. Select the SMS checkbox to use the number for SMS call.
    Repeat this step to configure additional sender phone numbers.
  7. Optional: Fallback to Ping Twilio account: Configure the fallback setting, to handle notification dispatch if your custom provider service becomes unavailable for any reason: Enter the phone number that sends the notification. You can leverage shortcodes and toll-free numbers for increased throughput for US numbers.
    • By default, the fallback option is set to Disable. No notifications will be sent while your custom provider service is unavailable.
    • Select Enable to use Ping Identity's sender account to fall back to as an alternative and handle notification dispatch, while your Burst SMS account is unavailable.
  8. SMS:

    To use Burst SMS to send SMS messages, configure this section.

    1. Type: Select the GET operation to issue SMS notification requests to the associated vendor URL endpoint.
    2. URL: Enter the following URL: https://api.transmitsms.com/send-sms.json?to=${to}&from={from}&message=${message}
    3. Plus sign: Select Enabled to enable the standard number format for the sender and recipient numbers, including a leading plus sign.
  9. Click Save.
  10. To check SMS configuration, in the SMS area, click Send Test SMS and in the popup window enter a destination phone number to test receiving an SMS notification from Burst SMS, and then click Send. A test SMS notification should be received on the destination phone.