Transportista original

La información sobre el operador original brinda información de baja latencia sobre el operador y el tipo de red originalmente asociados con un número de teléfono, usando la inteligencia de plan de numeración patentada de Vonage. Ofrece metadatos sin necesidad de realizar consultas en tiempo real a proveedores u operadores externos, lo que lo hace rápido y fiable para muchos 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.

Las principales ventajas son:

  • Señales de riesgo de fraude: Detecte tipos de números virtuales, premium o de alto riesgo que puedan indicar suplantación de identidad o tráfico inflado artificialmente.
  • Rentabilidad: Evite comprometerse con números caros o no válidos al principio 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 una Account,
  • Creación de una aplicación de Vonage para su uso con la API Identity Insights,
  • Los diferentes entornos disponibles y cómo configurar su Account para utilizarlos,
  • Y cómo utilizar la interfaz de usuario de inicio del panel de control para utilizar la API sin escribir ningún código.

En esta guía se explica cómo utilizar el programa Original Carrier Insight mediante cURL.

La API Identity Insights está disponible a través de varios puntos finales regionales. Los ejemplos de esta guía utilizan el punto final de la UE, pero puede 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íneao, alternativamente, utilice el botón 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"
        }
    }
  }
}

Verá los siguientes campos en original_carrier matriz:

Campo Descripción
name El nombre completo del transportista original asociado al phone_number proporcionado. Esto sólo es aplicable a los números de móvil.
network_type El tipo de red que phone_number está asociado con. Será uno de:

MOBILE: Número asignado a un dispositivo móvil que normalmente puede enviar y recibir llamadas de voz y mensajes de texto (SMS).
LANDLINE: Número de teléfono fijo vinculado a una ubicación física, utilizado principalmente para llamadas de voz y que normalmente no puede recibir mensajes SMS.
TOLLFREE: Número que permite ponerse en contacto con una empresa o un servicio sin tener que pagar por la llamada.
PREMIUM: Numbers de tarifa alta que cobran un suplemento a la persona que llama. Suelen utilizarse para contenidos o servicios especializados, como líneas de votación o de información.
VIRTUAL: Un número basado en la nube que no está vinculado a una tarjeta SIM ni a un dispositivo concretos, y que suele gestionarse a través de aplicaciones o plataformas en línea (por ejemplo, Google Voice).
country_code Código de país de dos caracteres para phone_number. Esto es en ISO 3166-1 alfa-2 formato.
network_code Indicativos móviles de país (MCC) + Indicativos móviles de red (MNC). E.212 Identidad internacional de abonado móvil.
status Indica el estado de la información devuelta para el número de teléfono especificado.
code Código que indica el estado de la solicitud. Debe ser uno de los siguientes:

NO_COVERAGE: El país o la red móvil no son compatibles con los proveedores disponibles.
INVALID_PURPOSE: El propósito utilizado no es válido o no está permitido para este Insight.
UNAUTHORIZED: No se ha podido autorizar la solicitud para la combinación de solicitud, proveedor y número de teléfono.
INTERNAL_ERROR: Se ha producido un error interno al procesar la solicitud.
SUPPLIER_ERROR: El proveedor ha devuelto un error al procesar la solicitud.
NOT_FOUND: No se ha podido encontrar el número de teléfono para este Insight.
INVALID_NUMBER_FORMAT: El formato de número de teléfono no es válido para que las operadoras lo asignen a los usuarios.
OK: La entrada se ha procesado correctamente.
message Descripción más detallada del estado.

Lecturas complementarias