Accessibilité

Fournissant des informations en temps réel provenant directement des opérateurs de téléphonie mobile, Reachability Insight peut être utilisé pour vérifier l'état de la connectivité d'un appareil donné, notamment s'il est connecté au réseau pour les données, les SMS ou les deux.

Les principaux avantages sont les suivants :

  • Amélioration de l'expérience de l'utilisateur par l'envoi de communications pertinentes : Déterminer la joignabilité d'un client et lui envoyer la communication appropriée, par SMS ou par données.
  • Gestion de la base de données des dossiers des clients : Déterminez quels clients doivent être contactés pour mettre à jour leur numéro de téléphone, par exemple si un utilisateur donné n'a pas eu de connectivité de données ou de SMS au cours des 60 derniers jours.
  • Diagnostic et surveillance à distance rapides des appareils IoT : Détectez les appareils hors ligne et, le cas échéant, la date de leur dernière mise en ligne, et déterminez à distance les appareils qui nécessitent une maintenance.

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 Reachability Insight par programme en utilisant cURL.

L'API Identity Insights est disponible via plusieurs points de terminaison régionaux. Les exemples de ce guide utilisent le point de terminaison de l'UE, mais vous pouvez en trouver la liste complète à l'adresse suivante Détails techniques.

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 le Reachability insight afin de vérifier si, et comment, un appareil donné est connecté au réseau mobile :

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

L'API renverra alors des informations sur la joignabilité de cet appareil, y compris une confirmation de la joignabilité actuelle et les types de trafic disponibles (actuellement, les SMS et les données sont pris en charge) :

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "reachability": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_reachable": true,
        "connectivity": ["DATA", "SMS"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
  }
}

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

Champ d'application Description
latest_status_at Dernière mise à jour de l'état de connectivité de l'appareil associé.
is_reachable Indique la joignabilité globale de l'appareil - sera true si l'appareil est connecté au réseau.
connectivity Indique si l'appareil est connecté au réseau pour DATA ou SMS l'usage. Ne sera renvoyé que si is_reachable est true.
status Indique l'état des informations renvoyées pour le numéro de téléphone spécifié.
code Code indiquant l'état de la demande. Doit être l'un des suivants :

NO_COVERAGE: Le pays ou le réseau mobile n'est pas pris en charge par les fournisseurs disponibles.
INVALID_PURPOSE: L'objectif utilisé n'est pas valide ou autorisé pour cet Insight.
UNAUTHORIZED: La demande n'a pas pu être autorisée pour la combinaison de l'application, du fournisseur et du numéro de téléphone.
INTERNAL_ERROR: Une erreur interne s'est produite lors du traitement de la demande.
SUPPLIER_ERROR: Le fournisseur a renvoyé une erreur lors du traitement de la demande.
NOT_FOUND: Le numéro de téléphone n'a pas pu être trouvé pour ce Numbers.
INVALID_NUMBER_FORMAT: Le format du numéro de téléphone n'est pas valide pour être attribué par les opérateurs aux utilisateurs.
OK: L'insight a été traité avec succès.
message Description plus détaillée de l'état.

Pour en savoir plus