> ## Documentation Index
> Fetch the complete documentation index at: https://blackbox.dasha.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive Event Notifications with Webhooks

> Learn how webhooks notify your server when things happen in Dasha BlackBox — call started, call ended, tool execution, and more.

Configure an endpoint, and Dasha BlackBox sends HTTP POST requests whenever calls start, end, fail, or need tool execution. Your server processes these events to update CRM systems, trigger workflows, or customize agent behavior.

***

## Webhook types

| Webhook      | When it fires        | What you get                      |
| ------------ | -------------------- | --------------------------------- |
| **Start**    | Conversation begins  | Caller info, agent config         |
| **Result**   | Conversation ends    | Full transcript, duration, status |
| **Tool**     | Agent invokes a tool | Tool name, parameters             |
| **Failed**   | Call fails           | Error details                     |
| **Deadline** | Call times out       | Timeout info                      |

***

## Result webhook

When a call ends, your server receives the full conversation data.

<Accordion title="Example: Result webhook payload">
  ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "type": "CompletedWebHookPayload",
    "status": "Completed",
    "callId": "call_abc123",
    "agentId": "agent_xyz789",
    "durationSeconds": 127,
    "transcription": [
      { "speaker": "assistant", "text": "Hi, how can I help you today?" },
      { "speaker": "user", "text": "I need to check on my order" }
    ],
    "result": {
      "finishReason": "user_hangup",
      "postCallAnalysis": {}
    },
    "inspectorUrl": "https://blackbox.dasha.ai/calls/call_abc123"
  }
  ```
</Accordion>

***

## Common patterns

**Log to CRM** — Send transcript to Salesforce, HubSpot after every call.

**Dynamic configuration** — Use start webhook to customize agent behavior per-caller (load customer history, set special instructions).

**Alerting** — Notify Slack when calls fail or contain certain keywords.

**Analytics** — Pipe results to your data warehouse for custom reporting.

***

## What's next

<CardGroup cols={2}>
  <Card title="Webhooks Overview" icon="webhook" href="/docs/webhooks-and-events/webhooks-overview">
    Complete webhooks guide
  </Card>

  <Card title="Tools" icon="wrench" href="/docs/introduction/tools">
    Let your agent take actions
  </Card>

  <Card title="Post-Call Analysis" icon="chart-bar" href="/docs/advanced-features/post-call-analysis">
    Extract insights from conversations
  </Card>

  <Card title="WebSockets" icon="plug" href="/docs/websockets/websockets-overview">
    Real-time bidirectional communication
  </Card>
</CardGroup>