Accesibilidad

Reachability Insight, que proporciona información en tiempo real directamente de las operadoras de telefonía móvil, puede utilizarse para comprobar el estado de conectividad de un dispositivo determinado, incluido si está conectado a la red para datos, SMS o ambos.

Las principales ventajas son:

  • Mejora de la experiencia del usuario mediante el envío de comunicaciones pertinentes: Determine la accesibilidad de un cliente y envíele la comunicación pertinente, por SMS o datos.
  • Gestión de bases de datos de registros de clientes: Determine con qué clientes hay que ponerse en contacto para actualizar su número de teléfono, por ejemplo si un usuario determinado no ha tenido conectividad de datos o SMS en los últimos 60 días.
  • Diagnóstico y supervisión remotos y rápidos de dispositivos IoT: Detecte qué dispositivos están desconectados y, si es así, cuándo se conectaron por última vez, y obtenga información a distancia sobre qué dispositivos requieren mantenimiento.

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.

Esta guía explicará cómo utilizar Reachability Insight mediante programación utilizando 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 petición cURL a Reachability insight para comprobar si, y cómo, un dispositivo dado está conectado a la red móvil:

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+990123400",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "reachability": {}
        }
    }'

A continuación, la API devolverá información sobre la accesibilidad de ese dispositivo, incluida una confirmación de la accesibilidad actual y los tipos de tráfico disponibles (actualmente se admiten SMS y datos):

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "reachability": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_reachable": true,
        "connectivity": ["DATA", "SMS"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
  }
}

Verá los siguientes campos en roaming matriz:

Campo Descripción
latest_status_at Última vez que se actualizó el estado de conectividad del dispositivo asociado.
is_reachable Indica la accesibilidad general del dispositivo - será true si el dispositivo está conectado a la red.
connectivity Indica si el dispositivo está conectado a la red para DATA o SMS uso. Sólo se devolverá si is_reachable es true.
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