Skip to main content
Run Ringg agents on your own Exotel account and ExoPhones, one of the bring-your-own-telephony options. Exotel routes calls to Ringg through Voicebot applets you create in its App Bazaar, one per direction:
  • Outbound: a Ringg Outbound applet. Its app ID goes into the Exotel account form in Ringg.
  • Inbound: a Ringg Inbound applet. Every inbound ExoPhone must be attached to it in Exotel.

​
Before you start

An Exotel account

With API access, credit for calls, if your account requires it, and at least one ExoPhone.

Your Exotel API credentials

Account SID, API key, API token and subdomain, from Settings → API Settings.

An inbound agent

Only for inbound: the agent that answers calls on your ExoPhone.

​
Outbound setup

​
Create the Ringg Outbound applet

1

Create a custom app

In the Exotel console, open App Bazaar and create a custom app named Ringg Outbound.
2

Add a Voicebot applet

Drag the Voicebot applet into the flow and set its URL to:
3

Save and copy the app ID

Save the app and copy its app ID. It is not the same as your API key or token.

​
Connect the account in Ringg

1

Open the Exotel account form

Go to Numbers → Add number, select Exotel, and open Configure provider (the gear). Select Add; with no Exotel account yet, the form opens on its own.
2

Fill in the fields and save

”BYOT added successfully.” appears and the account is listed under Configure Exotel Accounts.
Then import your ExoPhones and use them as caller ID: steps 3 and 4 of How BYOT works.

​
Inbound setup

Do these in order for every ExoPhone that should reach a Ringg agent:
1

Create the Ringg Inbound applet

In App Bazaar, create a custom app named Ringg Inbound with a Voicebot applet whose URL is:
You need this app once; reuse it for every inbound number.
2

Attach the ExoPhone to the applet

In Exotel, attach the ExoPhone to Ringg Inbound. An ExoPhone attached to an agent in Ringg but not to this applet never reaches Ringg.
3

Import the number in Ringg

Import the ExoPhone from your Exotel account.
4

Attach it to an agent

In the inbound agent’s editor, expand Attach Number and select the number. See Attach a number.
Call the ExoPhone from a phone. The agent answers, and the call appears in Logs.

​
Troubleshooting

  • Check the Ringg Outbound applet is saved with wss://use1-api.ringg.ai/pc/v1/exotel/ws.
  • Check App ID in Ringg is that applet’s ID, and SID, API Key, API Token and Subdomain were copied without extra spaces.
  • Check the Exotel account has API access and credit, and the caller ExoPhone is active.
  • Compare the call in Ringg Logs with Exotel’s call logs.
  • Check the ExoPhone is attached to Ringg Inbound, and that applet uses https://use1-api.ringg.ai/pc/v1/exotel/inbound.
  • Check the number is imported in Ringg and attached to the right agent.
Keep each applet to the Voicebot step only, then follow the general checks; include the Exotel call SID when you contact support.

​
Next steps

Import your ExoPhones

Bring the numbers into Ringg.

Attach a number to an agent

Answer inbound calls on an ExoPhone.

Exotel documentation

Exotel’s API and Voicebot docs.