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
-
Go to Settings > Sender.
-
Select SMS/Voice.
The default Ping Server appears, until a Custom Server or Custom Provider is configured for the environment.
-
Select Custom Provider.
Selecting Ping Identity or Custom Server deletes any existing custom provider configuration, if one exists.
-
Provider Name: Enter a meaningful name for your Telesign provider account.
-
Authorization: select Basic and then enter
-
User Name: Enter the username for your Telesign provider account.
-
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.
-
-
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.
-
-
SMS:
To use Telesign to send SMS messages, configure this section.
-
Type: Select the POST operation to issue SMS notification requests to the associated vendor URL endpoint.
-
URL: Enter the following URL
https://rest-api.telesign.com/v1/messaging
-
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.
-
Headers: The Telesign header for the SMS notification requests is added by default.
-
Plus sign: Select Enabled to enable the standard number format for the sender and recipient numbers, including a leading plus sign.
-
-
Voice:
To use Telesign to send voice messages, configure this section.
-
Type: Select the POST operation to issue voice notification requests to the associated vendor URL endpoint.
-
URL: Enter the following URL
https://rest-api.telesign.com/v1/voice
-
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.
-
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>",
-
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\"/>"
-
Headers: The Telesign header for the SMS notification requests is added by default.
-
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.
-
-
Click Save.
-
Check your configuration:
-
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.
-
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.
-