Transporteur actuel

L'information sur l'opérateur actuel identifie l'opérateur de réseau mobile qui est actuellement attribué à un numéro de téléphone donné. Contrairement aux informations basées sur l'attribution initiale, cette fonctionnalité reflète la portabilité des numéros, en offrant des informations actualisées sur l'opérateur auquel un numéro de téléphone est associé.

Cette connaissance est essentielle dans les scénarios où l'efficacité de la communication, la délivrabilité et la vérification de l'utilisateur sont critiques. En confirmant qu'un numéro est activement attribué à un réseau mobile, les entreprises peuvent garantir un acheminement précis des communications SMS, vocales ou basées sur des données. Elles peuvent ainsi éviter les coûts inutiles et les inefficacités opérationnelles liés au contact avec des numéros désactivés (non associés à un opérateur) ou non mobiles.

L'un des principaux cas d'utilisation comprend le nettoyage et la mise à jour des bases de données clients, en veillant à ce que les informations de contact soient à la fois actuelles et valides. Par exemple, le fait d'identifier qu'un numéro n'est plus attribué à un opérateur de téléphonie mobile peut permettre d'éviter les messages qui échouent, de réduire les nouvelles tentatives et de maintenir une haute qualité d'engagement de la part des utilisateurs. Cela soutient également la sensibilisation au respect de la vie privée en se concentrant sur les numéros mobiles, qui sont généralement plus personnels et susceptibles d'être utilisés par un individu, par rapport aux lignes fixes, virtuelles ou surtaxées.

Dans les processus de prévention de la fraude et de vérification de l'identité, le fait de connaître l'opérateur mobile actuel peut servir de signal pour valider la légitimité de l'utilisateur et réduire les risques.

En tirant parti de ces informations, les entreprises contrôlent mieux leurs flux de communication, améliorent l'expérience utilisateur et optimisent les stratégies d'engagement sur la base de renseignements sur les numéros de téléphone en temps réel.

Conditions préalables

Pour utiliser Identity Insights, vous devez vous assurer que votre Account est correctement configuré. Pour commencer pour plus d'informations :

• Création de votre Account,
• Création d'une application Vonage à utiliser avec l'API Identity Insights,
• Les différents environnements disponibles et comment configurer votre Account pour les utiliser,
• Et comment utiliser l'interface utilisateur du tableau de bord pour utiliser l'API sans écrire de code.

Ce guide explique comment utiliser l'aperçu du transporteur actuel par programme en utilisant cURL.

Faire un appel à l'API

L'authentification pour l'API Identity Insights se fait par le biais de JWT, un jeton JSON compact et autonome. Pour générer un JWT, vous pouvez utiliser notre outil générateur en ligneou bien utiliser la fonction CLI Vonage. Vous aurez besoin de votre identifiant d'application et de votre clé privée pour générer le JWT. Une fois que vous avez votre JWT, vous pouvez envoyer une demande à l'API.

Cet exemple montre une requête cURL pour l'aperçu de l'opérateur actuel :

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "current_carrier": {}
        }
    }'

L'API renvoie alors des informations sur le réseau auquel le numéro de téléphone est actuellement attribué, notamment le nom, le type de réseau et l'indicatif de pays :

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "current_carrier": {
         "name": "Orange Espana, S.A. Unipersonal",
         "network_type": "MOBILE",
         "country_code": "ES",
         "network_code": "21403",
         "status": {
            "code": "OK",
            "message": "Success"
         }
      }
  }
}

Vous verrez les champs suivants dans la fenêtre current_carrier objet :

Pour en savoir plus

• Pour en savoir plus sur l'API Identity Insights, consultez la page Référence API.
• Si vous avez des questions, vous pouvez nous contacter à l'adresse suivante Communauté Vonage Slack.