Transportista original

La función «Original Carrier» proporciona información de baja latencia sobre el operador y el tipo de red asociados originalmente a un número de teléfono, utilizando la inteligencia del plan de numeración propio de Vonage. Ofrece metadatos sin necesidad de realizar consultas en tiempo real a proveedores u operadores externos, lo que la convierte en una herramienta rápida y fiable para numerosos casos de uso.

Aunque esta información se centra en la asignación original y no en los cambios posteriores, por lo que no refleja los cambios de portabilidad, sigue siendo muy valiosa para identificar la naturaleza de un número de teléfono. Puede indicar si un número se designó inicialmente como móvil, fijo, gratuito, de tarificación adicional o virtual, categorías a menudo relevantes para la prevención del fraude, el control de costes y la cualificación de usuarios.

Entre las principales ventajas se incluyen:

• Señales de riesgo de fraude: Detecta los tipos de números virtuales, premium o de alto riesgo que puedan indicar una suplantación de identidad o un tráfico inflado artificialmente.
• Rentabilidad: Evita tratar con números caros o no válidos en las primeras fases del proceso.
• Calidad de los datos: Preseleccione clientes potenciales y registros de clientes conociendo el origen del número.

Original Carrier es ideal para empresas que buscan agilizar las comunicaciones, reducir el tráfico artificial inflado y optimizar sus flujos de trabajo basados en números con inteligencia ligera.

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 el programa Original Carrier Insight mediante cURL.

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 visión del transportista original:

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

A continuación, la API devolverá información sobre la red a la que estaba asignado originalmente el número de teléfono, incluido el nombre, el tipo de red y el código de país:

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

Aquí, el status indica el estado de la información devuelta para el número de teléfono especificado:

Si status.code en la respuesta se indica que OK, también es posible que aparezcan los campos descritos en la tabla siguiente. Si un campo aparece marcado como «Sí» en la columna «Obligatorio», siempre se mostrará cuando el estado sea «OK». Si un campo aparece marcado como «No», puede que se muestre o puede que no.

Lecturas complementarias

• Para obtener más información sobre la API de Identity Insights, consulta la Referencia API.
• Si tiene alguna pregunta, puede ponerse en contacto con nosotros en el Comunidad de Vonage Slack.