All WebSocket examples require authentication with a web integration token or API key.
Connection lifecycle
1
Connect
Establish WebSocket connection to Dasha BlackBox server
2
Authenticate
Send
initialize message with call configuration3
Communicate
Exchange messages bidirectionally (chat or voice via WebRTC)
4
Disconnect
Send
terminate to end gracefullyConnection endpoints
Call types
Quick start: Chat
Example: Basic chat connection
Example: Basic chat connection
When to use WebSockets vs REST
Use WebSockets for:- Real-time chat conversations
- Browser-based voice calls (WebRTC)
- Tool execution with immediate results
- Creating and configuring agents
- Enqueueing outbound phone calls
- Fetching call history and results
Message types
Client → Server
Server → Client
Message Reference
Complete schema documentation
What’s next
Chat Implementation
Build a complete text chat interface
Voice Call Implementation
Add WebRTC voice calls
Message Reference
Complete message schemas
Tool Execution
Handle agent tool calls