Advisor [Versión preliminar para desarrolladores]

La función «Asesor» analiza y ofrece consejos y valoraciones basadas en los datos de Insights solicitados y/o disponibles en una solicitud de Identity Insights.

Advisor se basa en cuatro modelos estáticos válidos para diferentes casos de uso y sectores:

  • Identidad sintética: modelo diseñado para evaluar el riesgo de identidad sintética a lo largo del recorrido del cliente.
  • Suplantación de identidad: Modelo diseñado para evaluar el riesgo de suplantación de identidad a lo largo del recorrido del cliente.
  • Apropiación de cuentas: modelo diseñado para evaluar el riesgo de apropiación de cuentas a lo largo del recorrido del cliente.
  • Experiencia del cliente: modelo diseñado para evaluar los indicadores de la experiencia del cliente a lo largo de su recorrido.

Estos modelos presentan un nivel de complejidad y una variedad de casos de uso que se ajustan bien a las señales disponibles actualmente en Identity Insights a corto y medio plazo. Cada modelo contiene un conjunto de «Insights» recomendados, definiciones de señales basadas en valores de atributos y rangos de atributos.

Si incluyes la información de Advisor en la solicitud, la respuesta incluirá además lo siguiente para cada modelo:

  • Información destacada recomendada: Matriz con la información destacada recomendada para el modelo.
  • Señales: atributos específicos y su valor o rango de valores correspondiente, que se utilizan para evaluar aspectos relevantes del recorrido del cliente. Las señales ayudan a evaluar el riesgo, la experiencia del usuario o el cumplimiento normativo, al poner de relieve patrones significativos o anomalías en los datos obtenidos por Identity Insights.
  • Indicadores:
    • completeness_ratio: La relación entre los Insights disponibles (sin datos faltantes) y el número total de Insights recomendados, expresada como un valor comprendido entre 0 y 1.
    • positive_ratio: Proporción por cada tipo de asesoramiento (excluyendo MISSED_INSIGHT)
    • warning_ratio: Proporción por cada tipo de asesoramiento (excluyendo MISSED_INSIGHT)
    • negative_ratio: Proporción por cada tipo de asesoramiento (excluyendo MISSED_INSIGHT)
    • weighted_ratio: Proporción ponderada para cada tipo de asesoramiento (excluyendo MISSED_INSIGHT)
  • Consejos sobre modelos:
    • completeness: Consejos basados en el completeness_ratio métrico.
    • worst_case: Este consejo es el peor de todos los que hay
    • weighted: Evalúa las señales pertinentes y ofrece una recomendación general, teniendo en cuenta las señales positivas, negativas y las que faltan.

Requisitos previos

Para utilizar Identity Insights, debe asegurarse de que su Account está configurado correctamente; consulte la sección Primeros pasos para obtener más información:

  • Crear tu Account,
  • Creación de una aplicación de Vonage para su uso con la API Identity Insights,
  • Los distintos entornos disponibles y cómo configurar tu Account para utilizarlos,
  • Y cómo utilizar la interfaz de usuario «Primeros pasos» del panel de control para utilizar la API sin tener que escribir código.

En esta guía se explica cómo utilizar Advisor Insight mediante programación con cURL.

La API de Identity Insights está disponible a través de varios puntos de conexión regionales. Los ejemplos de esta guía utilizan el punto de conexión de la UE, pero puedes consultar la lista completa en Detalles técnicos.

Realizar una llamada a la API

La autenticación para la API Identity Insights se realiza mediante JWT, un token JSON compacto y autocontenido. Para generar un JWT, puede utilizar nuestra herramienta generador en línea, o bien utiliza el CLI de Vonage. Necesitará su ID de aplicación y su clave privada para generar el JWT. Una vez que tenga su JWT, puede enviar una solicitud a la API.

Este ejemplo muestra una solicitud cURL para la vista «Advisor» y «SIM Swap», con el fin de comprobar si se ha producido un cambio de tarjeta SIM en las últimas 240 horas y obtener el análisis de dicha vista:

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

A continuación, la API analizará la respuesta del informe sobre el cambio de tarjeta SIM, realizará una evaluación y ofrecerá recomendaciones basadas en ella:

{
  "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."
      }
    }
  }
}

Lecturas complementarias