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.

Veyra Docs TeamMis à jour le 1 min de lectureVersion 2 · Historique

Quand un agent prend des appels téléphoniques, le fournisseur vocal (Speko) communique avec Veyra par deux webhooks pendant chaque appel :

HTTP
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é.

EntrantsVoixWebhooks