Transportista actual

La información sobre el operador actual identifica el operador de red móvil asignado actualmente a un número de teléfono determinado. A diferencia de la información basada en la asignación original, esta función refleja la portabilidad de números y ofrece información actualizada sobre el operador al que está asociado un número de teléfono.

Esta información es esencial en situaciones en las que la eficacia de la comunicación, la capacidad de entrega y la verificación del usuario son fundamentales. Al confirmar si un número está asignado activamente a una red móvil, las empresas pueden garantizar un enrutamiento preciso de las comunicaciones basadas en SMS, voz o datos. Esto permite a las organizaciones evitar costes innecesarios e ineficiencias operativas asociadas al contacto con números desactivados (no asociados a ningún operador) o no móviles.

Uno de los principales casos de uso es la limpieza y actualización de las bases de datos de clientes, lo que garantiza que la información de contacto esté actualizada y sea válida. Por ejemplo, detectar que un número ya no está asignado a un operador de telefonía móvil puede ayudar a evitar mensajes fallidos, reducir los reintentos y mantener una alta calidad en la interacción con los usuarios. Además, favorece una comunicación respetuosa con la privacidad al centrarse en los números de móvil, que suelen ser más personales y es más probable que los utilice una persona, en comparación con los números fijos, virtuales o de tarificación especial.

En los procesos de prevención del fraude y verificación de la identidad, conocer el operador de telefonía móvil actual puede servir como señal para validar la legitimidad del usuario y reducir el riesgo.

Al aprovechar esta información, las empresas obtienen un mayor control sobre sus flujos de trabajo de comunicación, mejoran la experiencia del usuario y optimizan sus estrategias de interacción basándose en datos sobre números de teléfono en tiempo real.

Nota: esta información solo es aplicable a los números de móvil.

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 Current Carrier Insight mediante 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 información sobre el operador actual:

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

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

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "current_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:

Campo Descripción
status.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 correspondiente a este Insight.
UNSUPPORTED_NETWORK_TYPE: El tipo de red no es compatible con 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.
status.message Descripción más detallada del estado.

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.

Campo Descripción Obligatorio
name El nombre completo de la compañía aérea que phone_number con lo que está relacionado. Sí
network_type El tipo de red que phone_number está asociado. Siempre devolverá MOBILE. Sí
country_code Código de país de dos caracteres para phone_number. Esto está en ISO 3166-1 alfa-2 formato. Sí
network_code Indicativos móviles de país (MCC) + Indicativos móviles de red (MNC). E.212 Identidad internacional de abonado móvil. Sí

Lecturas complementarias