Node.js

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.