Événements des appels (webhook)

SendApp peut prévenir votre système quand un appel commence, se termine, passe à une personne ou quand l'appelant demande à être rappelé. Cela s'active dans Agenda → Webhook : choisissez l'adresse et cochez les événements de la Voice AI. Chaque événement arrive par une requête POST signée, comme les événements des réservations.

Les événements de la Voice AI n'arrivent que si vous les avez cochés : un webhook créé avant, ou sans événements choisis, continue de recevoir seulement les réservations.

Le corps est {event, occurred_at, account_ref, call, delivery_id} : call a les mêmes champs que GET /api/voice/calls/{call_id}, sans transcription. account_ref identifie le compte et n'est pas une clé : le corps ne contient jamais votre clé API.

voice.call.ended est la photo de l'appel au moment où il se termine : le résumé de l'IA et la catégorie arrivent plus tard, lisez-les donc dans GET /api/voice/calls/{call_id}. L'état du rappel arrive avec voice.callback.requested. Chaque événement n'est envoyé qu'une fois par appel.

Vérifiez la signature : l'en-tête X-SendApp-Signature vaut t=<timestamp>,v1=<HMAC-SHA256 de "timestamp.corps"> avec la clé secrète du webhook. Répondez avec un code 2xx : sinon nous réessayons après 1, 5 et 30 minutes.

Paramètres

4 · 0 obligatoires

voice.call.started facultatif

Un appel a commencé.

voice.call.ended facultatif

Un appel est terminé : avec issue, durée et résumé.

voice.call.escalated facultatif

L'IA a passé l'appel à une personne.

voice.callback.requested facultatif

L'appelant demande à être rappelé.

Besoin d'aide pour l'intégration ? info@sendapp.live

Requête

# Exemple d'événement reçu par votre serveur
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
// Vérifiez la signature
$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);

// Vérifiez la signature (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);
});

Réponse

{
  "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"
}