Skip to main content
A Ringg-provided number is the quickest start; connect your own provider account when you already have numbers or a carrier contract (compare the two). In the dashboard: Sidebar → Inventory → Numbers → All Numbers → Add number.

​
Before you start

Edit access to Numbers

Your workspace role needs the Numbers permission.

A provider account

Optional: only to import or buy on your own telephony.

​
How the Add number dialog works

The dialog, titled Add Numbers, has three parts:
  1. Provider list (left): the supported providers, with Plivo selected when the dialog opens.
  2. Selectors (top): the telephony account, then country and region (region starts at All). The gear, Configure provider, opens the provider’s account settings.
  3. Tabs, which depend on the account you pick:

​
Connect a provider account first

Skip this if you buy a Ringg-provided number from Plivo or Vobiz. For anything else, Ringg needs your provider credentials. If the provider has no account yet, the form opens as soon as you select the provider.

Connecting a second Exotel account, then importing a number from it

1

Open the provider settings

In Add Numbers, select the provider on the left, then click the gear (Configure provider). The panel lists the accounts you already connected for that provider.
2

Add the account

Click Add. Enter a Name (for example Exotel Pune) and the provider’s fields from the table below. Secret fields have a show/hide toggle.
Configure Exotel Accounts form in the Add Numbers dialog with Name, SID, API Key, API Token, App ID and Subdomain filled in

The Exotel account form

3

Save

You see “BYOT added successfully.” and the account appears in the telephony account selector.
For Plivo, Twilio, Exotel, Vobiz, Tata Tele, Maqsam and VoiceLink, Ringg tests the credentials with the provider before saving. Wrong ones show “Invalid credentials for provider” and nothing is saved.
Every field is required unless marked optional. Provider-side setup is in each provider’s guide under Bring your own telephony. To delete a provider account, open Configure provider and use Delete Account on its row.

​
Buy a new number

Buying a Ringg-provided Plivo number in Karnataka

1

Pick the provider and account

Select the provider. In the telephony account selector, choose Ringg for a Ringg-provided number (Plivo and Vobiz only), or one of your connected accounts.
2

Pick the country and region

Choose the country, then a region or All. Each provider sells in fixed countries (provider table).
3

Buy

On the Buy new tab, pick a number from the list (20 per page). With the Ringg account, each row also shows its Rental Rate per billing period, for example ₹499 / 1 Month (the Number rental rate on Billing). Click Buy Number and confirm with Buy Number.
Add Numbers dialog with Plivo selected, telephony account Ringg, country India, region Karnataka, and two numbers listed at ₹499 / 1 Month with Buy Number buttons

Buy new with the Ringg account

You see “Purchase has been completed successfully.” and the number appears in All Numbers.
A new number joins no number pool; add it to one yourself. The same goes for imported and hand-added numbers.

​
Import a number you already own

1

Select your account

Select the provider and your connected account in the telephony account selector. The Import your own tab appears.
2

Import

Open Import your own. It lists the numbers on your provider account; those already in Ringg show Already Imported. Click Import on a row and confirm with Import.
Import your own tab for the Exotel Mumbai account: two numbers marked Already Imported and three numbers with Import buttons

Import your own for an Exotel account

You import one number at a time. For an Exotel number that will take inbound calls, attach it to the Ringg Inbound applet in Exotel first (Exotel).

​
Add a number by hand

  1. Type a number with its country (for example +91 98765 43210) and click Add. Repeat for more numbers; each appears as a chip under Numbers:. For Maqsam, the field accepts Saudi Arabia and UAE numbers only.
  2. Click Save.
You see “Numbers have been added successfully.” A number already in the workspace is refused with “Phone number already exists.”

​
International numbers

India is always available. Canada, the United States, Saudi Arabia and the United Arab Emirates appear only when international calling is enabled for your workspace; without it, the country list shows India only, and Twilio and Maqsam are hidden. The same setting allows calls to numbers outside India. The dashboard has no switch for it: it turns on after your first successful payment, or contact Ringg support.

​
Remove, detach and tag numbers

All three actions are on the number’s row in All Numbers. Detach a number from its agent and take it out of running campaigns before you remove it. Test numbers can’t be removed or tagged.

​
With the API

Numbers are bought, imported and added in the dashboard only. Get Workspace Numbers reads the list (example in List numbers by API); pass a number’s id as from_number_id when you place a call.

​
Troubleshooting

Each provider sells in fixed countries (provider table), and countries other than India need international calling on your workspace.
The tab shows only when the selected account is your own provider account. It does not show for the Ringg account or for accounts that use Add custom.
Buy new shows “No new numbers available.” when the provider has none for that country and region. Set the region to All or try another region.
SIP appears only for enterprise workspaces and is not offered on the Saudi Arabia or UAE regional dashboards.
No. Every workspace has test numbers for test calls. You need your own number for calls to customers, campaigns and inbound agents.

​
Next steps

Answer inbound calls

Attach your new number to an inbound agent.

Rotate caller IDs

Put numbers in a pool for campaigns and API calls.

Run a campaign

Call a contact list from your new number.