Comment passer un appel téléphonique sortant de type texte-parole avec Node.js

Introduction

L'API Voice API de Vonage de Vonage est le moyen le plus simple de créer des applications vocales de haute qualité dans le nuage. Avec l'API Voice, vous pouvez :

• 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 Nexmo Call Control Objects (NCCO) (Note : Nexmo est maintenant Vonage).

• Enregistrer et stocker les appels entrants ou sortants

• Créer des conférences téléphoniques

• Envoyez des messages vocaux dans 40 langues avec différents genres et accents.

• Et plus encore !

Dans ce tutoriel, vous apprendrez à utiliser en toute sécurité les API Voice de Vonage pour créer un appel téléphonique sortant avec synthèse vocale à l'aide de Node.js.

Le code source de l'application peut être trouvé ici.

Conditions préalables

Avant de commencer, assurez-vous que vous disposez des éléments suivants :

• Node.js installé. Node.js est un environnement d'exécution JavaScript open-source et multiplateforme.

• OPTIONNEL - CLI de Vonage Une fois que Node.js est installé, installez le CLI en tapant npm install -g @vonage/cli. Cet outil vous permet de créer et de gérer vos applications Vonage à partir d'une interface de ligne de commande vs le portail des développeurs Vonage.

Créer une application Voice-Enabled de Vonage

Pour utiliser l Voice API de Vonagede Vonage, vous devrez créer une Application Vonage à partir du portail des développeurs.

Vous avez besoin d'une application Vonage car elle contient les informations de sécurité et de configuration dont vous avez besoin pour interagir avec les API Voice Voice. Toutes les demandes adressées à l'API Voice de Vonage 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 et privées associées à l'application peuvent être créées via le portail des développeurs de Vonage ou par l'intermédiaire de la CLI de Vonage. Pour les besoins de ce tutoriel, nous utiliserons le tableau de bord du développeur de Vonage.

Le tableau de bord du développeur de Vonage

Après avoir créé un Account, ouvrez une session dans le tableau de bord du développeur de Vonage. section Applicationset créez une nouvelle application. Donnez un nom à votre application, par exemple AppelSortantet appuyez sur Générer les clés publique et privée. Vous serez invité à télécharger votre clé privée et à remplir la clé publique pour vous. Conservez ces informations en lieu sûr, car toute personne y ayant accès peut utiliser votre Account !

OutboundCall.png

Faites défiler la page et assurez-vous que l'option Voice est activée et que vous pouvez laisser le bouton Réponse, Événementet URL de repli vide.

VoiceCapability.png

Appuyer sur Générer une nouvelle application pour continuer. Vous pouvez également associer un numéro si vous le souhaitez, mais cela ne sera pas nécessaire pour ce tutoriel.

Configuration du projet Node.js

Maintenant que nous avons créé notre application Vonage Voice dans le tableau de bord du développeur et généré notre paire de clés publique/privée, voyons comment configurer notre application Node.js.

Commencez par accéder à une invite de commande/terminal, créez un répertoire de travail, puis initialisez un projet Node.js.

Nous devons également installer le SDK Node Vonage Server.

Créez un fichier index.js et initialiser le SDK Vonage et les informations d'identification avec le code suivant :

const {
    Vonage
} = require('@vonage/server-sdk');
const credentials = {
    applicationId: 'VONAGE_APPLICATION_ID',
    privateKey: "./private.key",
};
const options = {};
const vonage = new Vonage(credentials);

Remplacer le champ VONAGE_APPLICATION_ID par l ID de l'application fourni pour l'application Vonage que vous avez créée dans le tableau de bord du développeur. Veillez à ce que le champ clé privée contient le chemin d'accès à la clé privée téléchargée précédemment. Remarque : j'ai copié mon fichier private.key à la racine de mon application et je peux y accéder en spécifiant que le privateKey est égal à ./private.key.

Pour appeler un numéro avec la Voice API, nous utiliserons la fonction vonage.voice.createOutboundCall de la bibliothèque Node.js de Vonage. Cette méthode accepte des objets comme paramètres, avec des informations sur le destinataire, l'expéditeur et le texte à prononcer.

Pour l'API Voice, nous devrons spécifier un destinataire, un expéditeur et l'option NCCO que nous voulons envoyer.

Enfin, l'objet content accepte un type de texte et un message textuel. Le callback renvoie un objet error et response, et nous enregistrons les messages relatifs au succès ou à l'échec de l'opération.

vonage.voice.createOutboundCall({
		to: [{
			type: 'phone',
			number: YOUR_NUMBER
		}],
		from: {
			type: 'phone',
			number: VONAGE_VIRTUAL_NUMBER
		},
		ncco: [{
			"action": "talk",
			"text": "You are listening to a test text-to-speech call made with the Vonage Voice API",
		}]
	})
	.then(resp => console.log(resp))
	.catch(err => console.error(err));

Remplacer VOTRE_NUMBER par un téléphone auquel vous pouvez répondre immédiatement. Le numéro NUMÉRO_VIRTUEL_VONAGE doit être votre numéro virtuel, que vous trouverez dans votre tableau de bord. Vous pouvez personnaliser l'objet NCCO avec paramètres optionnels avec différentes voix selon la langue, le sexe et même l'accent.

Veuillez noter que nous pourrions héberger l'objet NCCO sur GitHub, par exemple, en déclarant un fichier ANSWER_URL avec ce qui suit et en supprimant l'élément ncco avec un answer_url comme indiqué ci-dessous :

const ANSWER_URL = 'https://raw.githubusercontent.com/nexmo-community/ncco-examples/gh-pages/text-to-speech.json'

...

answer_url: [ANSWER_URL]

Exécuter l'application

Saisissez les informations suivantes à l'invite de votre commande/terminal pour lancer l'application :

node index.js

Votre téléphone devrait sonner, vous entendrez une voix lire le texte que nous avons spécifié, et l'appel sera terminé. Veuillez noter que vous pouvez observer un certain temps de latence en fonction de l'opérateur téléphonique auquel vous vous connectez.

Synthèse

Maintenant que vous avez appris à créer un appel sortant avec l'API Voice de Vonage et Node.js, vous pouvez écouter l'audio dans différentes langues ou accents ou personnaliser le texte parlé pour trouver celui qui convient le mieux à votre entreprise.

Si vous avez des questions ou des commentaires, rejoignez-nous sur le Slack des développeurs de Vonage ou envoyez-moi un Tweet sur Twitteret je vous répondrai. Merci encore d'avoir lu, et je vous donne rendez-vous au prochain numéro !