API Voice de Vonage avec ASP.NET : Avant de commencer

Cet article fait partie d'une série sur l'utilisation de l'API Voice Voice de Vonage dans les projets ASP.NET. Il s'agit de la suite de la série " Getting Started with Vonage and ASP.NET ", qui fait suite à notre série " Getting Started " sur les API SMS. série "Getting Started" sur les API SMS.

Dans ce tutoriel, nous allons mettre en place un projet ASP.NET dans Visual Studio qui possède toute la configuration nécessaire pour se connecter à l'API Voice de Vonage. Cela permet d'ajouter des capacités d'appel téléphonique à une application ASP.NET. Les prochains articles de blog montreront comment intégrer l'API Voice dans votre application ; ce tutoriel vous montrera comment commencer.

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

This tutorial also uses a virtual phone number. To purchase one, go to Numbers > Buy Numbers and search for one that meets your needs.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Configuration d'une application Vonage

Pour pouvoir utiliser l'API Voice de Vonagede Vonage, vous devrez utiliser une Application Vonage. Une application Vonage contient les informations de sécurité et de configuration dont vous avez besoin pour interagir avec l'API REST Voice de Vonage et utiliser facilement l'API Voice.

Toutes les demandes adressées à l'API Voice nécessitent une authentification. Vous devez générer une clé privée avec l'API d'application, ce qui vous permet de créer des jetons Web JSON (JWT) pour effectuer les demandes. Les clés publiques/privées associées à une application peuvent être créées de deux manières.

Le tableau de bord de l'application Vonage

Si vous allez sur votre tableau de bord Vonage, dans la section Applicationsvous pouvez créer une nouvelle application.

Remplissez les champs requis, puis cliquez sur "Generate public/private key pair". Vous serez alors invité à télécharger votre clé privée. (conservez-la précieusement !) et de générer la clé publique pour vous.

Vous pouvez en savoir plus sur notre tableau de bord d'application et comment il facilite la gestion des applications Vonage Voice dans notre article de blog..

Le CLI de Vonage

Tout d'abord, installons l'interface de commande de Vonage à partir de npm

npm install @vonage/cli -g

puis configurez-le avec votre clé et votre secret API Vonage.

vonage config:set --apiKey=API_KEY --apiSecret=API_SECRET

Maintenant que la configuration est terminée, l'étape suivante consiste à créer l'Application Voice à l'aide de la commande app:create.

Avec les deux options, vous devez enregistrer un nom d'application, par exemple "Ma première application vocale", et deux points de terminaison webhook pour spécifier les URL de réponse et d'événement. La commande app:create vous guidera dans cette démarche.

vonage apps:create 

√ Application Name ... My first voice app
√ Select App Capabilities » Voice
√ Create voice webhooks? ... yes
√ Answer Webhook - URL ... http://example.com/webhook_name/answer
√ Answer Webhook - Method » POST
√ Event Webhook - URL ... http://example.com/webhook_name/event
√ Event Webhook - Method » POST
√ Allow use of data for AI training? Read data collection disclosure - https://help.nexmo.com/hc/en-us/articles/4401914566036 ... no
Creating Application... done

Lorsque l'application est créée avec succès, le CLI renvoie l'identifiant de l'application et la clé privée, qui sont tous deux nécessaires pour interagir avec l'API Voice de Vonage. Ces informations sont également stockées dans deux fichiers situés dans votre répertoire d'utilisateur, ex. c:\users\bob\ et sont vonage_app.json et <app_name>.key

Configuration du projet ASP.NET

Maintenant que nous avons généré notre paire de clés publiques/privées et notre application Vonage, voyons comment configurer notre projet ASP.NET. Vous avez peut-être remarqué qu'il existe désormais plus d'une plateforme ASP.Net : ASP.Net est conçu spécifiquement pour Windows, tandis qu'ASP.Net Core est le nouveau cadre ouvert et multiplateforme.

Nous essaierons de couvrir les deux lorsqu'il y a une différence dans le code, sinon nous utiliserons l'un ou l'autre en mettant l'accent sur ASP.Net Core car c'est la voie à suivre.

Configuration d'un projet Web ASP.Net

Tout d'abord, ouvrez Visual Studio et créez une nouvelle application Web ASP.NET Web Application (.NET Framework) .

Sélectionnez le Modèle MVC et assurez-vous que le type d'authentification est défini sur Pas d'authentification. Cliquez sur OK POUR CRÉER LE PROJET. pour créer le projet.

Mise en place d'un projet ASP.Net Core & .Net 5 et plus

Dans Visual Studio, créez un nouveau projet et choisissez l'application web ASP.NET Core.

Sélectionnez ensuite le modèle Application Web.

Installation du SDK .Net de Vonage

Que vous optiez pour un projet ASP.Net Web ou Core, les étapes suivantes sont les mêmes.

Installez le SDK .Net de Vonage via la console du gestionnaire de paquets NuGet.

Install-Package Vonage

Ajoutez un fichier JSON (appsettings.json) à votre projet. A l'intérieur duquel vous ajouterez vos identifiants Vonage.

{
  "appSettings": {
    "Vonage_key": "VONAGE-API-KEY",
    "Vonage_secret": "VONAGE-API-SECRET",
    "VONAGE_FROM_NUMBER": "VONAGE-VIRTUAL-NUMBER"
  }
}

Vous êtes maintenant prêt à vous plonger dans le code. Voyons comment vous pouvez passer un appel téléphonique avec synthèse vocale dans votre projet ASP.NET grâce à l'API Voice.

En savoir plus sur les API de Vonage et ASP.NET

Cet article n'était qu'une introduction rapide à la création de votre première application Vonage avec ASP.NET. Vous êtes maintenant prêt à plonger dans le code et à apprendre Comment passer un appel téléphonique de type texte-parole en ASP.NET avec l'API Voice de Vonage

Pourquoi ne pas essayer également d'envoyer un SMS avec ASP.NET MVC? Ou apprendre à recevoir des SMS avec ASP.NET MVC? Les deux articles sont sur notre blog des développeurs. Vous pourriez également être intéressé par notre SDK .NET open source qui est disponible sur Github.