La herramienta de Validación de teléfonos es la solución informática para validar y normalizar números de teléfonos ya sean fijos o 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.
- Mediante interconexión con prestadoras de telefonía se solicita información de:
- Estado del teléfono.
- Tipo de Teléfono: Móvil / Fijo.
- Roaming Activado: SI / NO.
- Compañía Prestadora.
- Se asigna Descripción de Área Geográfica.
- Se consulta Titular de la línea (Opcional).
- Se consulta Teléfono en Registro NO LLAME.
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_gold
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_gold?token-susc=TOKENSUSC&token-api=TOKENAPI&phone=01111111111&country=AR&internalid=41
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: Incluye código de país, número nacional y fuente de código de país
- validnumber: Indica si un número es válido (1) o no.
- validnumberforregion: Indica si un número es válido o no en una región.
- possiblenumber: Número posible.
- isPossiblenumberwithreason: Número posible con motivo.
- phonenumberregion: Región del número de teléfono.
- phonenumertype: Indica si es un teléfono móvil o no.
- phoneformate164: Número de teléfono único internacional según formato E.164.
- phoneformatnational: Formato de teléfono nacional.
- phoneformatinternational: Formato internacional del número de teléfono.
- geolocation: Indica la ubicación geográfica del teléfono.
- iswhatsappnumber:
- result: es el resultado de la validación, devuelve más datos (los que menciona abajo).
- id:
- msisdncountrycode: Número de directorio de abonado internacional de la estación móvil Código de país.
- msisdn: Número de directorio de abonados internacional de la estación móvil.
- statuscode:
- hlrerrorcodeid:
- subscriberstatus: Estado de suscriptor.
- imsi:
- mccmnc:
- mcc:
- mnc:
- msin:
- servingmsc:
- servinghlr:
- originalnetworkname: Nombre de la red de origen.
- originalcountryname: Nombre del país de origen.
- originalcountrycode: Código del país de origen.
- originalcountryprefix: Prefijo del país de origen.
- originalnetworkprefix: Prefijo de red de origen.
- roamingnetworkname: Describe el nombre de la red de roaming.
- roamingcountryname: Nombre del país en itinerancia.
- roamingcountrycode: Código de país de itinerancia.
- roamingcountryprefix: Prefijo de país de itinerancia.
- roamingnetworkprefix: Prefijo de red de itinerancia.
- portednetworkname: Nombre de la red portada.
- portedcountryname: Nombre del país transferido.
- portedcountrycode: Código de país portado.
- portedcountryprefix: Prefijo de país transferido.
- portednetworkprefix: Prefijo de red portado.
- isvalid: Indica si un número es válido (1) o no.
- isported: Indica si es un número transferido.
- isroaming: Indica si es un número de roaming
- usercharge:
- inserttime:
- storage:
- route:
- interface:
- 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":"mobile","phoneformate164":"+541132624495","phoneformatnational":"011 3262-4495","phoneformatinternational":"+54 11 3262-4495","geolocation":"Buenos Aires","iswhatsappnumber":"missing_susc","result":[{"id":"52015ffc320c","msisdncountrycode":"AR","msisdn":"+541132624495","statuscode":"HLRSTATUS_DELIVERED","hlrerrorcodeid":null,"subscriberstatus":"SUBSCRIBERSTATUS_CONNECTED","imsi":"7223100000","mccmnc":"722310","mcc":"722","mnc":"310","msin":null,"servingmsc":null,"servinghlr":null,"originalnetworkname":"Claro Argentina (AMX Argentina S.A.)","originalcountryname":"Argentina","originalcountrycode":"AR","originalcountryprefix":"+54","originalnetworkprefix":"113262","roamingnetworkname":null,"roamingcountryname":null,"roamingcountrycode":null,"roamingcountryprefix":null,"roamingnetworkprefix":null,"portednetworkname":null,"portedcountryname":null,"portedcountrycode":null,"portedcountryprefix":null,"portednetworkprefix":null,"isvalid":"Yes","isported":"No","isroaming":"No","usercharge":"0.01000","inserttime":"2021-04-27 10:28:12.990-0300","storage":"CURL_API","route":"IP1","interface":"Sync API"}]}
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
Definición Técnica de la API: