Skip to main content

​
What is the Inbound Tab?

The Inbound Tab is where you configure settings for receiving incoming calls. Match callers to your database, preload user data before the call starts, and set up spam prevention to protect your agents from abuse.
Inbound Tab showing database matching, call restrictions, and spam prevention settings

​
Database for Inbound Phone Numbers

Match incoming calls to users and preload their data before the call starts. Choose from three data source options:
Connect your own API to fetch user data dynamically when a call comes in.
Inbound settings with internal API option showing API Endpoint URL and Auth Token fields
1

Select Data Source

Choose “Use your internal APIs” from the dropdown.
2

Enter API Endpoint URL

Provide your API endpoint that will receive the caller data request.
3

Add Auth Token

Enter your Bearer token for secure authentication.

​
Query Parameters

Bolna automatically passes these parameters to your API:
ParameterDescription
contact_numberThe caller’s phone number
agent_idYour agent’s identifier
execution_idUnique identifier for this call
Your API must return a JSON response with user details. Bolna will inject this data directly into your agent’s prompt for personalized conversations.

​
Example API Request

curl -X GET "https://your-api.com/user-data?contact_number=+919876543210&agent_id=abc123&execution_id=xyz789" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json"

​
Example API Response

{
  "user_name": "John Doe",
  "account_status": "premium",
  "last_purchase": "2026-01-15"
}
Authentication uses Bearer token and is stored securely by Bolna.

​
Call Restrictions

Toggle on “Allow Calls Only from Database” to restrict incoming calls to only phone numbers found in your chosen database. Unknown callers will be rejected.

​
Spam Prevention Settings

Protect your agent from spam and abuse.
SettingDescription
Maximum Calls per Phone NumberLimit calls from a single number. Set to -1 for unlimited.
Always-Allow ListPhone numbers that bypass all call limits.
Add your support team and VIP customers to the Always-Allow List to ensure they’re never blocked.

​
Use Cases

Customer Verification

Only allow calls from registered customers

VIP Support

Preload customer data for personalized service

Abuse Prevention

Limit repeated calls from the same number

Dynamic Data Loading

Fetch real-time customer data via API

​
Next Steps

Agent Tab

Configure prompts and welcome message

Call Tab

Set up telephony and call management

Receiving Calls Guide

Complete inbound setup guide

Phone Numbers

Purchase and manage phone numbers