Passer des appels locaux avec No Code et Vonage Code Hub

Introduction

Si vous êtes comme moi et que vous voyagez beaucoup à l'étranger, vous connaissez les difficultés liées à l'achat d'une carte SIM locale. Vous devez trouver un magasin, comparer les fournisseurs, installer la carte SIM locale et prier pour que vous achetiez suffisamment de données/minutes pour votre voyage (mais pas trop pour ne pas gaspiller une tonne d'argent !). Et le pire : essayer de trouver un trombone, un clou ou un crayon pour remettre la carte SIM d'origine à l'aéroport !

Heureusement, eSIM ont changé la donne et supprimé la plupart des tracas liés aux échanges de cartes SIM. Sauf que les eSIM ne fonctionnent que pour les données !

Dans ce billet, je vous montrerai comment disposer d'un numéro local où que vous alliez, capable de recevoir et d'émettre des appels locaux. Et le meilleur ? Vous pourrez l'installer en 5 minutes ou moins grâce à la plateforme plateforme Code Hub de Vonage et ne nécessitera aucun codage de votre part !

Conditions préalables

• Compte de développeur API de Vonage : Si vous n'avez pas de compte de développeur API de Vonage, inscrivez-vous maintenant (lien ci-dessous).

• Numéro virtuel de Vonage : Rendez-vous au Panneau Acheter des Numbers dans votre tableau de bord du développeur API. Sélectionnez un numéro dans la région où vous souhaitez passer des appels et assurez-vous qu'il possède les caractéristiques suivantes Voice vocales.

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Comment commencer avec Vonage Code Hub

Vonage's Code Hub est une nouvelle plateforme qui élimine la partie difficile de l'installation et de l'infrastructure afin de pouvoir utiliser rapidement les API de Vonage. Pour commencer, connectez-vous à votre Account de développeur API et trouvez le code Hub de Vonage. Recevoir et passer des appels locaux dans Code Hub.

Search Code Hub for Local Calls

Comment déployer votre projet Code Hub

Une fois que vous avez ouvert le produit, vous devez ouvrir le fichier Déployer le code (Déployer le code). Vous y trouverez l'option Créer une nouvelle instance pour créer une nouvelle instance.

Deploy a new instance in Code Hub

Cela ouvrira un panneau qui vous demandera de configurer le déploiement de votre projet :

• Région : sélectionnez la région la plus proche de chez vous

• Nom de l'espace de travail : choisir un nom descriptif, par exemple "My American Local Call Forwarding" (Mon renvoi d'appel local américain)

• Numéro du pays d'origine : Votre numéro virtuel Vonage avec le code de votre pays d'origine (même code de pays que votre numéro personnel).

• Numéro de destination : Votre numéro virtuel Vonage avec le code du pays de destination.

• Numéro personnel : Il s'agit de votre numéro habituel vers lequel les appels sont renvoyés.

Pour tous les numéros, l'indicatif international est requis, sans +.

• Exemple de numéro américain : 15551234567

• Exemple de numéro britannique : 445551234567

Une fois que vous aurez soumis le formulaire, vous serez dirigé vers votre tableau de bord des produits déployés. Voilà, c'est fait ! Votre application est prête à être utilisée !

Comment tester votre produit déployé

Vous pouvez ensuite tester votre application en appelant la fonction DESTINATION_NUMBER ou HOME_COUNTRY_NUMBER.

• Appelez votre DESTINATION_NUMBER à partir d'un téléphone dont l'indicatif est celui de votre pays de destination et il vous connectera à votre numéro personnel.

• Appelez votre HOME_COUNTRY_NUMBER à partir de votre numéro personnel et il vous mettra en relation avec le numéro de votre choix dans votre localité de destination.

Comprendre le code

Au lieu d'ouvrir le fichier Déployer le code aller sous l'onglet Obtenir le code et ouvrez le projet dans l'environnement de développement virtuel. En utilisant l'onglet Explorer (shift+command+E), ouvrez le fichier index.js (en anglais). C'est là que se trouve tout le code du projet. Vous pouvez y voir la logique de l'application.

Nous définissons nos variables d'environnement en haut, celles-ci proviennent de vcr.yml et correspondent au formulaire qui est présenté aux utilisateurs de Code Hub et qui est défini dans le fichier setup.json fichier.

const destinationlNumber = process.env.DESTINATION_NUMBER;
const homeCountrylNumber = process.env.HOME_COUNTRY_NUMBER;
const personalNumber = process.env.PERSONAL_NUMBER;

Notre application écoute le point de terminaison /onCall et détermine ensuite si l'appelant est personalNumber (nous) ou s'il s'agit d'une autre personne qui essaie de nous joindre.

• Si l'appel provient de nous, il utilisera alors les éléments suivants talk et dtmf de l'API Voice, avant de nous envoyer au point de terminaison /dtmf qui déclenche l'intervention de l'opérateur pour nous connecter à l'interface de l'API vocale. dialedNumber.

• Si l'appel provient d'un autre numéro, il mettra l'appelant en relation avec le numéro de téléphone de l'opérateur. personalNumber mais en passant par l'intermédiaire homeCountrylNumber afin d'éviter les frais d'itinérance pour les deux parties.

Conclusion

N'est-ce pas génial ? Mais que se passe-t-il sous le capot ? Cette application s'appuie sur le SDK Vonage VCR SDK de Vonage (qui alimente Code Hub) et l'API vocale sous-jacente. Voice API.

L'API Voice nous donne accès à NCCOqui nous permettent d'envoyer des messages aux appelants, d'accepter les entrées DTMFet connecter les appels à d'autres numéros de téléphone.

Nous avons également utilisé SSML (Speech Synthesis Markup Language) pour personnaliser le discours de notre agent afin qu'il prononce les chiffres d'un numéro de téléphone de manière plus naturelle.

Si vous avez aimé cet article ou même si vous l'avez détesté, faites-le nous savoir sur le Slack des développeurs de Vonage ou envoyez-moi un message sur Xanciennement connu sous le nom de Twitter.

Lectures complémentaires

• La version bêta de Code Hub est désormais disponible

• Créer plus rapidement des applications Voice

• Créer plus rapidement des applications de messagerie