Skip to main content
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:

​
Response requirements

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