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.

Test your agent in the browser without phone calls. Click Test to start voice or chat conversations with real-time transcripts. What you’ll learn: Starting test conversations, choosing test modes, and reviewing results.

​
Start a test conversation

1

Open your agent

Go to Agents in the sidebar and select your agent.
2

Click Test

Click Test in the Quick Actions panel.
3

Choose your mode

Select Voice, Chat, or Phone from the mode selector.
4

Have a conversation

Speak or type to interact with your agent. The transcript displays in real time.
5

End the call

Click End Call when finished. Call results become available for review.

​
Test modes

ModeDescriptionBest for
VoiceReal-time voice conversation using STT and TTSFinal validation, voice quality, latency testing
ChatText-based conversation with instant responsesPrompt iteration, debugging, quick scenarios
PhoneCall a real phone numberEnd-to-end telephony testing

​
Test controls

ControlFunction
Mode selectorSwitch between Voice, Chat, and Phone modes
Text inputType messages (chat mode)
End CallStop the current conversation

​
Reviewing results

After ending a test call, view the call result:
1

End the call

Click End Call when finished.
2

View the result

Click Show on the Result indicator in the dev toolbar.
3

Export for debugging

Copy to clipboard or Download as JSON.
Result structure: 
{
  "callId": "660e8400-e29b-41d4-a716-446655440001",
  "status": "Completed",
  "agentId": "agent-abc123",
  "endpoint": "web",
  "duration": "00:02:15",
  "inspectorUrl": "https://inspector.blackbox.ai/..."
}
For detailed analysis, open the Call Inspector using the inspectorUrl.

​
Pre-deployment checklist

  • Voice sounds natural and professional
  • Pronunciation of brand terms is correct
  • Speed is comfortable (not rushed or slow)
  • Multi-turn conversations flow smoothly

​
Troubleshooting

Possible causes: Incomplete configuration, network issues, unsaved agentSolutions:
  1. Verify all required fields are completed (LLM config, TTS config, STT config)
  2. Check that API keys are valid and have necessary permissions
  3. Save the agent before attempting to test
  4. Clear browser cache and reload the page
Possible causes: Permission denied, wrong device selectedSolutions:
  1. Click the lock icon in the address bar → Allow microphone access
  2. Check system privacy settings
  3. Try a different browser (Chrome works best)
Possible causes: LLM configuration error, prompt issueSolutions:
  1. Verify the LLM API key is valid
  2. Check the model name is correct
  3. Test with a minimal prompt: “You are a helpful assistant.”

​
API testing

Schedule test calls programmatically for automation: 
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: "web",
    priority: 7,
    callDeadline: new Date(Date.now() + 600000).toISOString(),
    additionalData: {
      testSession: true,
      testScenario: "basic-greeting"
    }
  })
});

const call = await response.json();
console.log(`Test call scheduled: ${call.callId}`);

​
What’s next

Call Inspector

Analyze completed calls

Troubleshooting

Common issues and solutions