Webhooks & API REST

Automatisez et intégrez VOCALIS AI dans n'importe quel workflow via webhooks et API.

⚡ Event call.ended 📤 POST signature HMAC 🌐 Endpoint https://votre-app ✓ Action push DB / mail
{ "event": "call.ended", "call_id": "c_8f3a91", "duration_sec": 194, "outcome": "qualified", "lead": { "name": "Alice Martin", "phone": "+33 6 ●● ●●", "intent": "demo_request" }, "transcript_url": "https://api.vocalis.pro/calls/c_8f3a91/transcript", "timestamp": "2026-05-13T14:32:18Z" }
Payload type d'un event call.ended — signature HMAC-SHA256 dans l'en-tête

Webhooks disponibles

VOCALIS AI émet des webhooks pour cinq événements clés :

  • call.started — appel débuté (agent_id, contact, timestamp)
  • call.ended — appel terminé (payload complet : durée, transcription, résumé, émotions, score qualité)
  • lead.qualified — lead scoré > 70 (contact, score, next_action)
  • appointment.booked — RDV confirmé (contact, date, type, agent)
  • escalation.triggered — transfert vers humain (raison, score émotionnel, transcript partiel)

Chaque payload JSON est signé HMAC-SHA256 pour vérifier l'authenticité.

Configurer un webhook

Depuis Paramètres > Intégrations > Webhooks > Ajouter :

  1. Renseignez votre URL endpoint HTTPS (doit répondre HTTP 200 en moins de 5 secondes)
  2. Sélectionnez les événements à écouter
  3. Copiez le secret HMAC généré pour valider les signatures côté serveur
  4. Cliquez sur Envoyer un event test pour valider la réception

En cas d'échec, VOCALIS AI réessaie avec backoff exponentiel (3 tentatives sur 24h).

API REST

Base URL : https://api.vocalis.pro/v1/
Auth : header Authorization: Bearer {token}

Endpoints principaux :

  • GET /calls — liste des appels (filtres : date, agent, statut)
  • GET /calls/{id} — détail complet (transcription, émotions, résumé)
  • POST /campaigns — créer une campagne sortante
  • GET /leads — liste des leads avec filtres
  • PUT /leads/{id} — mettre à jour un lead

Rate limit : 100 requêtes/minute. Réponses paginées (max 100 items/page).

Exemples d'intégration

  • Make/Zapier — déclencher un scénario à chaque lead.qualified pour notifier le commercial assigné
  • Slack — notification #ventes à chaque RDV pris, #support à chaque escalade
  • Google Sheets — log automatique de tous les appels via webhook → Apps Script
curl -X GET "https://api.vocalis.pro/v1/calls?limit=10" \
  -H "Authorization: Bearer vp_live_xxxxxxxxxxxx" \
  -H "Accept: application/json"
← Précédent
Téléphonie
Suivant →
WhatsApp Business