Advisor [Aperçu pour développeurs]

La fonctionnalité « Conseiller » analyse les données et fournit des conseils et des évaluations en fonction des informations demandées et/ou disponibles dans une requête Identity Insights.

Advisor s'appuie sur quatre modèles statiques adaptés à différents cas d'utilisation et secteurs d'activité :

  • Identité synthétique : modèle conçu pour évaluer le risque lié à l'identité synthétique tout au long du parcours client.
  • Usurpation d'identité : modèle conçu pour évaluer le risque d'usurpation d'identité tout au long du parcours client.
  • Usurpation de compte : modèle conçu pour évaluer le risque d'usurpation de compte tout au long du parcours client.
  • Expérience client : modèle conçu pour évaluer les indicateurs de l'expérience client tout au long du parcours client.

Ces modèles présentent un niveau de complexité et une diversité de cas d'utilisation qui correspondent bien aux signaux actuellement disponibles dans Identity Insights à court et moyen terme. Chaque modèle contient un ensemble d'« Insights » recommandés, des définitions de signaux basées sur les valeurs d'attributs, ainsi que des plages d'attributs.

Si vous incluez les informations fournies par Advisor dans la requête, la réponse contiendra en outre les éléments suivants pour chaque modèle :

  • Statistiques recommandées : tableau contenant les statistiques recommandées pour le modèle.
  • Signaux : attributs spécifiques et leur valeur ou plage de valeurs correspondante, utilisés pour évaluer les aspects pertinents du parcours client. Les signaux permettent d'évaluer le risque, l'expérience utilisateur ou la conformité en mettant en évidence des tendances significatives ou des anomalies dans les données récupérées par Identity Insights.
  • Indicateurs :
    • completeness_ratio: Rapport entre le nombre d'Insights disponibles (pour lesquels aucune donnée ne manque) et le nombre total d'Insights recommandés, exprimé sous la forme d'une valeur comprise entre 0 et 1.
    • positive_ratio: Taux pour chaque type de conseil (à l'exception de MISSED_INSIGHT)
    • warning_ratio: Taux pour chaque type de conseil (à l'exception de MISSED_INSIGHT)
    • negative_ratio: Taux pour chaque type de conseil (à l'exception de MISSED_INSIGHT)
    • weighted_ratio: Taux pondéré pour chaque type de conseil (à l'exception de MISSED_INSIGHT)
  • Conseils pour les mannequins :
    • completeness: Conseils fondés sur le completeness_ratio métrique.
    • worst_case: Ce conseil est le pire de tous ceux qui existent.
    • weighted: Évaluer les signaux pertinents et formuler une recommandation globale, en tenant compte des signaux positifs, négatifs et manquants.

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 Advisor Insight par programmation à l'aide de 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 présente une requête cURL concernant l'indicateur « Advisor » et « SIM Swap », visant à vérifier si un échange de carte SIM a eu lieu au cours des dernières 240 heures et à obtenir l'analyse associée à cet indicateur :

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": {
      "sim_swap": {
        "period": 240
      },
      "advisor": {}
    }
  }'

L'API analysera ensuite la réponse fournie par l'outil d'analyse des échanges de cartes SIM, procédera à une évaluation et formulera des recommandations en fonction de celle-ci :

{
  "request_id":"c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights":{
    "sim_swap":{
      "latest_sim_swap_at":"2024-07-08T09:30:27.504Z",
      "is_swapped":true,
      "status":{
        "code":"OK",
        "message":"Success"
      }
    },
    "advisor":{
      "synthetic_identity":{
        "recommended_insights":[
          "format",
          "original_carrier"
        ],
        "signals":[
          {
            "attribute":"format",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor synthetic_identity model."
          },
          {
            "attribute":"original_carrier",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor synthetic_identity model."
          }
        ],
        "metrics":{
          "completeness_ratio":0,
          "positive_ratio":0,
          "warning_ratio":0,
          "negative_ratio":0,
          "weighted_ratio":0
        },
        "model_advice":{
          "completeness":"LOW",
          "worst_case":"WARNING",
          "weighted":"WARNING"
        }
      },
      "impersonation":{
        "recommended_insights":[
          "format",
          "original_carrier",
          "current_carrier",
          "subscriber_match"
        ],
        "signals":[
          {
            "attribute":"format",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor impersonation model."
          },
          {
            "attribute":"original_carrier",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor impersonation model."
          },
          {
            "attribute":"current_carrier",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor impersonation model."
          },
          {
            "attribute":"subscriber_match",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor impersonation model."
          }
        ],
        "metrics":{
          "completeness_ratio":0,
          "positive_ratio":0,
          "warning_ratio":0,
          "negative_ratio":0,
          "weighted_ratio":0
        },
        "model_advice":{
          "completeness":"LOW",
          "worst_case":"WARNING",
          "weighted":"WARNING"
        }
      },
      "account_take_over":{
        "recommended_insights":[
          "format",
          "sim_swap"
        ],
        "signals":[
          {
            "attribute":"format",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor account_take_over model."
          },
          {
            "attribute":"sim_swap",
            "advice":"NEGATIVE",
            "assessment":"A SIM swap represents a high risk of account takeover."
          }
        ],
        "metrics":{
          "completeness_ratio":0.5,
          "positive_ratio":0,
          "warning_ratio":0,
          "negative_ratio":1,
          "weighted_ratio":0
        },
        "model_advice":{
          "completeness":"MEDIUM",
          "worst_case":"NEGATIVE",
          "weighted":"NEGATIVE"
        }
      },
      "customer_experience":{
        "recommended_insights":[
          "format",
          "current_carrier"
        ],
        "signals":[
          {
            "attribute":"format",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor customer_experience model."
          },
          {
            "attribute":"current_carrier",
            "advice":"MISSED_INSIGHT",
            "assessment":"Insight missed - This Insight is recommended to evaluate advisor customer_experience model."
          }
        ],
        "metrics":{
          "completeness_ratio":0,
          "positive_ratio":0,
          "warning_ratio":0,
          "negative_ratio":0,
          "weighted_ratio":0
        },
        "model_advice":{
          "completeness":"LOW",
          "worst_case":"WARNING",
          "weighted":"WARNING"
        }
      },
      "status":{
        "code":"OK",
        "message":"Success."
      }
    }
  }
}

Pour en savoir plus