> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kolavoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbound calls

> Configure KolaVoice to answer calls to your business number.

Inbound calls begin when a customer dials a KolaVoice phone number. KolaVoice receives the call through the connected telecom network, routes it to the assigned AI agent, and stores the call result in the account.

## How inbound calling works

1. Get a phone number issued by KolaVoice.
2. Add the number to the account, or use a number already registered to the account.
3. Enable inbound calling for the number.
4. Assign an inbound agent.
5. Forward the business line to the KolaVoice number, if required.
6. Customers call the number and the assigned agent answers.

Inbound calls use the same agents, recordings, transcripts, summaries, call logs, and human handoff tools available in the dashboard.

## Phone number requirements

Inbound calling requires:

* A KolaVoice-issued phone number.
* An active KolaVoice plan where required for inbound service.
* `is_active` enabled on the number.
* `inbound_enabled` enabled on the number.
* An inbound agent assigned to the number.

If inbound calling is disabled or no agent is assigned, the call is rejected instead of being routed to an unrelated fallback agent.

See [Phone numbers](/docs/api-reference/phone-numbers) for number discovery and registration.

## Call records

Inbound calls appear in the same call records as outbound calls. A completed call can include:

* Caller and destination numbers
* Call status and end reason
* Duration and cost
* Transcript and summary
* Recording, when recording is enabled and available
* Human handoff activity

Use the dashboard call logs to review inbound conversations. The public API currently focuses on outbound calls and campaigns; inbound answering is configured through the account phone-number settings and telecom routing.

## Routing model

KolaVoice maintains the telecom routing for active inbound numbers. When a number or its inbound settings change, routing is synchronized so calls reach the assigned agent. Customers do not need a separate app or web link; they call the business number normally.

## Inbound versus outbound

| | Inbound | Outbound |
| - | - | - |
| Who starts the call | Customer | Your account or campaign |
| Main setup | Number and inbound agent | Agent, caller ID, wallet, and campaign or call request |
| API action | Configure routing and receive calls | Create a call or campaign |
| Results | Call log, transcript, summary, recording | Call status, outcomes, retries, follow-ups, and usage |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.