VoiceInfra Webhooks Reference — Payload and Signatures

{
  "call_id": "call_01HXYZ123456",
  "event": "call.completed",
  "from_number": "+14155550100",
  "to_number": "+18005551234",
  "agent_id": "agent_abc123",
  "duration_seconds": 147,
  "start_time": "2025-01-15T14:23:00Z",
  "end_time": "2025-01-15T14:25:27Z",
  "call_outcome": "answered",
  "recording_url": "https://recordings.voiceinfra.ai/call_01HXYZ123456.mp3",
  "transcript": "Agent: Hi Sarah, this is calling to confirm your appointment...\nCaller: Yes, that works for me.",
  "summary": "Customer confirmed appointment for January 15 at 2pm. No changes requested.",
  "extracted_data": {
    "appointment_confirmed": true,
    "customer_name": "Sarah Chen"
  }
}

import hmac
import hashlib

def verify_voiceinfra_webhook(payload: bytes, signature: str, secret: str) -> bool:
    """Verify the HMAC-SHA256 signature of a VoiceInfra webhook."""
    expected_sig = hmac.new(
        secret.encode('utf-8'),
        payload,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected_sig, signature)

# Flask example:
# @app.route('/webhook', methods=['POST'])
# def handle_webhook():
#     signature = request.headers.get('X-VoiceInfra-Signature', '')
#     if not verify_voiceinfra_webhook(request.data, signature, WEBHOOK_SECRET):
#         return '', 401
#     payload = request.get_json()
#     # process payload
#     return '', 200

const crypto = require('crypto');

function verifyVoiceInfraWebhook(payload, signature, secret) {
  const expectedSig = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expectedSig),
    Buffer.from(signature)
  );
}

// Express example:
// app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
//   const sig = req.headers['x-voiceinfra-signature'];
//   if (!verifyVoiceInfraWebhook(req.body, sig, process.env.WEBHOOK_SECRET)) {
//     return res.status(401).send('Invalid signature');
//   }
//   const payload = JSON.parse(req.body);
//   res.status(200).send('OK');
// });