The Phone Numbers page is your control center for telephony. Before you can buy numbers or route inbound and outbound calls, you must configure your underlying telephony provider. Currently, Agni natively supports Twilio. A Custom Provider option is visible in the left menu but is currently in active development.
Choose Your Account Strategy

​
First-Time Setup: Choose Your Strategy

When you access the Phone Numbers tab for the first time and select Twilio, you must choose how you want to manage your telephony infrastructure.

​
Path A: Your Own Account (BYOT)

Choose this option if you already have a Twilio account and want full ownership, compliance control, and direct billing from Twilio.

Select Your Own Account

Click Choose this option under the “Your Own Account” card.

Confirm Selection

A confirmation modal will appear. Click Continue Setup to lock in your configuration.
Confirm BYOT Selection

Enter Credentials

Provide a Friendly Name for your integration, along with your Twilio Account SID and Auth Token. These can be found in your Twilio Console. Click Connect Account.
Enter Twilio Credentials
When to choose BYOT: If you need regulatory compliance control, already have Twilio numbers, want to keep telephony billing separate from Agni, or need access to Twilio’s full feature set.

​
Path B: Managed Account

Choose this option if you want a zero-configuration experience. Agni will manage the underlying infrastructure, and telephony usage will be deducted directly from your Agni credit balance.

Select Managed Account

Click Choose this option under the “Managed Account” card.

Accept Terms and Conditions

Because Agni handles the billing and compliance for Managed Accounts, you must review and accept the telephony terms.
  • Service Selection: The Managed Twilio selection is permanent and cannot be changed without administrative approval.
  • Credit-Based Subscription: Services operate on prepaid credits. Unused credits expire at the end of each billing cycle.
  • Phone Number Renewal: Phone numbers must be renewed every 28 days. Failure to renew within the 48-hour window will result in permanent number release.
  • Strict No Refund Policy: All purchases are final. No refunds are issued for unused credits, missed renewals, service interruptions, or account termination.
Telephony Terms and Conditions

Assign Friendly Name

Give your managed connection a Friendly Name to identify it in your workspace, then click Connect Account to finalize the setup.
When to choose Managed: If you want the fastest setup, don’t have a Twilio account, and prefer consolidated billing through Agni.

​
Managing Phone Numbers

Once your account strategy is configured, you will unlock the main Phone Numbers dashboard.
Phone Numbers Dashboard

​
Buy a New Number

Use the left panel to search for and purchase new phone numbers directly into your workspace:

Select Country

Select your desired Country from the dropdown menu to load available inventory.

Search & Filter

Use the search bar to filter for specific area codes, prefixes, or vanity patterns.

Review Pricing

Review the costs associated with the number:
  • Monthly fee — Flat rate for owning the number (e.g., $1.15/mo for US numbers).
  • Outbound rate — Per-minute cost for calls your agent makes (e.g., $0.0945/min).
  • Inbound rate — Per-minute cost for calls your agent receives (e.g., $0.0085/min).

Purchase

Select a number and click Buy Number to provision it immediately to your workspace.

​
Owned Numbers

The right panel displays your active inventory. Any number listed here is immediately ready to be used in your Inbound Calls dispatch rules or as a Caller ID for outbound campaigns.
Phone numbers on Managed Accounts must be renewed every 28 days. Set a reminder or monitor your Billing page to avoid accidental number loss.

​
API Reference

Agni’s Telephony API allows you to automate number provisioning and management directly from your backend.

List Available Numbers

Search the inventory for numbers available to purchase in any country.

Buy Number

Programmatically purchase a number and add it to your workspace.

List Purchased Numbers

Retrieve the active inventory of phone numbers you own.

Release Number

Release a phone number back to the provider to stop monthly billing.