Registre du réseau

Pour utiliser le Caractéristiques du réseau Vonage En environnement de production, vous devrez déposer une demande d'agrément pour accéder aux réseaux des opérateurs à partir d'une ou plusieurs Applications.

Pour simplifier ce processus, Vonage gère en coulisses l'enregistrement auprès de nombreux opérateurs partenaires pour toutes les fonctions réseau prises en charge, dans n'importe quel pays. pays mis à disposition par Vonage. Ce processus dépend de l'approbation de chaque opérateur, qui peut être transmise au registre du réseau Vonage à différents moments.

Chiffres d'essai

Avant de vous inscrire, ou en attendant la validation de la part des opérateurs mobiles que vous avez sélectionnés, vous pouvez tester toutes les fonctionnalités réseau de vos applications. Vous pouvez soit utiliser des données en temps réel, avec un maximum de 5  nombre de tests autorisés peut être configuré, ou  Numbers virtuels, qui fournissent des réponses API prédéfinies et déterministes à partir des paramètres de la requête API. Vous trouverez ci-dessous plus d'informations sur ces deux méthodes.

Activer les tests des fonctionnalités réseau dans votre application

Pour commencer les tests, vous devez d'abord créer une application :

1. Cliquez sur le bouton "Créer une application" ou naviguez jusqu'à la page Section Applications de votre tableau de bord et "Créer une nouvelle application".
2. Générer une paire de clés publique et privée pour la création d'un JWT lors de l'authentification. Vous aurez besoin de ce jeton JWT pour générer des jetons d'accès.
3. Activez la fonctionnalité « Fonctionnalités réseau » dans votre application et sélectionnez le type « Test d'accès ». Certaines fonctionnalités réseau nécessitent une configuration supplémentaire, comme une URL de rappel :

Une fois la fonctionnalité « Network Features » intégrée à votre application, vous pouvez commencer à tester les fonctionnalités réseau de Vonage. Vous pouvez soit utiliser des données réelles, avec un maximum de 5 nombre de tests autorisésou Numbers virtuels, qui fournissent des réponses API prédéfinies et déterministes à partir des paramètres de la requête API. Vous trouverez ci-dessous plus d'informations sur ces deux méthodes.

Numéros virtuels

Pour utiliser les données en temps réel, vous devez disposer d'au moins un numéro de téléphone valide auprès d'un opérateur pris en charge et, dans certains cas, d'un accès aux données mobiles auprès d'un opérateur pris en charge. Il peut toutefois y avoir des cas où cela n'est pas possible, par exemple lorsque vous testez les fonctionnalités réseau depuis un pays qui n'est pas encore pris en charge.

Les numéros de test de l'opérateur virtuel fournissent des réponses API prédéfinies et déterministes en fonction des paramètres de la requête API. Pour plus d'informations, consultez le guide de l'opérateur virtuel correspondant à l'API de votre choix :

• Identité
• Récupération de l'emplacement de l'appareil
• La qualité à la demande
• Authentification silencieuse

Nombre de tests autorisés

Pour utiliser des données en temps réel lors des tests, faites défiler la page jusqu'à la section « Chiffres de test » dans le Registre du réseau Vonage puis cliquez sur l'onglet « Ajouter un numéro ». Pour chaque numéro de téléphone de test que vous souhaitez ajouter, procédez comme suit :

1. Choisissez le code du pays parmi les pays disponibles
2. Saisissez le numéro de téléphone que vous utiliserez pour les tests.
3. Cochez la case pour confirmer que le numéro ne sera utilisé qu'à des fins de test.

Cliquez sur "Verify" et le numéro de téléphone recevra un code d'authentification par SMS. Saisissez le code fourni pour terminer la vérification du numéro.

Une fois que le code de vérification est ajouté et que la vérification est réussie, le numéro de test est inscrit sur la liste d'autorisation et vous pouvez commencer à tester les fonctionnalités du réseau.

Créer votre application de registre de réseau

Pour commencer le processus d'enregistrement du réseau Vonage, vous devez avoir un compte Vonage ; si vous n'en avez pas encore, vous pouvez vous inscrire pour obtenir un compte ici.

Une fois connecté, rendez-vous sur la page Construire rubrique, puis cliquez sur Registre du réseau, puis faites défiler la page vers le bas pour trouver le Accès complet et cliquez sur Envoyer une inscription Pour commencer :

L'inscription aux fonctionnalités du réseau se fait en trois étapes principales :

1. Ajouter un profil d'entreprise: Parlez-nous un peu de l'organisation qui détient l'application.
2. Créer un profil d'application réseau: Sélectionnez les fonctionnalités du réseau que vous souhaitez utiliser, décrivez votre cas d'utilisation et soumettez le tout pour approbation.
3. Connectez votre application Vonage: Liez votre profil à une application Vonage nouvelle ou existante pour l'authentification.

Créer un profil d'entreprise

Un profil d'entreprise aide Vonage et ses partenaires opérateurs à savoir quelle organisation possède chaque application utilisant les fonctions de réseau.

Sélection du pays

Pour que votre inscription soit acheminée vers les bons opérateurs, vous devez d'abord sélectionner le pays où le service est requis en choisissant dans la liste des pays disponibles. Votre inscription sera partagée avec les opérateurs disponibles dans chaque pays sélectionné. Les pays et les opérateurs disponibles peuvent être consultés ici.

Ensuite, complétez un profil d'entreprise en fournissant plus d'informations sur l'organisation propriétaire des Applications. Pour remplir cette section, vous aurez besoin des informations suivantes :

Profil de l'entreprise

Responsable de compte :

Certains opérateurs mobiles exigent des informations complémentaires avant de pouvoir accorder l'accès aux fonctionnalités du réseau. Si vous connaissez déjà le nom de votre chargé de compte Vonage, saisissez son adresse e-mail ici afin qu'il puisse vous aider à accélérer le processus. Si vous n'en avez pas ou si vous n'êtes pas sûr, notre équipe commerciale vous contactera si nécessaire.

Informations sur l'entreprise :

• Veuillez préciser votre rôle - le rôle fonctionnel que vous exercez au sein de l'organisation ou votre relation avec celle-ci.
• Nom de l'entreprise - le nom de l'entité juridique propriétaire des applications qui utiliseront les fonctionnalités du réseau Vonage.
• Pays d'immatriculation de l'entreprise - le pays où l'organisation est enregistrée.
• URL "Contactez-nous" de l'entreprise - si un formulaire web "Contactez-nous" existe pour votre entreprise, ajoutez-en l'URL ici.
• Type d'organisation - sélectionner le type le plus approprié dans la liste déroulante.
• Nom commercial - si différent, indiquer le nom sous lequel l'organisation exerce son activité.
• Numéro de taxe professionnelle - la référence fiscale de l'organisation dans le pays enregistré sera utilisée par Vonage et les opérateurs pour valider l'organisation.
• Autorité de délivrance - le cas échéant, sélectionnez dans la liste ou indiquez l'autorité qui a délivré votre numéro d'enregistrement d'entreprise.
• Numéro d'enregistrement de l'entreprise - si votre organisation dispose d'un enregistrement supplémentaire, vous pouvez l'inclure ici pour simplifier le processus de validation. L'inclusion d'un numéro d'enregistrement d'entreprise délivré par une autorité reconnue peut réduire les délais d'approbation.

Représentant légal :

Lors d'une demande d'accès dans un pays soumis au GDPR, vous pouvez réduire les délais d'approbation en indiquant le nom, la raison sociale (si elle est différente de la vôtre) et l'adresse électronique d'un représentant autorisé de votre entreprise.

Si votre entreprise est située en dehors de l'UE, vous devez nommer un représentant légal situé dans l'UE afin d'accéder aux fonctionnalités du réseau dans les pays contrôlés par le GDPR.

Détails sur la confidentialité :

• URL de la politique de confidentialité - Vonage et ses partenaires opérateurs exigent que toute personne utilisant les fonctions du réseau dispose d'une politique de confidentialité, accessible au public sur Internet - fournir l'adresse de la politique de l'organisation.
• Adresse électronique du responsable de la protection de la vie privée - inclure une adresse électronique qui peut être utilisée pour toute question relative à la politique de protection de la vie privée.
• La loi vous oblige-t-elle à désigner un délégué à la protection des données ? - Sélectionner Yes/No si votre organisation est tenue par la loi d'avoir ou non un délégué à la protection des données. Dans l'affirmative, indiquez un contact électronique s'il diffère de celui du responsable de la politique de protection de la vie privée.
• Votre organisation est-elle certifiée ISO 27001 ? - Sélectionner Yes/No si votre organisation est certifiée ou non. Si ce n'est pas le cas, mais que vous détenez un certificat équivalent, indiquez le nom du certificat.
• Saisir l'URL du formulaire Web pour les demandes d'information sur les droits en matière de protection de la vie privée - Une adresse électronique et/ou une URL qu'un utilisateur peut contacter pour exercer ses droits en matière de protection de la vie privée lorsqu'il utilise votre application.
• Adresse électronique du délégué à la protection des données - si la loi impose l'existence d'un DPD, indiquer un contact électronique si celui-ci diffère de celui du responsable de la politique de protection de la vie privée.

Si votre "Business registered country" est les États-Unis et que vous demandez l'accès à des pays contrôlés par le GDPR, vous verrez également les champs suivants :

• Vous êtes-vous auto-certifié auprès de la Cadre de protection des données pour les transferts de données vers les États-Unis ? - Sélectionner Yes/No si votre organisation s'est auto-certifiée ou non.
• Cadre de protection des données URL - si oui, indiquez ici l'URL de l'autocertification de votre organisation. Par exemple : https://www.dataprivacyframework.gov/participant/5785

Implantation de l'entreprise

Dans la section suivante, vous devez indiquer l'adresse du siège social de l'organisation.

Onward Provider

Cette section est requise si vous avez l'intention de revendre les fonctions du réseau Vonage à d'autres entreprises. Si ce n'est pas le cas, vous pouvez sélectionner "Non" pour confirmer que tout accès fourni ne peut être utilisé pour la revente des fonctions du réseau Vonage.

Si vous sélectionnez "Oui", vous devrez fournir des informations sur la manière dont vous traiterez les données des utilisateurs, ainsi que des détails sur les sous-traitants tiers qui vous aident à traiter les données associées à l'utilisation des fonctionnalités du réseau.

Une fois l'inscription soumise, vous verrez un résumé de votre profil d'entreprise, grâce auquel vous pourrez consulter et suivre l'état de votre inscription. Vous pouvez recevoir des notifications par courrier électronique lorsque l'état de votre inscription change ; les paramètres de notification peuvent être modifiés ici.

Ajouter un profil d'application

À moins que vous ne cochiez l'option « Revendeur » lors de la création de votre profil d'entreprise, vous serez invité à créer votre premier profil d'application. Par la suite, vous pourrez cliquer sur le bouton « Ajouter un profil d'application » sur la page du profil d'entreprise pour créer d'autres profils d'application, associer des fonctionnalités réseau à chaque cas d'utilisation et suivre le processus de validation par l'opérateur.

Pour remplir cette section, vous aurez besoin des informations suivantes :

• Nom de la demande d'entreprise - donner un nom à l'application pour l'identifier facilement.
• Description du cas d'utilisation - Décrivez votre application du point de vue du consommateur. Expliquez comment les Applications réseau sélectionnées aideront l'application à atteindre l'objectif choisi.
• Catégorie - sélectionnez une catégorie d'application dans la liste déroulante.
• Emplacement des infrastructures - sélectionner tous les pays dans lesquels vous pouvez traiter des données à caractère personnel liées à l'utilisation des fonctionnalités du réseau demandées.
• Comment un utilisateur peut-il exercer ses droits en matière de protection de la vie privée ? - Sélectionnez Email/Webform et saisissez l'adresse électronique et/ou l'URL du formulaire web qu'un utilisateur final peut utiliser pour exercer ses droits en matière de protection de la vie privée lorsqu'il utilise votre application.
• URL de la politique de confidentialité - fournir l'adresse de la politique de l'organisation.
• Conditions générales URL - fournir l'URL des conditions générales en ligne pour votre application.
• Choisir les caractéristiques du réseau - sélectionner une ou plusieurs fonctionnalités réseau que vous pourriez vouloir utiliser.
• Objectif - pour chaque fonctionnalité réseau sélectionnée, confirmer l'objectif dans la liste déroulante, par exemple "Prévention et détection de la fraude".
• Base juridique du traitement des données - pour chaque demande de fonctionnalité de réseau, sélectionnez dans la liste déroulante la base juridique sur laquelle vous vous appuyez pour partager les données à caractère personnel.
• Objectif Raison - expliquer comment les caractéristiques du réseau sélectionnées aideront votre application à atteindre l'objectif choisi.

Une fois la demande soumise, vous verrez un résumé mis à jour, y compris les profils de la demande de réseau. Vous pouvez recevoir des notifications par courrier électronique lorsque l'état de votre candidature change ; les paramètres de notification peuvent être modifiés ici.

Connectez votre application Vonage

Une fois que votre enregistrement est approuvé par au moins un opérateur, vous pouvez le lier à une ou plusieurs Applications Vonage pour commencer à utiliser les fonctionnalités du réseau. L'application Vonage contient les informations d'identification nécessaires pour effectuer des appels API.

Naviguez jusqu'à la page Page Applications sur le tableau de bord et cliquez sur "Créer une nouvelle application", puis suivez les étapes suivantes :

• Nom - Donnez un nom à votre application.
• Authentification - Vous pouvez soit fournir vos propres clés, soit cliquer sur "Générer les clés publiques et privées" pour générer les clés nécessaires au processus d'authentification ; une nouvelle clé publique apparaîtra dans la zone de texte, tandis que votre navigateur téléchargera automatiquement la clé privée.
• Clé API - est connectée à la clé API de votre Account.
• Dans la section relative à la protection de la vie privée, activez l'option "Intelligence artificielle" pour autoriser l'utilisation des données à des fins d'entraînement à l'IA.
• Dans la section « Fonctionnalités », activez « Registre réseau » et sélectionnez le type d'accès souhaité : « Accès test » ou « Accès complet ».
  • Pour plus d'informations sur les tests proposés par le Registre du réseau Vonage, consultez ici.
  • Pour l'accès Production, sélectionnez le profil d'entreprise et le profil d'application que vous avez créés dans les étapes précédentes.

Il se peut que vous soyez invité à configurer des options en fonction des fonctionnalités réseau incluses dans votre enregistrement.

Gestion des inscriptions

Statut d'enregistrement

Pour voir l'état de l'enregistrement de votre fonctionnalité réseau, naviguez vers Vonage API Dashboard→Network Registry.

Sélectionnez un profil commercial et développez le profil Applications pour afficher l'état de chacun des opérateurs partenaires de Vonage dans les pays que vous avez sélectionnés.

Les composants d'enregistrement peuvent se trouver dans un certain nombre d'états, qui peuvent varier d'un composant à l'autre et d'un opérateur partenaire de Vonage à l'autre à un moment donné. Les vues élargies comprennent une description sommaire de chaque état :

• TRANSFORMATION: Vonage travaille avec le(s) opérateur(s) pour permettre votre demande d'accès.
• ACCEPTÉ: accepté par le(s) opérateur(s)
• PARTIELLEMENT ACCEPTÉLa Commission européenne a adopté un projet de loi sur l'accès à l'information : accepté par certains opérateurs, rejeté par d'autres.
• REJETÉ: rejetée par le(s) opérateur(s)
• MIXTELa sélection d'un composant peut se faire en plusieurs étapes : états variés dans une vue réduite, expansion de la sélection pour voir l'état de chaque composant.

En mode production, les demandes de fonctionnalités réseau ne seront transmises à un opérateur que si elles sont envoyées à partir d'une Applications liée à un profil qui a été accepté par cet opérateur.

Utilisation de plusieurs clés API

Lorsqu'un profil d'application est créé, il appartient à la clé active que vous utilisiez dans le tableau de bord. Bien que cette clé ne puisse pas être modifiée, vous pouvez attribuer d'autres clés API à votre profil d'application pour activer les Applications réseau approuvées sur l'ensemble de votre Account.

Pour ce faire, naviguez jusqu'au profil d'application auquel vous souhaitez attribuer des clés et sélectionnez le bouton Attribuer des clés API. Une fois cliqué, vous verrez apparaître une liste de clés API provenant de votre Account :

La première clé de la liste déroulante est la clé propriétaire du profil d'application - elle ne peut pas être modifiée. Les autres clés de la liste sont toutes les autres clés API du même Account que la clé propriétaire. Pour attribuer ou désattribuer une autre clé API, sélectionnez-la dans la liste déroulante. Lors de la création d'une application utilisant les fonctionnalités réseau approuvées dans votre profil d'application, vous pourrez utiliser n'importe laquelle des clés API sélectionnées dans la liste.

Vetting

Certains opérateurs exigent des vérifications supplémentaires des antécédents, effectuées par un agent indépendant, pour les organisations qui demandent l'accès à leurs fonctions de réseau. Si ces vérifications sont exigées par un ou plusieurs opérateurs dans les pays que vous avez sélectionnés dans votre profil d'entreprise, vous serez invité à consentir à cette vérification avant que votre demande puisse leur être soumise.

Outre les informations décrites ci-dessus, vous devrez indiquer un point de contact au cas où l'agent de contrôle aurait besoin de contacter votre organisation au sujet des informations fournies.

• Nom: La personne qui doit être contactée par l'agent de contrôle, le cas échéant.
• Numéro de téléphone: Le numéro de contact de la personne nommée
• Adresse électronique: L'adresse électronique de la personne nommée

Si vous ne consentez pas à cette vérification, les opérateurs qui l'exigent seront exclus de votre enregistrement et vous n'aurez pas accès à leur réseau. Si vous changez d'avis, vous pouvez à tout moment demander une modification de votre profil commercial et ajouter votre consentement, ce qui déclenchera les processus de provisionnement et d'approbation avec ces opérateurs.

Notifications

Lorsqu'un enregistrement de fonctionnalité réseau est soumis, vous serez invité à vous abonner aux notifications, si ce n'est pas déjà fait. Vous pouvez à tout moment vous désabonner ou modifier les paramètres de notification en accédant à Tableau de bord API de Vonage→Paramètres API→Notifications.

Les notifications, ainsi que tout changement d'état connexe, sont également visibles dans votre tableau de bord Network Registry, où vous pouvez être invité à prendre d'autres mesures.

Soutien

Pour obtenir de l'aide sur les fonctionnalités du réseau, y compris sur la procédure d'enregistrement, consultez le site Web de la Commission européenne. Support API Centre d'aide.

Prochaines étapes

Une fois que vous vous êtes inscrit et que vous avez été approuvé, vous êtes prêt à utiliser les API !