PingOne

Use Case: Configuring Telesign as a provider with PingOne

About this task

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

Steps

  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.

    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.

      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}

      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}

      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.

      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.