Détails techniques

L'API Voice de Vonage permet aux développeurs de gérer par programmation les appels vocaux en utilisant deux modèles complémentaires :

  • L'un d'entre eux est initiée par votre applicationà l'aide d'appels d'API REST ou de SDK.
  • L'autre est demandée à votre application par Vonage, en utilisant webhooks et BCN (Objet de contrôle d'appel Nexmo - Nexmo est maintenant Vonage) instructions.

Cette double approche permet un traitement flexible des appels afin de mettre en œuvre divers flux d'appels et cas d'utilisation vocaux programmables, allant de simples notifications à des flux de centre de contact sophistiqués et à l'intégration de l'IA.

De plus, l'API Voice de Vonage permet de :

  • Créez des applications qui s'adaptent aux technologies web que vous utilisez déjà.
  • Contrôlez le flux des appels entrants et sortants en JSON avec NCCO.
  • Enregistrer et stocker les appels entrants ou sortants.
  • Créer des conférences téléphoniques.
  • Envoyez des messages en synthèse vocale dans 40 langues avec différents genres et accents.

Contenu

Dans ce document, vous trouverez des informations sur

Pour commencer

Pour connaître toutes les étapes nécessaires à la mise en œuvre de l'API Voice de Vonage, veuillez vous référer à la section Pour commencer guide.

Lancer un appel vocal

Pour lancer un appel vocal à partir de votre application dorsale, utilisez le point de terminaison HTTP :

POST /calls

Cette méthode permet d'initier un appel sortant vers un numéro de téléphone ou un point d'extrémité SIP. Vous pouvez l'utiliser directement via HTTP ou par l'intermédiaire de n'importe quelle méthode de type SDK du serveur Vonage.

Voir le Passer un appel pour en savoir plus sur le lancement d'appels sortants.

Lorsque l'appel est connecté, Vonage demande des instructions (sous la forme d'un NCCO) à votre webhook ou à votre URL statique pour déterminer comment l'appel doit se dérouler.

Instructions d'appel avec les NCCO

Un BCN (Nexmo Call Control Object) est une structure basée sur JSON qui définit ce qui doit se passer pendant un appel. Vous la renvoyez en réponse à la demande de webhook de Vonage lorsque l'appel est connecté.

Les actions courantes du NCCO sont les suivantes :

  • talk - Convertir le texte en parole et le faire écouter à l'appelant
  • stream - Lire un fichier audio
  • record - Enregistrer le son de l'appel
  • connect - Connecter un autre participant à la conversation

Vous pouvez trouver la liste complète des commandes du NCCO dans la rubrique Référence NCCO.

Contrôle d'un appel actif

Une fois qu'un appel est en cours, vous pouvez également le contrôler dynamiquement à l'aide des points d'extrémité de l'API REST :

  • PUT /calls/{uuid} - Mise à jour de l'état de l'appel (par exemple, raccrocher, transférer, mettre en sourdine)
  • PUT /talk et DELETE /talk - Démarrer ou arrêter la synthèse vocale pendant l'appel
  • PUT /talk et DELETE /stream - Démarrer ou arrêter la diffusion d'un fichier audio

Ces actions vous permettent de modifier le comportement de l'appel en temps réel, en fonction des actions de l'utilisateur et de votre logique d'application.

Voir le Référence de l'API Voice pour une liste complète des points d'extrémité de l'API REST.

Pour en savoir plus