Skip to main content

​
How to set up inbound calls with Bolna?

To handle incoming calls with your Bolna Voice AI agent, you need to assign a phone number to your agent. When someone calls that number, your agent will automatically answer and have a conversation based on your configured prompts and settings.
You will need to assign a phone number to your Bolna Voice AI agent for automatically answering all incoming calls on that phone number

​
What are my options for getting a phone number?

​
Method 1. Purchase a phone number from the Bolna Dashboard.

Please refer to a step by step tutorial for purchasing phone numbers on Bolna.

Purchasing phone numbers on Bolna


​
Method 2. Connect your Telephony account and use your own phone numbers.

Connect your Twilio account

Use your own Twilio phone numbers with Bolna

Connect your Plivo account

Use your own Plivo phone numbers with Bolna

​
How to set up inbound calls from the dashboard?

1

Click "Assign inbound agent" button

Assign inbound agent button in Bolna dashboard for mapping Voice AI agents to phone numbers for incoming call handling

Click 'Assign inbound agent' button to map a Bolna Voice AI agent to a phone number

2

Choose phone number which you want to assign to the Bolna Voice AI agent

Phone number selection interface in Bolna showing available numbers for Voice AI agent assignment and inbound call routing

Select phone number for Bolna Voice AI agent

3

Confirm the phone number

Phone number confirmation screen in Bolna showing agent setup process for inbound Voice AI call handling

Setting up the agent

4

Voila! All set.

Successful phone number assignment confirmation in Bolna showing completed Voice AI agent setup for answering incoming calls

Your phone numbers is now successfully set up to answers calls by Bolna Voice AI agent

​
How to set up inbound calls using APIs?

​
Step 1. Use List Phone Numbers API to list all avalable phone numbers.

curl --request GET \
  --url https://api.bolna.ai/phone-numbers/all \
  --header 'Authorization: Bearer <token>'

​
Step 2. Use Set Inbound Agent API to assign a phone number for Bolna Voice AI agent.

curl --request POST \
  --url https://api.bolna.ai/inbound/setup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "phone_number_id": "123e4567-e89b-12d3-a456-426614174000"
}'

​
Next steps

Ready to start receiving inbound calls? Configure your agent and explore related features: For 24/7 automated support, combine inbound calling with guardrails and custom prompts.
⌘I