Anruf-Ereignisse (Webhook)

SendApp kann dein System benachrichtigen, wenn ein Anruf beginnt, endet, an eine Person übergeben wird oder der Anrufer um Rückruf bittet. Einschalten unter Agenda → Webhook: Adresse wählen und die Voice-AI-Ereignisse ankreuzen. Jedes Ereignis kommt als signierte POST-Anfrage, wie die Buchungsereignisse.

Voice-AI-Ereignisse kommen nur, wenn du sie angekreuzt hast: ein früher angelegter Webhook oder einer ohne gewählte Ereignisse erhält weiterhin nur Buchungen.

Der Body ist {event, occurred_at, account_ref, call, delivery_id}: call hat dieselben Felder wie GET /api/voice/calls/{call_id}, ohne Transkript. account_ref kennzeichnet das Konto und ist kein Schlüssel: der Body enthält nie deinen API-Schlüssel.

voice.call.ended ist eine Momentaufnahme des Anrufs bei seinem Ende: KI-Zusammenfassung und Kategorie kommen später, lies sie also über GET /api/voice/calls/{call_id}. Der Rückrufstatus kommt mit voice.callback.requested. Jedes Ereignis wird pro Anruf nur einmal gesendet.

Prüfe die Signatur: der Header X-SendApp-Signature lautet t=<timestamp>,v1=<HMAC-SHA256 von "timestamp.body"> mit dem geheimen Schlüssel des Webhooks. Antworte mit einem 2xx-Code: sonst versuchen wir es nach 1, 5 und 30 Minuten erneut.

Parameter

4 · 0 Pflichtfelder

voice.call.started optional

Ein Anruf hat begonnen.

voice.call.ended optional

Ein Anruf ist beendet: mit Ergebnis, Dauer und Zusammenfassung.

voice.call.escalated optional

Die KI hat den Anruf an eine Person übergeben.

voice.callback.requested optional

Der Anrufer bittet um Rückruf.

Brauchen Sie Hilfe bei der Integration? info@sendapp.live

Anfrage

# Beispiel für ein Ereignis, das dein Server erhält
POST /hooks/sendapp HTTP/1.1
Content-Type: application/json
X-SendApp-Event: voice.call.ended
X-SendApp-Delivery: 5d0c2a4e-7b1f-4c3a-9e2d-8f6a1b2c3d4e
X-SendApp-Signature: t=1793870101,v1=6f1d0c…

<?php
// Signatur prüfen
$body = file_get_contents('php://input');
$secret = 'whsec_...';
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_SENDAPP_SIGNATURE'] ?? ''), $sig);
$ok = isset($sig['t'], $sig['v1'])
    && abs(time() - (int) $sig['t']) < 300
    && hash_equals(hash_hmac('sha256', $sig['t'] . '.' . $body, $secret), $sig['v1']);
if (!$ok) { http_response_code(400); exit; }
$event = json_decode($body, true);
http_response_code(200);

// Signatur prüfen (Node.js, Express)
const crypto = require('crypto');
app.post('/hooks/sendapp', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = Object.fromEntries(String(req.get('X-SendApp-Signature')).split(',').map(p => p.split('=')));
  const expected = crypto.createHmac('sha256', process.env.SENDAPP_SECRET)
    .update(sig.t + '.' + req.body).digest('hex');
  const a = Buffer.from(expected), b = Buffer.from(String(sig.v1 || ''));
  if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) return res.sendStatus(400);
  const event = JSON.parse(req.body);
  res.sendStatus(200);
});

Antwort

{
  "event": "voice.call.ended",
  "occurred_at": "2026-11-05T09:15:01Z",
  "account_ref": "acct_9f3c2a7e5b1d4c6f",
  "call": {
    "call_id": "1789749582.1320",
    "direction": "in",
    "status": "answered",
    "from_number": "+393331234567",
    "to_number": "+390212345678",
    "assistant_id": "YOUR_ACCOUNT_TOKEN",
    "ai_handled": true,
    "ai_escalated": false,
    "started_at": "2026-11-05T09:12:04Z",
    "answered_at": "2026-11-05T09:12:06Z",
    "ended_at": "2026-11-05T09:15:01Z",
    "wait_seconds": 2,
    "talk_seconds": 175,
    "end_reason": "completed",
    "disposition": null,
    "disposition_note": null,
    "ai_summary": null,
    "summary": null,
    "category": null,
    "sentiment": null,
    "callback_status": null,
    "callback_at": null,
    "conversation_id": "9b2f4c1e-8a5d-4f7b-9c3e-1d2a3b4c5d6e",
    "has_voicemail": false,
    "voicemail_seconds": null,
    "recording_available": true,
    "recording_seconds": 173,
    "recording_expires_at": "2026-12-05T09:15:01Z"
  },
  "delivery_id": "5d0c2a4e-7b1f-4c3a-9e2d-8f6a1b2c3d4e"
}