Validate_Phone_Simple
Validation and standardization Phone Numbers
Proveedor: Sysworld
Fecha: 2019-05-23 09:20:01
developers, identity, locations, notifications, productivity, security, utilities
automotive, coorp, fintech, gov, insurance, pymes, retail, tech
- ID : 7419412600ae2a2a5ed0185a674f03fe
- Contexto : validations/phone/validate_simple
- Estado : Activa
La herramienta de Validación de teléfonos es la solución informática para validar y normalizar números de teléfonos móviles, nacionales o internacionales de forma simple y segura.
Años de trayectoria brindando soluciones al mundo empresarial y financiero, nos han permitido detectar la gran cantidad de teléfonos erróneos y sin normalizar que perjudican la comunicación con el destinatario. Destinos imposibles de contactar y dañinos que pueden provocar bloqueos y la introducción en listas negras por los proveedores de comunicaciones.
Muchos de estos teléfonos son recolectados de diferentes canales, para incluirlos en comunicaciones o acciones electrónicas comerciales, si el número falla entonces la comunicación con el destinatario fallará también.
Etapas de la Validación:
- Validación de sintaxis del Teléfono: Se validan la cantidad de dígitos, se asigna país de defecto y área predeterminada.
- Normalización del número: Se estandariza el número de teléfono separando País, Área, Número.
- Se consulta línea asignada mediante datos oficiales ENACOM.
- Se asigna Descripción de Área Geográfica.
Información adicional de valor agregado:
Gracias a nuestra alianza estratégica con Buro de Datos se podrían enriquecer datos de valor agregado:
- Titular de la línea
- DNI / CUIT / CUIL
- Datos de valor agregado con servicio de validación y normalización de identidad.
Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:
- Endpoint: https://cont1-virtual1.certisend.com/web/container/api/v1/validations/phone/validate_simple
Parámetros:
- token-susc: Token obtenido al momento de la suscripción a nivel empresa.
- token-api: Token obtenido al momento de la suscripción a nivel API.
- phone: Número de teléfono a validar (solo números).
- country: Código ISO del país (ie: AR para Argentina).
- internalid: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.
La llamada quedaría de la siguiente manera:
https://cont1-virtual1.certisend.com/web/container/api/v1/validations/phone/validate_simple?token-susc=TOKENSUSC&token-api=TOKENAPI&phone=01111111111&country=AR&internalid=39
Una vez realizada la llamada van a recibir los siguientes parámetros:
- state: Tendrá el valor 0 para un parámetro faltante y un 1 en el caso de que se encuentre información.
- desc: Descripción del parámetro "state" recibido.
- phonenumber: número de teléfono con el código de su país incluido.
- validnumber: Indica si el número ingresado es válido(1), o si no lo es(null).
- validnumberforregion: Indica si el código de región ingresado es válido(1), o si no lo es(null).
- possiblenumber: Es un número posible
- isPossiblenumberwithreason: Es un número posible con motivo.
- phonenumberregion: Región de número de teléfono en código de país iso.
- phonenumertype: Tipo de número de teléfono(móvil) o desconocido(consulte API gold).
- phoneformate164: Formato general para números de teléfono internacionales.
- phoneformatnational: El número ingresado en formato nacional.
- phoneformatinternational: El número ingresado en formato internacional.
- geolocation: Ubicación geográfica.
- id_internal: ID interno ingresado por el cliente.
Respuestas de Ejemplo:
Negativa:
{"state":"0","desc":"invalid country.","id_internal":"0"}
Positiva:
{"state":"1","phonenumber":"Country Code: 54 National Number: 1132624495 Country Code Source: 3","validnumber":"1","validnumberforregion":"1","possiblenumber":"1","isPossiblenumberwithreason":"0","phonenumberregion":"AR","phonenumertype":"consult_gold","phoneformate164":"+541132624495","phoneformatnational":"011 3262-4495","phoneformatinternational":"+54 11 3262-4495","geolocation":"Buenos Aires"}
Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test