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.

Quick reference for Dasha BlackBox platform terminology.

Core Concepts

Agent

AI voice assistant that handles conversations autonomously. Configured with a system prompt, LLM, voice, and optionally tools. Agents can receive inbound calls and make outbound calls.

Conversation

Single interaction between an agent and a person. Each conversation has a unique ID and produces a transcript.

Tool

Action an agent can take mid-conversation. Tools call your API to perform operations like checking order status, booking appointments, or looking up customer data. Defined with JSON Schema for parameters.

Webhook

HTTP notification sent to your server when events occur. Events include call started, call ended, tool execution requested, and transcription updates.

Voice & Speech

TTS (Text-to-Speech)

Technology that converts agent text responses into spoken audio. Dasha BlackBox supports multiple providers: ElevenLabs, Cartesia, Inworld, and LMNT.

STT (Speech-to-Text)

Also called ASR (Automatic Speech Recognition). Converts caller speech into text that the agent can process. Handles accents, background noise, and real-time transcription.

ASR (Automatic Speech Recognition)

See STT. The technology that transcribes spoken words into text.

Voice ID

Identifier for a specific voice within a TTS provider. Each provider offers different voices with varying characteristics.

Pronunciation Dictionary

Custom rules for how the agent pronounces specific words. Useful for brand names, technical terms, and uncommon words.

LLM Configuration

LLM (Large Language Model)

AI model that generates agent responses. Dasha BlackBox supports OpenAI, Anthropic, Google, Azure, Groq, and Reflex-1 models.

Reflex-1

Dasha’s in-house LLM optimized for real-time voice conversations with very fast response times.

System Prompt

Instructions that define agent behavior, personality, and capabilities. The foundation of agent configuration.

Temperature

LLM setting controlling response randomness. Lower values (0.3-0.5) produce consistent responses; higher values (0.7-0.9) produce more varied responses.

Telephony

SIP (Session Initiation Protocol)

Standard protocol for voice calls over internet. Used for connecting to phone systems.

SIP Trunk

Connection between Dasha BlackBox and your phone system. Enables inbound and outbound calls through your existing phone numbers.

SIP Credentials

Organization-level authentication settings for your SIP trunk provider. Stores server address, username, password, and transport protocol. Multiple phone numbers can share the same credentials.

Twilio Provider

Managed SIP integration that automatically creates and configures SIP trunks. Simplifies setup by handling credential management and phone number provisioning through your Twilio account.

CPS (Calls Per Second)

Rate limit for simultaneous call attempts through a SIP trunk. Configured via cpsLimit to prevent overloading your telephony provider.

E.164 Format

International phone number format. Includes country code with + prefix: +12025551234.

IVR (Interactive Voice Response)

Automated phone menu system (“Press 1 for sales”). Dasha BlackBox agents can detect and navigate IVR systems during outbound calls.

DTMF (Dual-Tone Multi-Frequency)

Touch-tone signals generated when pressing phone keys. Used for navigating phone menus.

Call Handling

Inbound Call

Call received by the agent. Caller dials a phone number connected to your agent.

Outbound Call

Call initiated by the agent. Scheduled via API to contact a recipient.

Phone Number Linking

Connecting a phone number to an agent. Use inbound mode for receiving calls or replaceOutbound mode for caller ID on outgoing calls.

Caller ID

Phone number displayed to recipients during outbound calls. Set by linking a phone number with replaceOutbound mode.

Call Priority

Priority level for outbound calls: low, medium, high, or critical. Higher priority calls are processed first in the queue.

Business Hours

Schedule defining when an agent accepts inbound calls. Calls outside business hours can be rejected or handled differently.

Warm Transfer

Transfer where the agent briefs the human operator before connecting the caller. Operator receives context about the conversation.

Three-Way Announcement

Message played to the caller during warm transfer while the agent briefs the operator. Can be static text or dynamically generated using smartV1 mode.

Cold Transfer

Direct transfer to a human operator without briefing. Faster but requires caller to re-explain their situation.

HTTP Transfer

Dynamic transfer routing via webhook. Your server determines the transfer destination based on real-time data.

Call Recording

Audio recording of the conversation. Enabled per-agent and stored for later review.

Pre-Conversation Media

Audio file played before the agent speaks. Configured separately for inbound, outbound, and web calls. Useful for greetings, disclaimers, or hold music.

Noise Suppression

Krisp-powered audio filtering that removes background noise from calls. Configured with a level from 0 (off) to 100 (maximum). Incurs additional per-minute fee.

Integrations

MCP (Model Context Protocol)

Protocol for connecting external data sources and tools to agents. Enables dynamic capabilities without custom webhook development.

Knowledge Base

External information source connected to an agent. Agents can query knowledge bases to answer questions beyond their system prompt.

Web Integrations

Web Integration

Configuration for embedding agents in websites. Includes allowed origins, enabled features (voice/chat), and widget appearance settings.

Widget

Embeddable UI component for your website. Provides voice or chat interaction with your agent directly in the browser.

WebSocket

Real-time communication protocol used for web voice calls and chat. Enables bidirectional streaming of audio and messages.

Access Token

Short-lived credential for authenticating WebSocket connections. Generated via API and passed to the widget for secure access.

Monitoring

Activity Logs

System events tracked for debugging and auditing. Includes call events, tool executions, errors, and warnings. Searchable by event type, severity, agent, and date range.

Events & Notifications

StartWebHookPayload

Webhook sent when a call begins. Can include custom data from the caller.

CompletedWebHookPayload

Webhook sent when a call ends. Contains transcript, call duration, and result data.

ToolWebHookPayload

Webhook requesting tool execution. Your server performs the action and returns the result.

Performance

Latency

Time between user speech and agent response. Target is under 2 seconds for natural conversation.

Concurrency

Number of simultaneous active calls. Limited by account tier.

Rate Limiting

API request limits to prevent abuse. Tracked per endpoint with retry guidance.

Account

Organization

Top-level account container. Holds all agents, integrations, and team members.

API Key

Authentication credential for API access. Starts with bb_. Keep secret and never expose in client-side code.

Core Concepts

Detailed explanation of building blocks

Quickstart

Create your first agent