Phone Numbers

Manage phone numbers used by voice bots in your tenant. OmniBots integrates with Telnyx for telephony, allowing you to purchase and manage numbers directly from the portal.

Overview

Three stat cards at the top show:

• Total Numbers — all phone numbers in the tenant
• Active Numbers — numbers currently in use
• Toll-Free Numbers — toll-free numbers in your inventory

Viewing Phone Numbers

Phone numbers are displayed as cards in a grid layout. Each card shows:

Field	Description
Number	Formatted phone number
Type	Local or Toll-Free
Status	Active, Available, or Reserved (with colored indicator)
Provider	Telephony provider (e.g., Telnyx)
Capabilities	Voice, SMS, or both
Monthly Cost	Recurring charge for the number
Primary	Badge shown if this is the primary number

Use the search bar to filter by number or friendly name, and the type dropdown to filter by All Types, Toll-Free, or Local.

imagePhone number management grid showing number cards with formatted number, type badge, colored status indicator, provider name, capabilities icons, monthly cost, and primary badge

Phone number management grid

Purchasing a Number

1. Click Purchase Number.
2. In the modal, select:
   • Number Type — Local or Toll-Free
   • Area Code (local numbers only)
   • Capabilities — Voice, SMS, or both
3. Click Search to find available numbers.
4. Select one or more numbers from the results. Each shows its location/region and monthly cost.
5. Click Purchase to acquire the selected numbers.

Purchased numbers appear in your inventory and can be assigned to voice bots via Phone-Bot Mapping.

imagePurchase number modal showing number type selector, area code input field, capabilities checkboxes, search results list with available numbers displaying location and monthly cost, and purchase button

Purchase phone number modal

Setting a Primary Number

Click the star icon on a number card to mark it as the primary number. The primary number is used as the default caller ID for outbound calls.

Releasing a Number

Click the delete icon on a number card to release (remove) the number. Released numbers are returned to the provider and stop incurring charges.

WARNING

Releasing a number is permanent. If the number is assigned to a bot, unassign it first via Phone-Bot Mapping.