Skip to main content
Bolna is a platform for building multilingual voice AI agents. Connect your Plivo account to Bolna, and Bolna agents make and receive phone calls on your Plivo numbers. Calls run on your own Plivo account and are billed to it.

​
How it works

Call flowBolna
  1. Phone Call
    PlivoNumber + Application
    Answer URLCall audio
    BolnaVoice agent
You connect Plivo to Bolna once with your Auth ID and Auth Token. After that, Bolna handles the call flow:
  • Outbound — Bolna dials out through your connected Plivo account, using a Plivo number as the caller ID. No Plivo console changes are required.
  • Inbound — you point a Plivo Application’s Answer URL at Bolna’s inbound URL and link your number to that Application. When someone calls the number, Plivo fetches Bolna’s URL and connects the caller to the assigned Bolna agent.

​
Prerequisites

​
Connect Plivo to Bolna

Connect your Plivo account once, then set Plivo as the agent’s telephony provider.
1

Add your Plivo credentials to Bolna

  1. In the Bolna dashboard, go to Settings → Integrations.
  2. Filter by Telephony and select Connect on the Plivo card.
  3. Enter your Auth ID, Auth Token, and a Plivo phone number in E.164 format.
  4. Select Connect.
2

Set Plivo as the agent's provider

  1. Open your agent in Bolna.
  2. On the Call tab, set the telephony provider to Plivo.
  3. Save the agent.
Your Plivo numbers are available as the caller ID only after the account is connected.

​
Make outbound calls

Bolna dials out through your connected Plivo account. No Plivo console changes are required.
1

Place a call

Open the agent in Bolna, enter the destination number in E.164 format, and select Call.To trigger calls from your own application, use Bolna’s Make a call endpoint:
2

Check the call

The response returns an execution_id. Retrieve it with Bolna’s Get an execution endpoint for the transcript, cost, and telephony data.A call moves through these statuses: queued → ringing → in-progress → call-disconnected → completed. The completed status can take two to three minutes to appear after the call ends.For campaigns across many numbers, see Bolna’s Batch APIs.

​
Receive inbound calls

Route calls from your Plivo number to a Bolna agent by pointing a Plivo Application’s Answer URL at Bolna’s inbound URL.
1

Get the inbound URL from Bolna

  1. Open your agent in Bolna and copy the inbound URL shown on it.
  2. Assign the agent to your number under My Numbers.
Copy the URL in full, including its query string — the agent_id and user_id parameters identify the agent that answers. To do this programmatically, see Bolna’s Set inbound agent.
2

Create an application in Plivo

  1. In the Plivo console, go to Voice → Applications and select Add New Application.
  2. Enter a name, for example bolna-inbound.
  3. Configure these fields, then select Create Application:
3

Connect your phone number

  1. In the Plivo console, go to Phone Numbers → Your Numbers and open your number.
  2. Set its Application to the application you created.
  3. Select Update Number.
4

Test

Call your Plivo number. The assigned Bolna agent answers.
IVR routing. To let callers choose an option before an agent answers, pass an ivr_config object to the same Set inbound agent endpoint. This supports routing to different agents, language selection, and collecting digits. See Bolna’s IVR for inbound calls.

​
Troubleshooting

Debug logs. For inbound issues, check the Plivo logs first. For outbound issues, check the Bolna execution first. For hangup causes, see Plivo hangup codes.

Plivo Audio Streaming

How Plivo streams call audio to a voice agent.

Application API

Create and manage Plivo Applications programmatically.

Bolna Plivo docs

Bolna’s own Plivo configuration reference.

Bolna API reference

Agents, calls, and inbound setup.