Registre du réseau

Pour utiliser le Caractéristiques du réseau Vonage en production, vous devrez vous inscrire pour obtenir l'autorisation d'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.

Le processus

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 que vous êtes connecté, allez dans la section Construire et gérer et cliquez sur Registre du réseau 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.

Ajouter 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 des 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

• 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

Emplacement de l'entreprise

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

Prestataire de services en aval

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.

Créer un profil d'application réseau

Un profil d'entreprise peut avoir un nombre quelconque de profils d'application, qui sont utilisés pour faire correspondre les Applications du réseau à votre cas d'utilisation et suivre l'approbation de l'opérateur.

Lorsque vous créez votre profil d'entreprise, vous êtes invité à créer votre premier profil d'application. Ensuite, vous pouvez cliquer sur le bouton "Ajouter un profil d'application" sur la page du profil d'entreprise pour créer d'autres profils d'application.

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 "Capacités", activez "Registre du réseau" et sélectionnez le type d'accès requis : Terrain de jeu ou Production.
  • Pour plus d'informations sur les tests effectués à partir de l'aire de jeu du registre du réseau Vonage, voir 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 !