Webhooks

{
  "event": "call.started",
  "callId": "call_abc123",
  "agentId": "g4d3cXIpDr",
  "to": "+44207123456",
  "from": "+44207654321",
  "startedAt": "2026-04-02T10:00:00Z"
}

{
  "event": "call.ended",
  "callId": "call_abc123",
  "agentId": "g4d3cXIpDr",
  "outcome": "user_hangup",
  "durationSec": 120,
  "cost": 0.15,
  "transcript": [
    { "speaker": "agent", "text": "Hello, how can I help?", "timestamp": 0 },
    { "speaker": "user", "text": "I need to cancel my booking.", "timestamp": 2.5 }
  ],
  "analysis": {
    "callSummary": "Customer called to cancel their booking...",
    "userSentiment": "neutral",
    "callSuccessful": true
  }
}

{
  "event": "call.transferred",
  "callId": "call_abc123",
  "transferTo": "+44207999999",
  "transferStatus": "answered"
}

const crypto = require('crypto');

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