Appels vers le RTPC avec l'API Voice de Vonage et First Orion

Créez des appels sortants de marque avec l'API Voice de Vonage et First Orion. Affichez le nom de votre entreprise, votre logo et l'objet de l'appel sur les appels RTC.

Introduction

Example of a branded incoming call displaying the company name, logo, and phone number on a mobile deviceSi vous passez des appels sortants à partir d'une application, il y a de fortes chances que certains d'entre eux soient ignorés ou signalés comme du spam. Lorsque le destinataire ne reconnaît pas le numéro, il ne répond souvent pas, même si l'appel est légitime.

L'appel de marque RTPC répond à ce problème en associant des informations d'identité vérifiées à vos appels. Au lieu d'afficher un simple numéro de téléphone, le destinataire voit le nom de votre entreprise, votre logo et un court motif d'appel directement sur son appareil. En pratique, vos appels sont plus facilement reconnaissables et ont plus de chances d'être pris.

Dans ce tutoriel, vous configurerez l'appel de marque RTCP en utilisant l'API vocale de Vonage. Voice API de Vonage de Vonage et First Orion. Vous configurerez un programme d'appel de marque, le relierez à un numéro virtuel Vonage, puis passerez un appel sortant à partir d'une simple application Node.js.

À la fin, vous aurez une configuration fonctionnelle dans laquelle vos appels sortants afficheront des informations sur la marque en temps réel, ainsi qu'une application minimale que vous pourrez utiliser comme point de départ pour votre propre intégration.

>> TL;DR : Passez à l'étape suivante et trouvez l'exemple de code de l'application sur GitHub. exemple de code d'application sur GitHub.

Conditions préalables

• Un compte API Vonage avec Voice activé

• Un compte First Orion avec une d'une entreprise agréée

• Un numéro virtuel Vonage déjà provisionné pour l'appel de marque RTCP

Appel de marque dans First Orion

First Orion propose un ensemble d'API et d'outils de plateforme pour gérer les appels de marque sur les réseaux des opérateurs. Il s'agit de la plateforme INFORM, qui gère la manière dont l'identité de votre entreprise est présentée sur les appareils pris en charge. INFORM vous permet de définir des éléments tels que le nom d'affichage, le logo et le motif d'appel qui s'affichent lors de la réception d'un appel. La plateforme vous donne également accès à des analyses et à des contrôles au niveau du programme, ce qui vous permet de suivre la diffusion et d'effectuer les ajustements nécessaires.

Pour activer l'appel de marque pour un numéro de téléphone, vous devez créer un programme. Vous pouvez considérer un programme comme une campagne. Un programme appartient à une unité commerciale, qui se trouve à l'intérieur d'une entreprise.

Hierarchy of branded calling in First Orion, showing how a business contains business units, which contain programsPour commencer, vous devez enregistrer votre entreprise auprès de First Orion. Une fois que votre entreprise est approuvée et que vous avez créé votre unité commerciale, vous pouvez créer votre premier programme :

First Orion Business Unit dashboard where you can create programs and manage phone numbers for branded callingLa mise en place d'un programme se fait en 3 étapes :

1. Détails : informations générales sur le programme

2. Affichage : le nom et l'heure d'affichage à montrer aux utilisateurs

3. Numéros de téléphone : quel(s) numéro(s) sera(ont) attribué(s) à ce programme

Vous pouvez créer un nouveau programme soit :

• via l'API

• via le portail client

Adding phone numbers and defining call purpose during branded calling program setup in First Orion

Une fois votre programme créé, vous pourrez lui attribuer une image. Cliquez sur le programme pour le modifier. Passez ensuite à l'étape 3, "Image", où vous pouvez ajouter une image et un motif d'appel :

Uploading a logo and defining the call reason for a branded calling program, with a real-time mobile preview

Lier les appels de marque dans le tableau de bord de Vonage

Une fois le programme First Orion mis en place, vous devrez configurer le lien dans le tableau de bord de Vonage. Dans le tableau de bord de Vonage, allez dans Voice → Trusted Calling → Appel de marque RTPC.

Tout d'abord, vous devrez suivre les instructions pour intégrer votre Account First Orion. L'identifiant ID utilisateur est votre clé API First Orion, et le mot de passe est la clé secrète associée. Vous pouvez voir comment générer une First Orion API Key dans la documentation.

Configuring the First Orion integration in the Vonage Dashboard using API credentialsUne fois l'intégration établie, vous pouvez maintenant la configurer. Ouvrez l'intégration que vous avez créée en cliquant sur l'option "modifier".

First Orion integration successfully configured in the Vonage Dashboard with an enabled virtual numberSélectionnez ensuite Activer sur le numéro virtuel Vonage que vous avez ajouté précédemment dans le tableau de bord First Orion.

Managing and enabling virtual numbers for PSTN Branded Calling in the Vonage Dashboard

Exécution de l'application In-App Voice de Vonage

Maintenant que votre numéro virtuel Vonage est lié à votre programme d'appel de marque First Orion, vous pouvez passer un appel sortant de marque à partir d'une simple appli de test Node.js. L'application d'exemple expose un fichier local /call et utilise ngrok pour rendre vos points de terminaison webhook accessibles au public.

1. Cloner l'application modèle et installer les dépendances

git clone git@github.com:Vonage-Community/blog-voice-node-branded_calling.git
cd branded-calling
npm install

2. Configurer votre fichier ENV

Copiez le fichier d'environnement de l'exemple et modifiez-le :

cp .env.example .env

Vous configurerez 3 catégories de paramètres :

A) Authentification Vonage (JWT / Applications)

• VONAGE_APPLICATION_ID
  Le numéro d'identification de l'application dans le tableau de bord de Vonage.

• CHEMIN_DE_LA_CLÉ_PRIVÉE_DE_VONAGE
  Chemin d'accès à votre fichier de clé privée (PEM). Dans ce tutoriel, nous utiliserons ./private.key.

B) Appel des valeurs par défaut

• FROM_NUMBER
  Votre numéro virtuel Vonage que vous avez enregistré/activé pour les appels de marque (format E.164, comme +1408...).

• TO_NUMBER
  Le numéro de destination par défaut de votre appel test (votre téléphone portable, etc.). Vous pouvez le modifier ultérieurement dans la requête curl.

C) L'image de marque

1. NOM DE L'ENTREPRISE

2. SALUTATIONS
   Le message de synthèse vocale diffusé lorsque l'on répond à l'appel.

3. Démarrer un tunnel ngrok

Vonage doit être en mesure d'atteindre vos points de terminaison webhook sur l'internet public. Le moyen le plus simple pour le développement local est ngrok.

Dans une nouvelle fenêtre de terminal :

ngrok http 3000

Copier l'URL URL HTTPS de transfert (elle ressemblera à https://xxxx.ngrok-free.app).

Maintenant, mettez ceci dans votre .env :

• PUBLIC_BASE_URL = l'URL HTTPS de votre ngrok

PUBLIC_BASE_URL=https://xxxx.ngrok-free.app

>> Important : Si vous redémarrez ngrok, vous obtiendrez une nouvelle URL et devrez à nouveau mettre à jour PUBLIC_BASE_URL.

4. Créer une application Voice de Vonage

Dans le tableau de bord de Vonage :

• Créer une nouvelle Applications

• Activer les capacités Voice

• Générez/téléchargez la clé privée (private.key) et placez-la à la racine de votre projet.

• Copiez l'identifiant de l'Application dans votre fichier .env en tant que VONAGE_APPLICATION_ID.

• Dans le webhook d'événement du tableau de bord, ajoutez votre ngrok HTTPS suivi de /événement (par exemple, https://xxxx.ngrok-free.app/event)

5. Démarrer le serveur local

De retour dans le terminal du projet, démarrez votre application :

npm run start

6. Déclencher l'appel sortant avec curl

Option A : appeler le TO_NUMBER par défaut dans le fichier .env

curl -X POST http://localhost:3000/call \
  -H 'Content-Type: application/json' \
  -d '{}'

Option B : remplacer le numéro de destination par une demande

curl -X POST http://localhost:3000/call \
  -H 'Content-Type: application/json' \
  -d '{"to":"+14155550100"}'

Vous devriez maintenant recevoir un appel affichant votre marque configurée (nom, logo et motif de l'appel).

Full-screen view of an incoming branded call displaying the company name, logo, and standard call controls on a mobile device

Remarque : L'affichage de la marque dépend de l'opérateur et du comportement de l'appareil. Vous pouvez vérifier le "statut par opérateur" dans les détails de votre programme.

Screenshot of the First Orion program details page displaying call metrics, answer rate, and carrier approval status for AT&T, Verizon, and T-Mobile.

Conclusion

À ce stade, vous avez configuré l'appel de marque RTC de bout en bout à l'aide de Vonage et First Orion. Vous avez créé un programme d'appel de marque, l'avez lié à un numéro virtuel Vonage et avez déclenché un appel sortant à partir d'une application Node.js qui affiche votre marque configurée en temps réel.

Avec cette base en place, vous pouvez commencer à intégrer les appels de marque dans vos flux de travail existants. Par exemple, en déclenchant des appels à partir d'événements d'application, en personnalisant les motifs d'appel de manière dynamique ou en séparant différents cas d'utilisation dans des programmes distincts.

Si vous souhaitez aller plus loin, First Orion propose également une API d'authentification des appels. API d'authentification des appels qui peut être invoquée juste avant de passer un appel. Cela vous permet d'enregistrer explicitement l'intention de l'appel (appelant et destinataire) en temps réel, ce qui peut améliorer la confiance et la vérification des appels dans les réseaux pris en charge.

Ce modèle s'intègre naturellement à la configuration de ce tutoriel, puisqu'il s'exécute juste avant votre demande d'appel sortant existante.

Dans une configuration de production, vous voudrez également remplacer les outils locaux comme ngrok par un point de terminaison stable et accessible au public, et vous assurer que vos informations d'identification et la configuration des webhooks sont gérées de manière cohérente dans tous les environnements.

Le modèle global reste simple : votre application contrôle l'initiation de l'appel, Vonage s'occupe de la livraison et First Orion fournit la couche d'identité. Une fois connecté, l'appel de marque devient une extension directe des flux d'appels sortants que vous avez déjà.