ReTell.ai SIP Trunking
ReTell.ai is a Voice AI platform for developers. ReTell lets developers build, test, & deploy voice AI agents in minutes rather than months — solving for the foundational challenges voice AI applications face.
You can SIP trunk ReTell with Cloudonix, enabling inbound and outbound calling to/from your Cloudonix voice applications. In addition, you can integrate ANY VoIP Carrier in the world for usage with ReTell.
ReTell SIP trunking isn't trunking in the SIP popular sense, it is mostly a workflow that enables connecting your voice agents to the world, via Cloudonix, providing a more agile SIP interconnecting framework.
This tutorial demonstrates two ways to connect Cloudonix with ReTell. We recommend using the cx-vcc tool, and not
using the manual API requests, to ensure that your setup is streamlined with Cloudonix and ReTell requirements.
If you hadn't yet installed the cx-vcc tool, please click here
for the CLI tool guide.
Using cx-vcc (recommended)
Configure the ReTell Connector
To configure your connector, you will need your ReTell API key. Create a unique key for your cx-vcc tool, then use
the following commend to configure it:
$ cx-vcc service --provider retell --apikey YOUR_RETELL_API_KEY --name "Cloudonix SIP Trunk" \
--domain example.com
For example:
$ cx-vcc service --provider retell --apikey aeacbbaa-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx \
--name "My SIP Trunk" --domain cxguide.cloudonix.net
✔ RETELL API key configured successfully
API Key: ********************************
API URL: https://api.retellai.com
✔ SIP trunk "My SIP Trunk" created successfully for domain cxguide.cloudonix.net
SIP Trunk Details:
Credential ID: Not required
Name: Cloudonix SIP Trunk
Provider: retell
Gateway IP: dd7a2a82-2457-3578-a63b-bd132950c857.sip.cloudonix.net
Status: active
You may validate your connector configuration using the display command:
$ cx-vcc display
All domain configurations:
Domain: cxguide.cloudonix.net
API Key: ********
Alias: dd7a2a82-2457-3578-a63b-bd132950c857
Auto Alias: dd7a2a82-2457-3578-a63b-bd132950c857
Inbound SIP URI: dd7a2a82-2457-3578-a63b-bd132950c857.sip.cloudonix.net
Tenant: self
Retell Trunk Credential ID: Not required
Retell Configuration:
API Key: ********
API URL: https://api.retellai.com
Phone Numbers: None configured
Attach a phone number to an agent
Use the following command to add a new telephone number to your ReTell account. You will need to manually attach it to your selected agent, using the ReTell dashboard.
$ cx-vcc addnumber --domain example.com --provider retell --number e.164_formatted_number
For example:
$ cx-vcc addnumber --domain cxguide.cloudonix.net --provider retell --number +12127773456
✔ Phone number +12127773456 added successfully to retell
Phone Number Details:
Number: +12127773456
SIP URI: sip:+12127773456@5t4n6j0wnrl.sip.livekit.cloud:5060;transport=tcp
ID: 1744643934559
Use the display command to validate:
$ cx-vcc display
All domain configurations:
Domain: cxguide.cloudonix.net
API Key: ********
Alias: dd7a2a82-2457-3578-a63b-bd132950c857
Auto Alias: dd7a2a82-2457-3578-a63b-bd132950c857
Inbound SIP URI: dd7a2a82-2457-3578-a63b-bd132950c857.sip.cloudonix.net
Tenant: self
Retell Trunk Credential ID: Not required
Phone Numbers:
- Retell
- Number: +12127773457 (sip:+12127773457@5t4n6j0wnrl.sip.livekit.cloud:5060;transport=tcp)
Retell Configuration:
API Key: ********
API URL: https://api.retellai.com
Phone Numbers: None configured
That's it, your ReTell and Cloudonix domain are now connected and ready for work.
Using ReTell Dashboard
This method utilizes the ReTell dashboard and will allow you to setup your Cloudonix connection in ReTell. Logon to your ReTell dashboard, and select the Phone Numbers menu option. Then, create a new phone number, using the below example:
Once selected the following screen will appear:
Enter the phone number to import, using an E.164 format in the field names Phone Number. In the termination URI,
copy your Cloudonix inbound voice trunk SIP alias, eg. dd7a2a82-2457-3578-a63b-bd132950c857.sip.cloudonix.net, as it
appears in your Cloudonix Inbound Trunks section.
Provide a unique nickname for your newly created phone number - and you're set to go.
Using Manual API calls
Cloudonix Setup
There is no special setup to perform on Cloudonix, to facilitate SIP trunking with ReTell. However, you will need to
get your SIP trunk host name for inbound calls domain name. This process appears below:
To get your SIP trunk host name for inbound calls, go to the Inbound Trunks section of your Cloudonix account,
the following will appear:
Your SIP trunk host name for inbound calls domain name will appear at the top most information box.
ReTell.ai Setup
ReTell SIP trunking is based upon the phone number that will be assigned to your voice agent. As such, you are required to import your phone numbers to ReTell.