Receive Inbound Calls via Your SIP Trunk

​

How inbound calls work with BYOT

1. Your SIP provider sends the INVITE to Bolna’s SIP server at sip:sip.bolna.ai:5060 (UDP/TCP) or sip:sip.bolna.ai:5061;transport=tls (TLS trunks)
2. Bolna matches the called number against your registered phone numbers
3. The call is routed to the AI agent mapped to that number
4. The agent answers and handles the conversation

​

Prerequisites

1. You have created a SIP trunk on Bolna
2. You have added your phone numbers to the trunk
3. Your SIP provider is routing those DIDs to sip:sip.bolna.ai:5060 (or sip:sip.bolna.ai:5061;transport=tls for TLS trunks)
4. inbound_enabled is set to true on your trunk
5. You have a Bolna agent created

​

Map a phone number to an agent

curl -X POST https://api.bolna.ai/inbound/setup \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "phone_number_id": "01HQNUMBER111222333"
  }'

{
  "message": "SIP trunk number successfully mapped to agent"
}

​

Unlink a number from an agent

curl -X POST https://api.bolna.ai/inbound/unlink \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "phone_number_id": "01HQNUMBER111222333"
  }'

​

Troubleshooting inbound calls

1. Confirm your SIP provider has sip:sip.bolna.ai:5060 (or sip:sip.bolna.ai:5061;transport=tls for TLS trunks) set as the origination URI for the DID
2. Confirm the phone number has been added to the trunk
3. Confirm the phone number has been mapped to an agent (above)
4. Confirm inbound_enabled is true on the trunk
5. Check that the number format in the INVITE’s Request-URI or To header matches what you stored (with or without +)

​

Next steps

• Make outbound calls from your SIP trunk numbers
• Manage your trunk using the SIP Trunk API
• Monitor call status in real-time