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.

Point Dasha BlackBox at your endpoint, add authentication headers, and receive HTTP POST requests for call events. What you’ll learn: Dashboard and API configuration, URL requirements.

​
Quick setup

1

Navigate to webhooks

Agent → Settings → Webhooks
2

Enter URL

Must be HTTPS and publicly accessible
3

Add headers

Bearer tokens, API keys for authentication
4

Test

Use the test button to verify HTTP 200 response

​
URL requirements

  • HTTPS recommended — Use HTTPS for security
  • Publicly accessible — No localhost or private IPs
  • Response under 10 seconds — Use async processing
For local development, use ngrok: 
ngrok http 3000
# Use https://xxx.ngrok.io/webhook

​
Response requirements

StatusMeaningRetry?
2xxSuccessNo
4xxClient errorNo
5xxServer errorYes
TimeoutNo responseYes
Best practice: Respond immediately, process asynchronously.

​
Checklist

  • URL publicly accessible
  • Response time under 10 seconds
  • Idempotency handling implemented

​
What’s next

Webhook Events

Event types and payloads

Testing Webhooks

Comprehensive testing guide