Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ravan.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
Agni Inbound Calls Dashboard

​
Prerequisites

Before creating dispatch rules, make sure you have:

At least one agent

You need an active, configured agent to answer the phone.

At least one phone number

You must have a purchased or imported phone number available in your workspace.

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

Assign to AI Agent

Click the ASSIGN TO AI AGENT dropdown to choose the specific AI assistant you want to handle the incoming calls.

Select Phone Number

Click the PHONE NUMBER dropdown to choose the inbound line the public will dial.

Create Inbound Call

Click the + Create Inbound Call button to activate the route. Your agent is now live.
Strict 1-to-1 Mapping: You can only create one inbound call route per phone number. If you want to assign a new agent to a number that is already in use, you must first complete or delete the previous inbound call rule.

​
Inbound Route Detail View

Once a dispatch rule is created, it will appear in your Inbound Call Rules list. Clicking on a specific active rule opens the detailed Route Dashboard. This gives you a comprehensive overview of how that specific number is performing.
Inbound Route Detailed Overview showing metrics and schedule
The detail view provides several key pieces of information:
  • Identity & Routing: Quickly verify the Assigned Agent, the specific Agent ID, and the designated Phone Number.
  • Performance Metrics: Monitor volume at a glance with counters for Total Completed calls, calls currently Live In Progress, and the total number of Recent Calls.
  • Schedule & Status: The Schedule block confirms when the route was Created, when it ended (or if it is Still active), and provides the unique Dispatch Rule ID.
  • Recent Calls Log: A dedicated table at the bottom of the page displays a live feed of all the calls that have recently come through this specific inbound route.

​
Common Routing Patterns

The simplest setup. Buy a number, assign it to an agent, and you’re live. Ideal for a single product line or department.
Buy separate numbers for sales, support, and billing. Create a dispatch rule for each, routing to specialized agents with different prompts and tools.
Use unique phone numbers for different marketing campaigns or ad channels. Route each to the same agent but use dynamic variables to track which campaign the caller came from.

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