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.

​
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

Connect your Vobiz account

Use your own Vobiz phone numbers with Bolna

Connect your Exotel account

Use your own Exotel 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
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
3

Confirm the phone number

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

Voila! All set.

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

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