Format

Le Format Insight est un outil de validation fondamental qui permet de vérifier si un numéro de téléphone est correctement structuré et potentiellement attribuable à un abonné. Il permet de s'assurer que le numéro est conforme aux normes de numérotation internationales, d'identifier le pays associé et de déterminer le fuseau horaire correspondant. Cet aperçu ne confirme pas si le numéro est actuellement actif ou utilisé, mais il s'agit d'une première étape cruciale dans l'évaluation de la validité technique de tout numéro de téléphone mondial.

En analysant la syntaxe du numéro et la structure du préfixe, Format Insight permet d'identifier si le numéro appartient à une plage de numérotation valide dans un pays spécifique. Il signale également les numéros manifestement invalides ou mal formés, ce qui permet aux organisations de nettoyer les données avant de les utiliser à des fins opérationnelles ou marketing.

L'intégration de l'aperçu du format dans vos Applications peut vous aider dans toute une série de scénarios, notamment :

• Qualité et nettoyage des données : Format Insight est idéal pour nettoyer les bases de données historiques des clients. Il filtre les numéros mal formatés ou clairement invalides, ce qui permet de maintenir des normes élevées en matière d'hygiène des données et d'améliorer la facilité de contact globale.
• Validation en temps réel à l'entrée : Les entreprises peuvent intégrer ces informations dans les formulaires web ou les systèmes de gestion de la relation client pour valider les numéros de téléphone au fur et à mesure de leur saisie, ce qui réduit le risque d'erreurs de saisie et garantit que seuls les numéros correctement formatés sont stockés.
• Segmentation et localisation : Connaître le pays et le fuseau horaire associés à un numéro permet aux entreprises d'adapter leurs communications, de programmer la diffusion dans des créneaux horaires appropriés et de se conformer aux réglementations locales.
• Optimisation des coûts : Évitez d'avoir recours à des numéros non valides qui entraîneraient des tentatives d'envoi infructueuses, des efforts opérationnels gaspillés et des coûts inutiles dans les flux de travail SMS, vocaux ou de prévention de la fraude.

En résumé, Format Insight offre un moyen à faible latence et à haute fiabilité de valider les numéros de téléphone mondiaux à l'échelle. Il s'agit d'un élément clé de tout pipeline de renseignements sur les numéros de téléphone, qui jette les bases de vérifications plus avancées telles que les informations sur les opérateurs et les caractéristiques du réseau pour l'analyse des risques de fraude.

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 Format Insight par programme à l'aide de 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 du format afin de renvoyer des informations utiles en fonction du numéro de téléphone fourni :

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": {
      "format": {}
        }
    }'

L'API valide ensuite que le format du numéro de téléphone s'aligne sur les préfixes, la longueur et les modèles pris en charge dans chaque pays, et renvoie des informations supplémentaires telles que l'indicatif du pays, les fuseaux horaires, la localisation hors ligne attribuée au numéro, ainsi que les formats local et international du numéro :

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "format": {
        "country_code": "US",
        "country_name": "United States",
        "country_prefix": "1",
        "offline_location": "Georgia",
        "time_zones": [
          "America/New_York"
        ],
        "number_international": "+14040000000",
        "number_national": "(404) 000-0000",
        "is_format_valid": true,
        "status": {
          "code": "OK",
          "message": "Success"
        }
    }
  }
}

Vous verrez les champs suivants dans la fenêtre format 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.