En este artículo vas a aprender como utilizar la API HLR Lookup para validar números de teléfono en tiempo real. Verás como realizar validaciones individuales, masivas mediante ficheros y a automatizar los procesos para crear un validador de números mediante el API. Veremos varios ejemplos de código, nos centraremos en algunos lenguajes como PHP y JavaScript. Por último veremos como utilizar la documentación del API de verificación de números de teléfono.
¿Qué es una API REST?
Una API REST (Application Programming Interface Representational State Transfer) es una forma de comunicación entre sistemas que utiliza las convenciones de HTTP. Imagina que es un mensajero que lleva solicitudes y respuestas entre tu aplicación y un servidor. Las APIs REST son ampliamente utilizadas debido a su simplicidad y eficiencia.
Componentes principales de una API REST
- Recursos: Representan datos, como usuarios o productos.
- Verbos HTTP: Métodos como GET, POST, PUT y DELETE para interactuar con los recursos.
- Endpoints: URLs que indican dónde se encuentra un recurso específico.
- Formato de Datos: Usualmente JSON o XML.
Ejemplo práctico: Verificación de números de teléfono con HLR Lookup
La verificación de números de teléfono mediante HLR Lookup (Home Location Register Lookup) permite saber si un número es válido y está activo. Esto es útil para empresas que desean asegurarse de que sus mensajes lleguen a los destinatarios correctos.
Proceso de verificación
- Envías una solicitud con el número de teléfono a la API de HLR Lookup.
- La API de validación consulta la base de datos HLR del operador de telefonía.
- Recibes una respuesta que indica el estado del número de teléfono.
Implementación paso a paso usando la API de verificaremails.com
- Regístrate en verificaremails.com y obtén tu clave API.
- Envía una solicitud GET a la API de validación HLR Lookup.
curl -X GET "https://www.verificaremails.com/api/v1/hlr?phone_number=1234567890" -H "apikey: TU_CLAVE_API"
- Interpreta la respuesta. Un ejemplo de respuesta puede ser:
{
"status": "success",
"data": {
"phone_number": "1234567890",
"valid": true,
"carrier": "Movistar",
"country": "ES"
}
}
Podemos obtener más información sobre el número de teléfono en especil si es un número móvil en el fichero JSON de la respuesta.
Formato de la respuesta
Si entramos en detalle, a parte de indicarnos si el número es válido o inválido, podemos obtener información sobre el operador de telefonía, el tipo de línea, el formato internacional del número… Si lo que buscáis es saber si el número es válido os debéis fijar en los campos IMSI, MCC, MNC y MCCMNC. Todas estas comprobaciones las realiza el api de validación y las muestra en el valor del campo «reachable».
IMSI
El IMSI (International Mobile Subscriber Identity) es un número único asociado a cada usuario de red móvil. Este número se almacena en la tarjeta SIM y es utilizado por las redes móviles para identificar a los suscriptores.
Componentes del IMSI
El IMSI se compone de tres partes:
- MCC (Mobile Country Code): Código de tres dígitos que identifica el país del suscriptor.
- MNC (Mobile Network Code): Código de dos o tres dígitos que identifica la red móvil dentro de ese país.
- MSIN (Mobile Subscriber Identification Number): Número único que identifica al suscriptor dentro de la red móvil.
MCC y MNC
- MCC: Cada país tiene un MCC único. Por ejemplo, España tiene el MCC 214.
- MNC: Las operadoras dentro de un país tienen diferentes MNC. Por ejemplo, en España, Movistar tiene el MNC 07.
MCCMNC
El MCCMNC es la combinación del MCC y el MNC. Es utilizado para identificar de manera única a una red móvil en un país. Por ejemplo, el MCCMNC para Movistar en España sería 21407.
Verificación de Números de Teléfono
Para verificar si un número de teléfono es verdadero usando el IMSI:
- Obtener el IMSI: Extraer el IMSI de la tarjeta SIM del teléfono.
- Analizar el IMSI:
-
- Extraer el MCC y el MNC del IMSI.
- Verificar que el MCC corresponde al país esperado.
- Verificar que el MNC corresponde a una operadora válida en ese país.
- Validación:
-
- Comprobar que el MCCMNC existe y es válido.
- Asegurarse de que el MSIN es correcto y está activo en la red.
Ejemplo
Si tienes un IMSI 214071234567890, puedes desglosarlo así:
- MCC: 214 (España)
- MNC: 07 (Movistar)
- MSIN: 1234567890 (Identificador único del suscriptor)
Al verificar el MCC y el MNC, puedes confirmar que el número de teléfono pertenece a un suscriptor de Movistar en España, lo cual ayuda a validar su autenticidad.
{
«id»: «364215»,
«term»: «34677934019»,
«request_id»: «364215»,
«result_code»: «101»,
«result_type»: «Conectado»,
«result»: {
«phone_number»: «+34677934019»,
«number_type»: «mobile»,
«timezone»: «Atlantic/Canary»,
«format»: {
«e164»: «+34677934019»,
«international»: «+34 677 93 40 19»,
«national»: «677 93 40 19»,
«rfc3966»: «tel:+34-677-93-40-19»
},
«is_ported»: true,
«reachable»: «connected»,
«processing_status»: «completed»,
«imsi»: «214040000000000»,
«current_network»: {
«country_iso2»: «ES»,
«country_prefix»: «34»,
«country_name»: «Spain»,
«mccmnc»: «21404»,
«mcc»: «214»,
«mnc»: «04»,
«area»: «ES»,
«network_name»: «Yoigo»
},
«original_network»: {
«country_iso2»: «ES»,
«country_prefix»: «34»,
«country_name»: «Spain»,
«mccmnc»: «21401»,
«mcc»: «214»,
«mnc»: «01»,
«area»: «ES»,
«network_name»: «Vodafone»
}
}
}
Cómo crear un validador de un número de teléfono con PHP
Para facilitar la utilización del validador de teléfonos en tus formularios y aplicaciones, hemos creado una librería POSTMAN donde podrás descargarte las llamadas del api así como ejemplos de código. En el caso de nuestro ejemplo, silo que queremos es realizar una llamada en PHP, debemos seleccionar este lenguaje dentro de la colección de Postman y la propia aplicación nos generará la llamada en PHP para validar un número de teléfono.
Por que validar los números de teléfonos
Captar leads es caro y cada día lo va a ser más. Se estima que entre un 8-12% de los teléfonos captados en formularios o durante procesos de registros son erróneos. La verificación de datos en el punto de captación permite detectar estos errores y mejorar las tasas de registro.
Una vez el lead es captado entra en un «funnel de ventas» para su explotación. Si el número de teléfono es erróneo, estaremos destinando recursos que nunca van a obtener un retorno. Nuestro consejo es verificar todos los teléfonos en el punto de captación, pero si no lo has hecho, al menos verifica la BBDD para tener una imagen real de tus clientes potenciales.
Conclusiones
Hemos visto las distintas formas de validar números de teléfono. Hemos visto que este servicio esta indicado para la verificación de números móviles durante los procesos de registro mejorando la calidad d elos datos y evitando la captación de teléfonos inválidos. Recordar que podéis aplicar la validación HLR Lookup a teléfonos individuales, de forma masiva a ficheros aglutinando un voluen alto de números o automatizando el proceso con el API de validación de números.
Os recomendamos que reviséis la documentación del API de validación teléfonos para las distintas llamadas y si queréis tener acceso a las librerías de validación en los distintos lenguajes de programación. Aunque las llamadas del API son Rest, siempre os va a facilitar la integración del servicio.
