--- title: Configuring a Twilio account for PingOne description: Use the information in this section to configure PingOne to use your Twilio account. component: pingone page_id: pingone:settings:p1_configure_twilio_account canonical_url: https://docs.pingidentity.com/pingone/settings/p1_configure_twilio_account.html revdate: November 9, 2023 section_ids: before-you-begin: Before you begin steps: Steps result: Result: --- # Configuring a Twilio account for PingOne Use the information in this section to configure PingOne to use your Twilio account. ## Before you begin Ensure that you have your Twilio account SID and Auth Token. You can copy them as required from the Twilio dashboard. You should also have set up one or more origination phone numbers. ## Steps 1. Go to **Settings > Senders**. 2. Click **+**, enter the following options, and then click **Next**: 1. In the **Sender Type** list, select **SMS/Voice**. 2. In the **Provider Type** list, select **Twilio** 3. In the **Provider Configuration** window, enter the following information to configure your Twilio account to work with PingOne: | | | | - | ------------------------------------------------------------------------------ | | | The Twilio account applies across all PingOne applications of the environment. | * **Provider Name**: Enter a meaningful name for the Twilio account. * **Account SID**: Enter the Twilio account SID. | | | | - | ---------------------------------------------------------------------------- | | | If the **SID** is shorter than 34 characters, an error message is displayed. | * **Auth Token**: Enter the Twilio account's Auth Token. 4. Click **Verify**. This validates the account to PingOne and populates the **Origination Numbers** list from your Twilio account. | | | | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | * If the **Auth Token** is incorrect, an error message is displayed. * If there are no originating phone numbers in the Twilio account, it won't be validated to PingOne. | 5. Click **Verify Account** to validate the account in PingOne and populate the Origination Numbers list from your Twilio account. If the account is successfully verified, the **Twilio Setup - Select Numbers** popup opens, showing all the origination phone numbers available to this Twilio account. | | | | - | ----------------------------------------------------------------------------------------------- | | | If there are no origination numbers in the Twilio account, it will not be validated in PingOne. | 6. In the **Twilio Setup - Select Numbers** message: 1. Select at least one origination number to use. * Select the origination numbers to be used. * Click the **Show only selected**/**Show all** toggle to show only the marked phone numbers and hide the numbers that are not selected, or to show selected and unselected numbers. * Click **Select all** to select and mark all the origination numbers for this Twilio account. * Click **Unselect all** to deselect and unmark all the origination numbers for this Twilio account. | | | | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | * If you intend to use both SMS and voice, all your selected numbers must support both SMS and voice. * Twilio allows the use of sender IDs (in place of telephone numbers) for commercial use or to comply with regulations requiring SMSs to be sent as **transactional** and not **promotional**. * Sender IDs defined in Twilio are not displayed. PingOne uses the actual phone numbers. * Sender IDs are displayed according to the Sender IDs sent in the API requests. | 2. Select **Done** to continue with the configuration, or **Cancel**. ### Result: The **Origination Numbers** table displays. 3. For **Toll-free** and **Short code** numbers, you can configure supported **Countries** for notification recipients: * Click in the **Countries** field. The **Configure countries** popup opens. * Click in the **Select countries** field to display the list of countries. Select a country from the list. | | | | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | * **Toll-free**: You can add multiple countries in the **Select countries** list. If no country is specified, the specified toll-free number can only be used to dispatch notifications to United States recipient numbers. * **Short code**: You can select only one country in the **Select countries** list. If no country is specified, the specified short code can only be used to dispatch notifications to United States recipient numbers. | 7. In **Fallback to Default Account**, you can select **Syniverse** to use as a fallback if Twilio becomes unavailable for reasons explained in the following note. | | | | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | **Under fallback:**If PingOne receives an error during the message dispatch process that the used number is invalid, it retries using the fallback option.- If there was no way of originating the SMS or voice event with the tenant's own account, and you defined a fallback to Syniverse, the event will be originated from the fallback account. - The following errors will cause fallback: * All API errors (but not SMS delivery errors) * No origination number was found on the Twilio account - If a transaction was charged to a specific account, it does not imply that subsequent transactions will be charged to the same account. The account charged for each transaction is determined on an individual basis. Preference is always given to the custom account. | * **Syniverse**: Enter the Syniverse **Access Token** and select at least one **Origination Number**. 1. Copy/paste your Syniverse **Access Token** to the indicated field. | | | | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | The system uses your access token to connect to your Syniverse account.Recommended: In your account in the Syniverse portal, define an application that is dedicated to PingOne traffic. Use this application for analyzing PingOne traffic throughput, and troubleshooting SMS or voice message despatch cases. | 2. Click the **Verify Account** button. That validates the account to PingOne and populates the **Origination Numbers** list from your Syniverse account. | | | | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | * If the **Access Token** is incorrect, an error message is displayed. * If your Syniverse account is not fully configured a yellow exclamation mark appears next to the **Access Token** field. If you click on it, the `Syniverse Not Configured` warning message appears. * If there are no originating phone numbers in the Syniverse account, it will not be validated to PingOne. * To configure your Syniverse account to work with PingOne: 1. Copy the URL from the **Address** field. 2. In your Syniverse account: * In the **Delivery Configuration**, paste the URL that you copied from the PingOne **Address** field. * Create 2 subscriptions: **SCG-Message** and **SCG-Voice-Calls**.See the Syniverse article [How to setup a Webhook for Receiving Messages and Notifications](https://sdcsupport.syniverse.com/hc/en-us/articles/360001528033-How-to-setup-a-Webhook-for-Receiving-Messages-and-Notifications) for more information.These Syniverse configurations are required in order that Ping Identity's dashboards and reports will reflect complete and accurate data. Ping Identity will not be able to troubleshoot SMS or voice events related to Syniverse if these configurations are incomplete. | If the account was successfully verified, the display will change to show a list of originating numbers from Syniverse. 3. Select at least one originating telephone number to use. 8. Click **Save**. 9. To complete the setup process, click **I Agree** on the **Third-party Service Consent** message to confirm your legal consent. | | | | - | --------------------------------------------------------------------- | | | You will be asked for legal consent only when entering a new **SID**. |