Webhooks vocaux
Les événements d'appel et les demandes d'outils envoyés par le fournisseur vocal pendant un appel téléphonique avec un agent, leur vérification et leurs limites.
Quand un agent prend des appels téléphoniques, le fournisseur vocal (Speko) communique avec Veyra par deux webhooks pendant chaque appel :
POST https://intelligence-api.veyra.so/api/voice-webhooks/{publicId}/events
POST https://intelligence-api.veyra.so/api/voice-webhooks/{publicId}/tools- events signale le cycle de vie de l'appel : commencé, décroché, terminé.
- tools transporte les demandes que la session vocale adresse aux outils de l'agent pendant l'appel.
Vérification
Chaque rappel est vérifié sur ses octets d'origine avec la signature du fournisseur et une autorisation propre à la session. Rien ne contourne ce contrôle, pas même une personne connectée.
Réponses et limites
| Statut | Signification |
|---|---|
200 |
Traité ; le corps JSON est la réponse destinée au fournisseur. |
400 |
Le rappel est mal formé. |
401 |
La signature est invalide. |
403 |
Les connexions vocales sont désactivées. |
413 |
Le corps du rappel est trop volumineux. |
429 |
Plus de 600 rappels par minute depuis une même adresse. |
Les réponses ne sont jamais mises en cache (Cache-Control: no-store).
Appels et tâches
Un appel est lié à une tâche : sa transcription et son issue restent avec le travail. Les appelants qui ne sont pas des membres vérifiés n'accèdent qu'à l'accueil invité restreint que vous avez configuré ; le travail privé exige un appelant authentifié.
La configuration vocale se gère depuis la console. Les endpoints sous-jacents ne fonctionnent que dans une session de console connectée ; ils ne font donc pas partie de la référence de l'API par clé.