Twilio Elastic SIP Trunking
- Alex | Ringotel Team
1. Create a Ringotel organization
In your Ringotel portal, click + Add Organization button to create a new organization.
In the new organization settings, you need to provide the following information:
Organization name: This is the name of your organization.
Domain: This should be a unique domain within the Ringotel system.
Region: Choose a region that is closest to your users' location.
Once you have entered all the required details, click on the Next button to proceed.
2. Create Twilio Elastic SIP Trunk
Next, let's specify the connection settings for your Twilio SIP Trunk. In order to do this, you will need to copy a Termination URI and your Twilio phone number from your Twilio account.
Termination settings
To obtain your Twilio Termination URI, please follow these steps:
Log in to your Twilio account
Go to Elastic SIP Trunking
Click on Manage → Trunks
Click on the Create New SIP Trunk button
If you do not have an Elastic SIP Trunking section pinned in your Twilio account, follow these steps:
Navigate to Explore products → Super Network → Elastic SIP Trunking section.
Click on the pin button to pin the section.
This will ensure that the Elastic SIP Trunking section is easily accessible in your Twilio account.
In the General settings, specify Friendly name, then navigate to Termination settings and specify Termination SIP URI:
In the Show Localized URIs section copy the closes Edge location to the region where you created a Ringotel organization. You will then need to enter it into the Domain and IP address field of a new Ringotel connection settings.
Specifying localised Termination URI is recommended to ensure that both outgoing and incoming calls working properly. Failure to do so may result in rejection of incoming calls if they originate from a different Twilio region.
Next, enable Authentication with Credentials List for this SIP Trunk.
Creating connections without proxy username/password authentication is highly not recommended as it may be a major security issue. This is because Ringotel sends calls from shared IPs.
If no Credentials Lists are created, click the "+" button and specify a Friendly name, Username, and Password for the new Credentials List. You will need to specify these credentials in the new Ringotel connection → Outbound Proxy settings.
Add numbers
Next, add your trunking-enabled Twilio number(s) to this SIP Trunk. For this, in your Twilio SIP Trunk settings,
Navigate to Number
Click Add number
Select Add an existing number (or Buy a number).
Origination settings
Lastly, to enable inbound calls, you need to configure the Origination settings. To do this, navigate to the SIP Trunk Origination settings and add an Origination SIP URI. The Origination SIP URI should be in the following format:
sip:<ringotel-domain>.ringotel.co;edge=<twilio-edge-location>
For example: sip:acmeltd.ringotel.co;edge=dublin
3. Creating a Ringotel connection
Navigate back to your Ringotel portal to complete the configuration of the connection settings.
In the connection settings switch type to “Connect to VoIP Provider”
In the Domain or IP address field, enter your Twilio Termination URI.
In the Number field, enter a phone number associated with the Twilio SIP Trunk.
Disable the Registration option.
In the Outbound Proxy section, enter Twilio Termination URI as the Proxy address and specify SIP port (5060 UDP/TCP, 5061 TLS/SRTP) after a colon, e.g. ringotel.pstn.dublin.twilio.com:5060. Then, provide “Auth. username” and “Password” from the Twilio Credentials List associated with this SIP Trunk.
Click Next to continue.
4. Create Ringotel users
On the last step, create Ringotel users who will be able to make and receive calls via this connection. To do this, provide the user's Display name, Username (which can be any string or extension number), and select the Add to call distribution button.
Once created, use the generated credentials to log in to your Ringotel app.