Bolna guide
Connect a Bolna agent to a TryVox phone number.
End-to-end setup for Bolna + TryVox numbers. Same shape as the Vapi guide.
Prerequisites
- TryVox account with at least one Active phone number.
- Bolna account with at least one agent.
- Bolna API key (Dashboard → Developers → API Keys).
1. Connect Bolna
- TryVox dashboard → AI Agents → Connect provider.
- Provider: Bolna.
- API key: paste your Bolna key.
- Connect.
2. Connect a number
Connect number → pick a TryVox number → pick the Bolna agent → Connect.
On the first number, TryVox creates a SIP trunk named TryVox-… in your Bolna account. It points back at TryVox, with credentials and our SBC addresses already filled in. Then, for each number, TryVox:
- adds the number to that trunk and assigns your agent to it;
- switches the agent's telephony to SIP Trunk and sets its webhook URL so call results reach TryVox.
Switching to SIP Trunk moves that agent off any Twilio, Plivo or Exotel number it used before. Use a separate agent if you still need those.
3. Outbound
Outbound works from the API or from Bolna. Calls leave from the connected TryVox number and are recorded and billed in TryVox like any other call.
Disconnecting
Deleting the integration in TryVox deletes the TryVox-… trunk in Bolna, which releases every number on it. If Bolna can't be reached, nothing is deleted. Try again in a minute. Don't delete the trunk yourself in Bolna while the integration exists, or inbound calls will fail.
If you revoked your Bolna API key first, TryVox can no longer reach your account to release the numbers. Delete the TryVox-… trunk yourself in Bolna → SIP Trunks. Until you do, those numbers can't be connected to any Bolna account, because Bolna allows a number on only one trunk across the whole platform.
Troubleshooting
| Symptom | Fix |
|---|---|
| Key invalid | Generate a new key under Developers → API Keys. |
| "This number is already connected to an AI agent; disconnect it first" | The number is already connected to an AI agent in TryVox. Disconnect it from that agent, then connect it again. |
| "This number is registered on another Bolna SIP trunk" | A Bolna number can live on only one trunk across Bolna. Remove it from the other trunk (another account, or a trunk you made by hand), then connect it again. If the other trunk is a TryVox-… trunk left behind after you revoked your key, delete it in Bolna → SIP Trunks. |
| Agent never answers | Check the agent shows SIP Trunk telephony and that the number is assigned to it under the TryVox-… trunk's Numbers tab. |