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

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

Add Telesign as your organization's provider account in place of the Ping service.

  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 Telesign provider account.
  5. Authorization: select Basic and then enter
    1. User Name: Enter the username for your Telesign provider account.
    2. Password: Enter the password for your Telesign provider account.
      Note: When editing an existing configuration, you can click Change Account to enter a new password for the custom provider account.
  6. 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 Telesign account is unavailable.
  7. SMS:
    To use Telesign to send SMS messages, configure this section.
    1. Type: Select the POST operation to issue SMS notification requests to the associated vendor URL endpoint.
    2. URL: Enter the following URL https://rest-api.telesign.com/v1/messaging
    3. Body:The request body format style for configuration maintenance. In the list select Form and then add the following key and value pairs: Click + Add Key, Value for each additional entry.
      Key Value
      message_type ARN
      message ${message}
      phone_number ${to}
      CAUTION: Changing the the request body's format style from Form deletes the request body's key and value pairs, and changing the format style from Raw deletes the request body's free-form JSON text.
    4. Headers: The Telesign header for the SMS notification requests is added by default.
    5. Plus sign: Select Enabled to enable the standard number format for the sender and recipient numbers, including a leading plus sign.
  8. Voice:
    To use Telesign to send voice messages, configure this section.
    1. Type: Select the POST operation to issue voice notification requests to the associated vendor URL endpoint.
    2. URL: Enter the following URL https://rest-api.telesign.com/v1/voice
    3. Body: The request body format style for configuration maintenance. In the list select Form and then add the following key and value pairs: Click + Add Key, Value for each additional entry.
      Key Value
      message_type ARN
      message ${message}
      phone_number ${to}
      CAUTION: Changing the the request body's format style from Form deletes the request body's key and value pairs, and changing the format style from Raw deletes the request body's free-form JSON text.
    4. Preceding padding: Set a custom pause or padding before an OTP character, to leverage Telesign vendor capabilities when sending voice notifications. For example: 
      "beforeTag":"<Say>",
    5. Succeeding padding: Set a custom pause or padding after an OTP character, to Telesign vendor capabilities when sending voice notifications. For example: 
      "afterTag":"</Say> <Pause length=\"1\"/>"
    6. Headers: The Telesign header for the SMS notification requests is added by default.
    7. Plus sign: Select Disabled to ensure a leading plus sign is not added to the sender and recipient numbers.
      Note: Telesign does not support the use of a leading "+" in phone numbers for voice notifications.
  9. Click Save.
  10. Check your configuration:
    1. 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 Telesign, and then click Send. A test SMS notification should be received on the destination phone.
    2. To check Voice configuration, in the Voice area, click Send Test Voice and in the popup window enter a destination phone number to send a Voice notification from Telesign, and then click Send. A test voice notification should be received on the destination phone.