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

Insert call data (optional)

Click { } in the URL or a header value to insert a variable such as {{callAdditionalData.orderId}}
5

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:

​
Use call data in the request

The webhook URL and header values accept variables. Dasha BlackBox replaces them with values from the call before it sends the request: Open Advanced request settings to change the HTTP method, add query parameters or change the request body. A webhook without variables or advanced settings is sent exactly as before.

Request Templating

All variables, rendering rules, advanced settings and API reference

​
Response requirements

Best practice: Respond immediately, process asynchronously.

​
Checklist

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

​
What’s next

Request Templating

Call data in URLs, headers and bodies

Webhook Events

Event types and payloads

Testing Webhooks

Comprehensive testing guide