Kotlin

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 Numéro de téléphone RTCP. Pour ce faire, vous devez extraire le numéro de destination de la rubrique to et de le renvoyer dans votre réponse.

Nouveau projet

Créez un nouveau répertoire de projet dans une destination de votre choix et changez de répertoire :

mkdir vonage-tutorial cd vonage-tutorial

À l'intérieur du dossier, initialisez un nouveau projet Node.js en exécutant cette commande :

npm init -y

Ajouter des dépendances

Ensuite, installez les dépendances nécessaires :

npm install express localtunnel --save

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 NUMBER avec votre numéro Vonage (en E.164 ), ainsi que le format 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 et chiffres, pas de soulignement ni de tiret) et NUMBER avec votre numéro Vonage en E.164 (par exemple 447700900000).

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/answer est le answer_url que nous avons mentionnée plus haut. Il renvoie un JSON qui contient le numéro de destination de l'appel.

Il est à noter que le number est extraite de la base de données req.query.to que Vonage envoie dans le cadre de la demande. Le NCCO construit dynamiquement transfère ensuite l'appel vers le téléphone de destination à l'aide d'une fonction connect action.
Le deuxième, /voice/eventSi vous souhaitez que Vonage vous informe de tout ce qui se passe pendant l'appel, vous définirez une destination - c'est ce que nous appelons l'option 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.