Phone numbers in Ringg: providers, test numbers, spam

Built and tested agents and workflows need phone numbers before they can reach real people. The one decision on this page is where numbers come from: Ringg-provided or your own telephony. In the dashboard: Sidebar → Inventory → Numbers.

Pages in this chapter

Page	Covers
Buy or import a number	The Add number dialog: buy a Ringg-provided number, connect a provider account, import or add your own numbers
Your own telephony	What connecting Exotel, Plivo, Twilio, Ozonetel, Ameyo or a trunk involves, with a page per provider
Number pools	Group numbers so outbound calls rotate across them and skip spam-flagged numbers
Inbound agent number (Build agents › Inventory)	Point a number at an inbound agent; choose the caller ID for test calls, campaigns and API calls

What numbers are used for

Use	How the number is chosen	Page
Inbound calls	You attach one number to an inbound agent. Calls to that number reach the agent.	Attach a number to an agent
Single outbound call	You pick the caller ID in the test dialog, or send `from_number_id`, `from_number` or `number_pool_id` in the API call.	Caller ID for outbound calls
Campaigns	You pick Individual numbers or a Number pool in the campaign’s Select number card.	Create a campaign, Number pools

The Numbers page

A tour of the Phone tab: All Numbers and Number Pools

The page has two channel tabs:

Phone: your voice numbers, split into All Numbers (every number, a telephony account filter and the Add number button) and Number Pools (groups that outbound calls rotate across).
WhatsApp: WhatsApp Business numbers. See WhatsApp numbers.

The All Numbers table has these columns:

Column	What it shows
ID	A copy button for the number’s ID. The API calls this `from_number_id`.
Country	The country flag.
Number	The number in international format, with a Spam chip if it has been flagged.
Provider	The telephony provider that carries the number, for example `plivo` or `exotel`.
Pool	The number pool it belongs to, or `-`.
Added On	The date the number was added.
Used By	The inbound agent the number is attached to, with a Detach Number button.
Tags	Your free-text tags, a Test number chip on test numbers, and Add Tags.
Actions	Remove Number.

Numbers page on the Phone tab with All Numbers open: telephony account filter set to All, Add number button, and a table of Indian numbers with provider, pool, added date, Used By agent and tags — All Numbers on the Phone tab

Ringg-provided numbers vs your own telephony

	Ringg-provided	Bring your own telephony ()
Who holds the line	Ringg	Your account with the provider
Billing	A rental rate per billing period, shown before you buy (Billing)	Your provider bills for the line. Importing a number is free, and Ringg charges no monthly rental.
Providers	Plivo and Vobiz	Exotel, Twilio, Ozonetel and others
How to get one	Add number → telephony account Ringg	Connect your account, then buy, import or add numbers

Pick Ringg-provided to start with no provider account; pick BYOT when you already own numbers or have a carrier contract. Once a number is in the workspace, both kinds are used the same way.

Test numbers

Every workspace sees Ringg’s shared test numbers, marked Test number (“For testing only. Not for live calls or number pools.”). Use them to test an agent before you buy a number.

Limit	Detail
Region-bound	The Indian (`+91`) test number calls Indian numbers only; the US test number calls numbers outside India only. The test dialog blocks a mismatch and offers to switch.
Testing only	Not offered when you pick numbers for a campaign.
No pools	Can’t join a number pool.
Not editable	Can’t be tagged or removed.

Spam flags and tags

Ringg checks Ringg-provided numbers and flags likely spam. A flagged number shows a red Spam chip in the table; hover it to read the reason. Number pools skip spam-flagged numbers and can buy replacements on their own; see Auto purchase. Outside a pool, a flagged number still places calls: single calls and campaigns that pick it under Individual numbers use it as usual.

A row for +919876541202 with a red Spam chip and a tooltip giving the reason and the date it was flagged — Hovering the Spam chip shows the reason

Tags are free text, for labelling numbers by team, region or purpose (collections, Karnataka). They show in the table and in number pickers.

WhatsApp numbers

WhatsApp numbers live on the WhatsApp tab. They belong to a connected WhatsApp Business account, not to a telephony provider. Until an account is connected, the tab shows “WhatsApp Business is not set up yet.” with a Setup WhatsApp business button. See Connect WhatsApp Business.

Supported telephony providers

These providers appear in the Add number dialog. Their credential fields are listed in Connect a provider account.

Provider	Countries you can buy in	Setup guide
Exotel	India	Exotel
Mcube	India	—
Ozonetel	India, United States	Ozonetel
Plivo (also Ringg-provided)	India, United States	Plivo
Tata Tele	India	—
InTalk	Import only	—
Maqsam	Saudi Arabia, United Arab Emirates	—
Twilio	United States, Canada	Twilio
Vobiz (also Ringg-provided)	India	—
VoiceLink	India	—
SIP	Numbers added by hand	SIP trunking
Custom	Numbers added by hand	—

Countries other than India appear only when international calling is enabled for your workspace; without it, Twilio and Maqsam are hidden (International numbers). SIP shows for enterprise workspaces, except on the Saudi Arabia and UAE regional dashboards. Custom shows only when Ringg has set up a custom telephony account for you.

List numbers by API

Get Workspace Numbers returns the whole All Numbers list in one response, newest first, including id, is_test_number, is_spam, spam_message, provider, owner, tags, agent and number_pool_id. It has no paging. To narrow it, pass telephony_account_id (a connected account’s ID, or ringg for Ringg-provided and test numbers) or inbound_enabled=true. You need an API key.

curl "https://prod-api.ringg.ai/ca/api/v0/workspace/numbers" \
  -H "X-API-KEY: $RINGG_API_KEY"

const res = await fetch("https://prod-api.ringg.ai/ca/api/v0/workspace/numbers", {
  headers: { "X-API-KEY": process.env.RINGG_API_KEY },
});
console.log(await res.json());

import os

import requests

res = requests.get(
    "https://prod-api.ringg.ai/ca/api/v0/workspace/numbers",
    headers={"X-API-KEY": os.environ["RINGG_API_KEY"]},
)
print(res.json())

Pass a number’s id as from_number_id when you place a call.

Next steps

Get a number

Buy a number, import one from your provider, or add one by hand.

Answer inbound calls

Attach a number to an inbound agent and set outbound caller ID.

Build agents

Inventory

Deploy

Monitor

Manage account

Ringg Labs

Phone numbers

Pages in this chapter

What numbers are used for

The Numbers page

Ringg-provided numbers vs your own telephony

Test numbers

Spam flags and tags

WhatsApp numbers

Supported telephony providers

List numbers by API

Next steps

Get a number

Answer inbound calls

​Pages in this chapter

​What numbers are used for

​The Numbers page

​Ringg-provided numbers vs your own telephony

​Test numbers

​Spam flags and tags

​WhatsApp numbers

​Supported telephony providers

​List numbers by API

​Next steps

Get a number

Answer inbound calls

Pages in this chapter

What numbers are used for

The Numbers page

Ringg-provided numbers vs your own telephony

Test numbers

Spam flags and tags

WhatsApp numbers

Supported telephony providers

List numbers by API

Next steps