Créer un serveur webhook
Lorsqu'un appel entrant est reçu, Vonage fait une demande à une URL accessible au public de votre choix - que nous appelons le answer_url. Vous devez créer un serveur webhook capable de recevoir cette requête et de renvoyer un BCN contenant un connect qui transmettra l'appel au de l'utilisateur app. Pour ce tutoriel, l'utilisateur de destination est codé en dur comme étant Alice.
Nouveau projet
Créez un nouveau répertoire de projet dans une destination de votre choix et changez de répertoire :
À l'intérieur du dossier, initialisez un nouveau projet Node.js en exécutant cette commande :
Ajouter des dépendances
Ensuite, installez les dépendances nécessaires :
Créer le fichier du serveur
Dans le dossier de votre projet, créez un fichier nommé server.js et ajoutez le code comme indiqué ci-dessous - veillez à remplacer SUBDOMAIN avec une valeur réelle. La valeur utilisée fera partie des URL que vous définirez en tant que webhooks à l'étape suivante.
NOTE : N'oubliez pas de remplacer SUBDOMAIN avec une chaîne aléatoire de votre choix entre 4 et 20 caractères alphanumériques (lettres minuscules et chiffres, pas de soulignement ni de tiret).
Le code du serveur ci-dessus comporte deux parties :
Le serveur Express
La première partie crée un Express et le rend disponible localement sur le port 3000. Le serveur propose deux chemins d'accès :
/voice/answerest leanswer_urlque nous avons mentionnée plus haut. Il renvoie un NCCO en tant queJSONcontenant les informations nécessaires pour se connecter à un utilisateur de l'application.Le deuxième,
/voice/eventVous définissez la destination pour que Vonage vous informe de tout ce qui se passe pendant l'appel.event_url.
Les localtunnel l'intégration
La deuxième partie du code du serveur ci-dessus expose la fonction Express afin qu'il soit accessible par les serveurs de Vonage.
NOTE : localtunnel est une bibliothèque JavaScript qui expose votre localhost au monde entier pour des tests et un partage sans douleur ! Pas besoin de manipuler les DNS ou de déployer pour que d'autres personnes testent vos changements.
Démarrer le serveur
Vous pouvez maintenant démarrer le serveur en exécutant, dans le terminal, la commande suivante :
Un avis s'affiche pour vous indiquer que le serveur est désormais disponible :
Gardez la fenêtre du terminal à portée de main, car vous aurez besoin de l'URL à l'étape suivante.
Recevoir un appel téléphonique in-app
Vous recevez un appel d'un téléphone vers votre application