Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blackbox.dasha.ai/llms.txt

Use this file to discover all available pages before exploring further.

Route incoming phone calls to your agent. Link a phone number to an agent, and calls to that number automatically connect to the agent. What you’ll learn: How to link phone numbers for inbound routing and test incoming calls.

​
How inbound calls work

When a phone number is linked to an agent:
  1. Caller dials the phone number
  2. Call routes through your SIP provider
  3. Agent answers and starts the conversation
  1. Navigate to Phone Numbers
  2. Click on the phone number you want to use
  3. Select an agent from the Inbound Agent dropdown
  4. Click Save
Each phone number can only be linked to one agent for inbound calls. Linking to a new agent automatically unlinks from the previous one.

​
Configure greeting

Talk First

Configure the agent’s first message when answering calls

​
Set business hours

Control when your agent accepts inbound calls:
  1. Go to Agents → Select agent → Edit
  2. Navigate to Schedule section
  3. Set your business hours and timezone
  4. Click Save Agent
No schedule configured = 24/7 availability.

Scheduling & Availability

Complete guide to business hours, holidays, and timezone configuration

​
Test inbound calls

1

Verify setup

  • Agent is enabled (isEnabled: true)
  • Phone number is linked for inbound
  • SIP credentials are valid (check registration status)
2

Make a test call

Call the phone number from your mobile phone
3

Verify connection

Agent should answer with configured greeting
4

Review in dashboard

Go to Calls → Verify call appears in history with transcript

​
Check phone number status

Verify a phone number is correctly linked: 
const phoneNumber = await fetch(
  `https://blackbox.dasha.ai/api/v1/sip-phone-numbers/${phoneNumberId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());

console.log('Phone:', phoneNumber.phoneNumber);
console.log('Inbound agent:', phoneNumber.incomingCallsAgentId || 'Not linked');
console.log('Registration:', phoneNumber.registrationStatus);
Stop routing calls to an agent:
  1. Navigate to Phone Numbers
  2. Click on the phone number
  3. Clear the Inbound Agent dropdown (select “None”)
  4. Click Save
After unlinking, calls to this number will not be answered.

​
Troubleshooting

​
Calls not reaching agent

SymptomFix
Call goes to voicemailVerify phone number is linked to an agent
”Number not in service”Check SIP registration status is successful
Ring but no answerVerify agent is enabled

​
Agent not answering correctly

SymptomFix
No greeting playsSet firstMessage in agent config
Wrong agent answersCheck phone number is linked to correct agent
Agent unavailableCheck business hours schedule

​
Registration issues

SymptomFix
Status: “Not registered”Verify SIP credentials are correct
Status: “Failed”Check server address and transport protocol
Intermittent failuresEnable registration if your provider requires it

​
What’s next

Outbound Calls

Make calls via API

Phone Numbers

Add and manage phone numbers

Business Hours

Configure availability schedule

Call History

Monitor inbound calls