Inbound Calls

Manage inbound call routing and dispatch rules for your AI agents.

The Inbound Calls page is where you connect the phone numbers you own to the AI agents you have built. By creating Dispatch Rules, you dictate exactly which agent answers the phone when a customer dials a specific number.

---

Create an Inbound Route

Setting up a new dispatch rule takes only a few clicks. Once configured, inbound calls are routed immediately with zero delay.

1. Assign to AI Agent

   Click the Select an agent dropdown to choose the specific AI assistant you want to handle the incoming calls. This list populates from the agents you have created in your workspace.

2. Route From Number

   Click the Select a phone number dropdown to choose the inbound line. This list includes any numbers you have purchased or imported via the Agni Telephony service.

3. Create Dispatch Rule

   Click the + Create Dispatch Rule button to activate the route. Your agent is now live and will answer any calls made to that number instantly.

1-to-1 Mapping: Currently, each phone number can only be routed to a single agent at a time to prevent routing conflicts. If you need to change the agent handling a number, you must delete the existing dispatch rule first.

---

Active Dispatch Rules

Once created, your routes will appear in the Active Dispatch Rules section.

This list provides a clear overview of all your live connections. If you manage a large fleet of numbers for different campaigns or clients, use the Search numbers… bar on the right side to quickly locate and manage specific routing configurations.

---

API Reference

To manage phone numbers and agents programmatically, refer to the following API endpoints:

Telephony API

List, buy, and manage the phone numbers available for routing.

Agent API

Retrieve the list of your configured AI agents to use in dispatch rules.