Webhooks & API

Événements temps-réel, REST API, authentification, exemples cURL.

Événements temps-réel

Les webhooks VOCALIS envoient un POST HTTPS à votre endpoint dès qu’un événement se produit. Vous branchez n’importe quel système : CRM, data lake, Slack, workflow no-code (Make, n8n, Zapier).

Événements disponibles

Exemple de payload

POST https://votre-endpoint.com/hooks/vocalis
Content-Type: application/json
X-Vocalis-Signature: sha256=... { "event": "call.ended", "call_id": "c_01HXYZ", "agent_id": "a_42", "duration_sec": 184, "result": "appointment_booked", "language": "fr-FR", "emotion_summary": {"satisfaction": 0.71, "anger": 0.02}, "transcript_url": "https://app.vocalis.pro/tr/c_01HXYZ.json"
}

Signature HMAC

Chaque webhook est signé en HMAC-SHA256 avec votre secret. Exemple en Python :

import hmac, hashlib def verify(body: bytes, signature: str, secret: str) -> bool: expected = "sha256=" + hmac.new(secret.encode(), body, hashlib.sha256).hexdigest() return hmac.compare_digest(expected, signature)

REST API — exemple cURL

curl -X POST https://api.vocalis.pro/v1/calls \ -H "Authorization: Bearer $VOCALIS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"agent_id":"a_42","to":"+33612345678","variables":{"prenom":"Paul"}}'

Limites & retries

• Timeout : 10 s côté VOCALIS.
• Retries exponentiels : 5 tentatives sur 24 h en cas d’échec.
• Rate-limit par défaut : 60 requêtes/seconde par organisation.