Page created: 20 Jan 2023
|
Page updated: 20 Jan 2023
| 4 min read
PingOne Cloud Platform PingOne Product Administration User task Configuration IDaaS Deployment Method Product documentation Content Type Administrator Audience Developer
Add Telesign as your organization's provider account in place of the Ping service.
- Go to Experiences > Sender.
-
Select SMS/Voice.
The default Ping Server appears, until a Custom Server or Custom Provider is configured for the environment.
-
Select Custom Provider.
Warning: 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.Note: 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} 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. - 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} 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. -
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.
Note: 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.