Formato

Format Insight es una herramienta de validación fundamental que comprueba si un número de teléfono está estructurado correctamente y si puede asignarse a un abonado. Garantiza que el número cumpla con las normas internacionales de marcación, identifica el país asociado y determina la zona horaria correspondiente. Esta información no confirma si el número está actualmente activo o en uso, pero constituye un primer paso crucial para evaluar la validez técnica de cualquier número de teléfono internacional.

Al analizar la sintaxis del número y la estructura del prefijo, Format Insight ayuda a identificar si el número pertenece a un rango de numeración válido en un país concreto. También señala los números obviamente no válidos o mal formados, lo que permite a las organizaciones limpiar los datos antes de utilizarlos con fines operativos o de marketing.

La integración de la información de «Formato» en tus aplicaciones puede resultar útil en diversos casos, entre los que se incluyen:

• Calidad y limpieza de datos: Format Insight es ideal para depurar bases de datos históricas de clientes. Filtra los números con formato incorrecto o claramente inválidos, lo que ayuda a mantener unos altos estándares de calidad de los datos y mejora la capacidad de contacto en general.
• Validación en tiempo real en la entrada: Las empresas pueden integrar esta información en formularios web o sistemas CRM para validar los números de teléfono a medida que se introducen, lo que reduce el riesgo de errores de introducción y garantiza que sólo se almacenen los números con el formato adecuado.
• Segmentación y localización: Conocer el país y la zona horaria asociados a un número permite a las empresas adaptar sus comunicaciones, programar la difusión en las franjas horarias adecuadas y cumplir la normativa local.
• Optimización de costes: Evite interactuar con números no válidos que, de otro modo, darían lugar a intentos de entrega fallidos, esfuerzos operativos desperdiciados y costes innecesarios en SMS, voz o flujos de trabajo de prevención del fraude.

En resumen, Format Insight ofrece una forma de validar números de teléfono internacionales a gran escala, con baja latencia y alta fiabilidad. Se trata de un elemento fundamental en cualquier proceso de análisis de números de teléfono, ya que sienta las bases para comprobaciones más avanzadas, como la información sobre operadores y las características de la red, con el fin de analizar el riesgo de fraude.

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 Format Insight mediante programación con 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 que Format insight devuelva información útil basada en el número de teléfono proporcionado:

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

A continuación, la API comprueba que el formato del número de teléfono se ajuste a los prefijos, la longitud y los patrones admitidos en cada país, y devuelve información adicional, como el código de país, las zonas horarias, la ubicación fuera de línea asignada al número y los formatos local e internacional del número:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "format": {
        "country_code": "US",
        "country_name": "United States",
        "country_prefix": "1",
        "offline_location": "Georgia",
        "time_zones": [
          "America/New_York"
        ],
        "number_international": "+14040000000",
        "number_national": "(404) 000-0000",
        "is_format_valid": true,
        "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.