Skip to main content
Numbers are the phone lines your assistants use to make and receive calls. You can use Ringg AI numbers or connect numbers from your own telephony provider.

View Numbers

  1. Click Numbers in the left sidebar.
  2. Review the numbers in your workspace.
Each row shows:
FieldMeaning
Phone numberThe full caller number
CountryThe number’s country
Date addedWhen the number was added
Used ByWhich assistant or campaign is using it
TagsLabels such as Default Number

Buy a New Number

  1. On the Numbers page, click Buy new number.
  2. Choose the country, area, and number type if those options are available.
  3. Review the purchase details.
  4. Confirm the purchase.
The number appears in your workspace after the purchase completes.
Number availability and pricing depend on the country and telephony provider.

Bring Your Own Telephony

Use Bring Your Own Telephony when your company already owns numbers with a provider such as Twilio, Exotel, or Plivo.
  1. Click Integrations in the left sidebar.
  2. Open the Your Telephony tab.
  3. Click Add New.
  4. Choose the provider.
  5. Enter the provider credentials.
  6. Click Save.
  7. Return to Numbers and confirm the numbers appear.
The Telephony dropdown at the top of the Numbers page shows the active provider.

Set a Default Number

A number tagged as Default Number is used when no specific number is selected.
  1. Find the number on the Numbers page.
  2. Click the tag action.
  3. Add the tag Default Number.
  4. Save the change.
Use one default number per workspace unless your operations team has a specific routing plan.

Assign Numbers to Campaigns

You choose caller numbers while creating a campaign.
  1. Open or create the campaign.
  2. In the Numbers field, select one or more numbers.
  3. Save the campaign.
Multiple numbers can spread call volume across caller IDs. For Inbound assistants, the assigned number is the number customers dial.

Remove a Number

  1. Confirm the number is not used by a live campaign or inbound assistant.
  2. Click Remove next to the number.
  3. Confirm the removal.
Removing a number that is used by a running campaign or inbound assistant can interrupt calls. Pause campaigns or reassign assistants before removing it.

Developer Handoff

If engineers will make API calls or configure routing, send them:
ItemWhy They Need It
Phone numberHelps confirm the visible caller ID
Number providerTells them whether the number is Ringg AI-owned or from your telephony provider
from_number_idPreferred identifier for outbound API calls when available
from_numberUse only when the API flow expects the literal phone number
Assigned assistant or campaignHelps them confirm the number is used in the right place
For individual outbound API calls, exactly one caller-number option is required: from_number_id or from_number. Do not send both.