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.

Make your agent call customers. Link a phone number for caller ID, then schedule calls via API with priority ordering and custom data. What you’ll learn: How to set up outbound calling, schedule calls via API, and monitor call status.

​
Prerequisites

Before making outbound calls:
  1. Agent configured and enabled
  2. Phone number added with valid SIP credentials
  3. Phone number linked to agent for outbound

Phone Numbers

Complete guide to adding phone numbers and SIP credentials
Set the caller ID your agent uses when making calls:
  1. Go to Agents → Select agent → Edit
  2. Find Outbound Phone Number section
  3. Select a phone number from the dropdown
  4. Click Save Agent
Each agent can have one outbound phone number. Linking a new number replaces the previous one.

​
Schedule a call

​
Quick test from dashboard

Test your agent before running campaigns:
  1. Go to your agent’s page
  2. Click Test Call
  3. Enter the target phone number
  4. Click Call — starts immediately

​
Schedule via API

const response = await fetch(
  'https://blackbox.dasha.ai/api/v1/calls?agentId=YOUR_AGENT_ID',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      endpoint: '+15551234567',
      priority: 5,
      additionalData: {
        customerId: 'cust_123',
        campaignId: 'spring_promo'
      }
    })
  }
);

const call = await response.json();
console.log('Call scheduled:', call.callId);

​
Schedule bulk calls

Schedule multiple calls in one request: 
const response = await fetch(
  'https://blackbox.dasha.ai/api/v1/calls/bulk?agentId=YOUR_AGENT_ID',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      calls: [
        { endpoint: '+15551234567', priority: 5, additionalData: { name: 'John' } },
        { endpoint: '+15559876543', priority: 5, additionalData: { name: 'Jane' } },
        { endpoint: '+15555555555', priority: 5, additionalData: { name: 'Bob' } }
      ]
    })
  }
);

const result = await response.json();
console.log(`Scheduled: ${result.successCount}, Failed: ${result.failedCount}`);

​
Monitor call status

​
Check individual call

const call = await fetch(
  `https://blackbox.dasha.ai/api/v1/calls/${callId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());

console.log('Status:', call.status);
// Created → Queued → Pending → InProgress → Completed/Failed

​
View queue

const queue = await fetch(
  `https://blackbox.dasha.ai/api/v1/calls/queue/list?agentId=${agentId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());

console.log(`Calls in queue: ${queue.totalCount}`);
queue.items.forEach(call => {
  console.log(`  ${call.endpoint} - Priority ${call.priority}`);
});

​
Receive webhooks

Configure webhooks for real-time status updates: 
// When scheduling the call
{
  endpoint: '+15551234567',
  completedWebHook: 'https://your-server.com/call-completed',
  failedWebHook: 'https://your-server.com/call-failed'
}

Webhook Events

Complete webhook payload reference

​
Cancel a scheduled call

Cancel calls that haven’t started yet: 
await fetch(
  `https://blackbox.dasha.ai/api/v1/calls/${callId}`,
  {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);
Only calls in Created, Queued, or Pending status can be canceled. Calls already InProgress cannot be canceled via API.

​
Call lifecycle

Created → Queued → Pending → InProgress → Completed
                                       ↘ Failed
StatusDescription
CreatedCall record created, not yet queued
QueuedWaiting in queue based on priority
PendingAbout to be dialed
InProgressCall connected, agent speaking
CompletedCall finished successfully
FailedCall failed (busy, no answer, error)

​
Troubleshooting

​
Calls not scheduling

SymptomFix
400 Bad RequestVerify phone number format (E.164: +15551234567)
404 Agent Not FoundCheck agentId is correct
”No outbound config”Link a phone number to the agent for outbound

​
Calls stuck in queue

SymptomFix
Calls not processingCheck agent is enabled
Slow queue processingCheck business hours schedule
Hitting concurrency limitUpgrade plan or reduce call volume

​
Low answer rates

SymptomFix
Many “No Answer”Call during optimal hours (10am-4pm local)
Calls marked spamUse local area code numbers
Quick hang-upsImprove greeting, reduce agent latency

​
What’s next

Phone Numbers

Add phone numbers for caller ID

Caller ID

Configure display names

Call History

Monitor call results

Webhooks

Handle call completion events