Overview

Webhooks allow you to receive real-time HTTP notifications when events occur in your KrosAI account.

Setup

1

Go to the Webhooks page

Go to Developers → Webhooks in the Dashboard.

2

Create a webhook

Click Create Webhook.

3

Enter your endpoint

Enter your endpoint URL.

4

Select events

Select events to subscribe to.

5

Save and copy secret

Save and copy the signing secret.

Available Events

Event	Description
call.started	Call connected
call.ended	Call ended
call.failed	Call failed to connect
call.recording.completed	Recording available
transcription.completed	Transcript ready

Payload Structure

{
  "id": "evt_abc123",
  "event": "call.ended",
  "timestamp": "2025-01-12T10:30:00Z",
  "data": {
    "call_id": "call_xyz789",
    "from_number": "[phone]",
    "to_number": "[phone]",
    "direction": "outbound",
    "duration": 180,
    "cost_cents": 12,
    "status": "completed"
  }
}

Signature Verification

Verify the X-Webhook-Signature header:

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload, 'utf8')
    .digest('hex');
  return `sha256=${expected}` === signature;
}

Retry Policy

Attempt	Delay
1	Immediate
2	1 minute
3	5 minutes
4	30 minutes
5	2 hours