Phone Numbers

Provision, manage, and configure the telephony infrastructure for your AI agents.

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. You will see an option for Custom Provider in the left menu, but please note this feature is currently in active development and will be available soon.

---

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.

1. Select Your Own Account

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

2. Confirm Selection

   A “Perfect Choice!” confirmation modal will appear. Click Continue Setup to lock in your configuration.

   
3. 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.

   

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.

1. Select Managed Account

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

2. Accept Terms and Conditions

   Because Agni handles the billing and compliance for Managed Accounts, you must review and accept the strict telephony terms.

   View Terms & Conditions Summary

   • 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.

   
3. Assign Friendly Name

   Give your managed connection a Friendly Name to identify it in your workspace, then click Connect Account to finalize the setup.

---

Managing Phone Numbers

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

Buy a New Number

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

1. Select Country

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

2. Search & Filter

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

3. Review Pricing

   Review the costs associated with the number (Outbound/Inbound per-minute rates and the flat monthly renewal fee).

4. 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.

---

API Reference

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

List Available Numbers

Search the Twilio inventory for numbers available to purchase.

Buy Number

Programmatically purchase a number and add it to your Agni 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.