Détails techniques

Introduction

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.

Rapports

L'API Reports constitue un moyen centralisé d'extraire les données d'utilisation et de reporting pour l'ensemble des produits Vonage. Elle offre ainsi aux développeurs et aux entreprises un moyen cohérent de suivre l'activité, la facturation et les détails des transactions, y compris les enregistrements d'appels et les numéros de téléphone. Elle simplifie la création de rapports en regroupant les données d'utilisation et de facturation provenant de plusieurs API Vonage dans un format unique et cohérent. Vous pouvez utiliser la Reports API dans un large éventail de cas d'utilisation, notamment :

  • Facturation des clients - Téléchargez les transactions liées à tous vos sous-comptes et utilisez les données de prix incluses pour déterminer ce que vous devez facturer à vos clients.
  • Rapprochement des factures - Comparez vos données d'utilisation avec la facture que vous avez reçue.
  • Surveillance et analyse - Ajoutez des données CDR en temps réel à votre système de veille stratégique ou d'analyse pour les mettre en corrélation avec d'autres événements.
  • Gestion des campagnes - Suivez les performances de votre campagne grâce à des outils en libre-service.
  • Débogage - Résoudre les problèmes en explorant jusqu'à 13 mois de données d'utilisation détaillées.

Voir le Documentation sur les Reports API pour plus d'informations, notamment des guides, des extraits de code, des bonnes pratiques et les tarifs.

Pour en savoir plus