Skip to main content

​
What is Caller Identification?

Link your inbound phone numbers to custom data sources. When a call comes in, your Bolna Voice AI agent automatically identifies the caller, matches their number, and pulls in relevant details like name, address, preferences, past history, or any data you provide. Configure this in Agent Studio under Calling tab → Inbound Calling → Database for inbound phone numbers: turn on Inbound Calling, select an inbound number, then pick a data source from the Select data source dropdown (see the Inbound Calling settings).
Inbound Calling section of the Calling tab with the inbound number selector, a Database for inbound phone numbers block containing the Select data source dropdown and the Allow incoming phone calls only from the chosen database toggle, and Spam Prevention Settings

Database for inbound phone numbers, inside Inbound Calling on the Calling tab

The Select data source dropdown stays disabled until an inbound number is selected. This data is seamlessly injected into the agent’s prompt, making every interaction personalized and contextual.

​
Data Source Options

Best for: Teams with existing databases or CRM systems.Provide an API endpoint that accepts the caller’s phone number. Bolna automatically sends the following parameters:Choosing Use your internal APIs reveals an endpoint URL field and an auth token field next to the data source dropdown.Example request:
The returned JSON data is automatically merged into the AI prompt before the call begins. Each top-level key of the response becomes a variable: flat values fill {{variable}} tokens, and nested objects or arrays are reachable with dotted paths (for example {{account.balance}} or {{orders.0.status}} — see Nested JSON Variables). Make sure your prompt paths start at a top-level response key and mirror the JSON structure exactly.
  • The endpoint must be a GET endpoint
  • Supported authentication: Bearer Token
Your APIs must return a response within 3 seconds. If a request times out or takes longer, the injected data will not be available and the corresponding variables will remain empty.

Block Incoming Callers

Reject spam numbers or prefixes by returning an empty result

Inbound Call Setup

Configure inbound calling for your agents

Using Context

Pass dynamic data to personalize conversations

IVR Setup

Route inbound calls with IVR menus