Node.js

Configurez vos conditions préalables

Vous devez remplir quelques conditions préalables avant de pouvoir suivre ce tutoriel. Si vous avez déjà rempli l'une d'entre elles, n'hésitez pas à sauter cette étape.

Vous pouvez créer un compte Vonage via le site Web de Tableau de bord.

Dans le tableau de bord, vous pouvez créer des Applications et acheter des numéros Vonage. Vous pouvez également effectuer ces tâches à l'aide de la fonction CLI Vonage.

Suivez les étapes décrites sur la page Démarrer avec l'interface de programmation de Vonage pour installer et configurer la ligne de commande.

Il existe deux méthodes pour créer une application vocale :

  1. Utilisation de la CLI de Vonage
  2. Utilisation du tableau de bord

Chacune de ces méthodes est décrite dans les sections suivantes.

Comment créer une application vocale à l'aide du CLI de Vonage

Pour créer votre application à l'aide de la CLI de Vonage, entrez la commande suivante dans l'interpréteur de commandes en remplacement de NGROK_HOST_NAME avec l'hôte ngrok que vous avez obtenu lors de l'installation de ngrok :

Pour créer votre application à l'aide de l'outil CLI Vonage, entrez la commande suivante :

vonage apps create 'Your application'

✅ Creating Application
Saving private key ... Done!
Application created

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
  None Enabled

Ajoutez ensuite des fonctionnalités vocales à votre application (utilisez le nom d'hôte de ngrok à la place de example.com)

vonage apps capabilities update 00000000-0000-0000-0000-000000000000 voice `
  --voice-answer-url='https://example.com/webhooks/voice/answer' `
  --voice-event-url='https://example.com/webhooks/voice/event' `
  --voice-fallback-url='https://example.com/webhooks/voice/fallback'
  
✅ Fetching Application
✅ Adding voice capability to application 00000000-0000-0000-0000-000000000000

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
 VOICE:
    Uses Signed callbacks: On
    Conversation TTL: 41 hours
    Leg Persistence Time: 6 days
    Event URL: [POST] https://example.com/webhooks/voice/event
    Answer URL: [POST] https://example.com/webhooks/voice/answer
    Fallback URL: [POST] https://example.com/webhooks/voice/fallback

Cette commande crée une Application Vonage avec Voice capacité. Il
configure l'Application avec les URL de votre réponse et de votre webhook d'événement et génère un fichier de clé privée. private.key, que vous devez enregistrer dans le répertoire de votre projet.

La commande renvoie un ID d'application unique. Utilisez cet identifiant d'application pour lier votre numéro virtuel Vonage à votre application. Applications en exécutant ce qui suit :

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set

Cela permettra de lier ce numéro virtuel Vonage à votre application, ce qui fera que tous les événements vocaux se produisant pour ce numéro seront acheminés vers les URL que vous aurez désignées. seront acheminés vers les URL désignés.

Comment créer une application vocale à l'aide du tableau de bord

Vous pouvez créer des Applications vocales dans l'application Tableau de bord.

Pour créer votre application à l'aide du tableau de bord :

  1. Sous Applications dans le tableau de bord, cliquez sur le bouton Créer une nouvelle application bouton.

  2. Sous Nom, saisissez le nom de l'Applications. Choisissez un nom pour faciliter les références futures.

  3. Cliquez sur le bouton Générer une clé publique et une clé privée. Cela créera une paire de clés publique/privée et la clé privée sera téléchargée par votre navigateur. sera téléchargée par votre navigateur. Enregistrez la clé privée qui a été générée.

  4. Sous Capacités sélectionner le Voix bouton.

  5. Dans le cadre de la Réponse URL entrez l'URL de votre webhook d'appels entrants, par exemple, http://example.com/webhooks/answer.

  6. Dans le cadre de la URL de l'événement entrez l'URL de votre webhook d'état d'appel, par exemple, http://example.com/webhooks/events.

  7. Cliquez sur le bouton Générer une nouvelle application bouton.

  8. Vous passez à l'étape suivante de la procédure de création d'une application, où vous devez associer votre numéro Vonage à l'application. l'application.

Vous avez maintenant créé votre application.

NOTE : Avant de tester votre application, assurez-vous que vos webhooks sont configurés et que votre serveur webhook fonctionne.

Utilisation du tableau de bord

Vous pouvez tout d'abord consulter vos numéros existants.

Si vous n'avez pas de Numbers en réserve, vous pouvez en acheter un.

Utilisation de la CLI de Vonage

Une fois que vous avez trouvé un numéro qui vous convient, vous pouvez l'acheter à l'aide de la fonction vonage numbers buy commande :

vonage numbers buy US 16127779311 
✅ Searching for numbers
Are you sure you want to purchase the number 16127779311 for €0.90? [y/n] y

✅ Purchasing number
Number 16127779311 purchased

Number: 16127779311 
Country: 🇺🇸 United States
Type: Mobile
Features: MMS, SMS, VOICE
Monthly Cost: €0.90
Setup Cost: €0.00
Linked Application ID: Not linked to any application
Voice Callback: Not Set
Voice Callback Value: Not Set
Voice Status Callback: Not Set

Utilisation du tableau de bord

  1. Trouvez votre application dans la rubrique Tableau de bord.
  2. Cliquez sur la demande dans la liste "Vos demandes". Cliquez ensuite sur l'onglet Numbers.
  3. Cliquez sur le bouton Lier pour lier un numéro Vonage à cette application.

Utilisation de la CLI de Vonage

Une fois que vous avez un numéro approprié, vous pouvez le relier à votre application Vonage en exécutant la commande suivante

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set

Vous devez rendre votre webhook accessible aux API de Vonage sur l'Internet public. Une façon simple d'y parvenir pendant le développement sans avoir à installer votre propre serveur est d'utiliser la fonction Ngrok. Pour en savoir plus, lire notre documentation sur Ngrok.

Téléchargez et installez ngrok, puis exécutez la commande suivante pour exposer votre application sur le port 3000 à l'internet public :

./ngrok http 3000

Si vous êtes un abonné payant, vous pouvez taper :

./ngrok http 3000 -subdomain=your_domain

NOTE : Dans cet exemple, Ngrok va détourner les webhooks de Vonage que vous avez spécifiés lors de la création de votre application Vonage vers localhost:3000. Bien que le port 3000 soit indiqué ici, vous pouvez utiliser n'importe quel port libre qui vous convient.

Construire un menu d'appel

Créer un menu de réponse vocale interactive (RVI) pour traiter les appels des clients.

Disponible sur :
Node.js
Étapes
1
Introduction
2
Prerequisites
3
Ce que vous allez construire
4
Installer les dépendances
5
Créer le serveur
6
Créer le webhook de réponse
7
Créer le webhook DTMF
8
Créer le webhook de l'événement
9
Configurez votre application vocale
10
Exécutez-la !
11
Conclusion
12
Quelle est la prochaine étape ?