HLR Lookup para verificar números móviles antes de enviar
Consulta el estado, la red y la portabilidad de tus contactos, elimina números no válidos y mejora la eficiencia de tus campañas de SMS y voz.
- Comprueba el estado técnico de los números móviles
- Identifica la operadora original y la red actual cuando existe portabilidad
- Distingue entre errores temporales y permanentes
- Consulta grupos desde el panel o integra el servicio mediante API
La consulta se realiza sin contactar con el destinatario
HLR Lookup no envía ningún SMS ni realiza una llamada al número consultado, por lo que el proceso no resulta visible para el usuario.
Qué es HLR Lookup y qué permite comprobar
HLR Lookup consulta información técnica asociada a un número móvil para conocer su estado, su red y si ha sido portado antes de iniciar una comunicación.
El HLR —Home Location Register— es una base de datos utilizada por las redes móviles para administrar la información de sus abonados. La consulta permite comprobar datos técnicos del número sin enviar un mensaje ni realizar una llamada.
El resultado ayuda a decidir qué contactos conviene conservar, revisar o excluir. También permite actualizar la operadora asociada a un número portado y mejorar la calidad de los datos utilizados por campañas, aplicaciones y CRM.
MSISDN
Es el número de teléfono móvil que se envía para realizar la consulta.
IMSI
Es un identificador técnico del abonado o de la SIM que puede estar disponible en el resultado.
Red móvil
Los códigos MCC y MNC permiten identificar el país y la red asociados al número.
Verifica tus contactos antes de una campaña
Utiliza la información HLR para mantener una base de datos más precisa, reducir intentos innecesarios y tomar mejores decisiones de segmentación y envío.
Limpia tu base de datos
Localiza números con errores permanentes antes de utilizarlos y evita conservar indefinidamente contactos que necesitan revisión.
Mejora la eficiencia
Reduce intentos dirigidos a números no disponibles y concentra la campaña en contactos con un resultado técnico adecuado.
Identifica país y operadora
Consulta los códigos de red, el país y la operadora original asociados al número móvil.
Detecta portabilidades
Comprueba si el número ha cambiado de operadora y consulta la red de destino cuando la información está disponible.
Clasifica los errores
Diferencia incidencias temporales de errores permanentes para decidir si debes volver a consultar o revisar el contacto.
Automatiza mediante API
Integra HLR Lookup en tu CRM, aplicación o proceso de calidad de datos mediante una petición HTTP.
Ver API HLR LookupCómo comprobar números desde el panel
Revisa un grupo de contactos y utiliza el resultado para depurar o segmentar la base de datos antes de enviar.
- 01
Selecciona el grupo
Accede al panel de cliente y abre el grupo de contactos que quieres revisar.
- 02
Ejecuta la consulta
Pulsa «Comprobar estado» para solicitar la información HLR de los números seleccionados.
- 03
Interpreta el resultado
Revisa el estado, la operadora, la portabilidad y los posibles errores de cada número.
- 04
Actualiza la lista
Separa los números disponibles y revisa los errores temporales o permanentes antes de realizar la campaña.
Cuándo utilizar una consulta HLR
Incorpora la validación técnica del número en los puntos donde la calidad de los datos influye en el coste, la entrega o la operación.
Antes de campañas masivas
Revisa una lista antes de enviar SMS y aparta los números que requieren atención.
Altas y formularios
Comprueba técnicamente el número antes de incorporarlo al CRM o a una base de clientes.
Mantenimiento del CRM
Audita periódicamente los teléfonos almacenados y mejora la calidad de los registros.
Operadora y portabilidad
Actualiza la red asociada a los contactos para análisis, segmentación o enrutamiento.
Mensajes transaccionales
Revisa el destino antes de comunicaciones importantes u operaciones de verificación.
Reactivación de contactos
Comprueba listas antiguas antes de volver a utilizarlas en una comunicación autorizada.
Cómo integrar la API HLR Lookup de Afilnet
Envía los números en formato internacional, recibe un resultado por cada contacto y utiliza los campos devueltos para actualizar tu sistema.
- 01
Prepara los números
Normaliza cada teléfono con su prefijo internacional y sepáralos mediante comas.
- 02
Realiza la petición
Llama al método checkphonenumbers con tus credenciales y el listado que deseas comprobar.
- 03
Procesa la respuesta
Lee el estado, la red original, la portabilidad y los errores devueltos para cada número.
- 04
Actualiza tu sistema
Clasifica los resultados y sincroniza la información con tu CRM o flujo de envío.
Parámetros de la petición
- class
- Utiliza el valor hlr para acceder al servicio de consulta.
- method
- Utiliza checkphonenumbers para comprobar uno o varios números.
- user y password
- Credenciales de la cuenta de Afilnet que realiza la petición.
- numbers
- Números con prefijo internacional separados por comas.
Ejemplo de petición HTTP
GET https://www.afilnet.com/api/http/
?class=hlr
&method=checkphonenumbers
&user=TU_USUARIO
&password=TU_CLAVE
&numbers=34600111222,34600333444Qué información devuelve HLR Lookup
La respuesta reúne los datos necesarios para identificar el número, su red, la portabilidad y el resultado técnico de la comprobación.
| Campo | Qué indica | Cómo utilizarlo |
|---|---|---|
| number | Número normalizado sobre el que se ha realizado la consulta. | Relaciona el resultado con el contacto de tu sistema. |
| mccmnc | Códigos que identifican el país y la red móvil. | Clasifica el número por mercado y operadora. |
| imsi | Identificador técnico internacional del abonado o SIM, cuando está disponible. | Conserva la referencia técnica devuelta por la red. |
| onname, onprefix y oncountry | Nombre, prefijo y país de la operadora original. | Identifica la red a la que se asignó inicialmente el número. |
| ported | Indica si el número ha sido portado. | Decide si debes utilizar la información de la operadora de destino. |
| portedname, portedprefix y portedcountry | Nombre, prefijo y país de la red de portabilidad. | Actualiza la operadora asociada al contacto cuando corresponda. |
| status y statusname | Grupo y nombre del estado devuelto por la consulta. | Interpreta el resultado técnico de disponibilidad. |
| error y permanent_error | Motivo del error y si su naturaleza es permanente. | Diferencia entre volver a comprobar el contacto o revisarlo. |
Cómo interpretar el resultado de una consulta HLR
El resultado es una señal técnica sobre el número y su red. Debe combinarse con las reglas de negocio, el consentimiento y el estado real de cada comunicación.
Número disponible
La consulta no ha devuelto un error que impida considerar el número disponible en ese resultado.
Error temporal
Puede corresponder a una incidencia transitoria. No elimines automáticamente el contacto; valora comprobarlo de nuevo.
Error permanente
Revisa o excluye el número según el motivo recibido y la política de calidad de datos de tu organización.
Número portado
Utiliza la red de portabilidad como operadora actual cuando la respuesta la incluya.
No es geolocalización
Los datos de país y red no permiten conocer la posición exacta del teléfono ni de su propietario.
No acredita identidad ni consentimiento
HLR no demuestra quién controla el número ni autoriza el envío de comunicaciones comerciales.
Una consulta HLR satisfactoria no garantiza la entrega final de un SMS. La cobertura, el terminal, la red y otros factores posteriores también pueden afectar al resultado del envío.
Empieza a comprobar tus números con HLR Lookup
Revisa grupos desde el panel de Afilnet o automatiza la consulta desde tu aplicación mediante la API HLR Lookup.
Preguntas frecuentes sobre HLR Lookup
Resolvemos las dudas habituales sobre el estado de los números, las operadoras, la portabilidad y la integración mediante API.
¿Qué es una consulta HLR?
Es una consulta técnica que permite obtener información sobre el estado, la red y la portabilidad de un número móvil sin enviarle un mensaje.
¿Cómo puedo comprobar el estado de un número móvil?
Puedes ejecutar HLR Lookup desde un grupo de contactos en el panel de Afilnet o enviar el número mediante la API. La respuesta incluye el estado técnico y los posibles errores.
¿La consulta envía un SMS o realiza una llamada?
No. La comprobación se realiza sin enviar un SMS ni llamar al número, por lo que el usuario no recibe una notificación de la consulta.
¿Puedo conocer la operadora actual de un número?
La respuesta identifica la operadora original y señala si el número ha sido portado. Cuando está disponible, también devuelve los datos de la red de destino.
¿HLR Lookup permite localizar un teléfono?
No. La consulta puede proporcionar información técnica de país y red, pero no la ubicación exacta del terminal ni de su propietario.
¿Qué diferencia existe entre un error temporal y uno permanente?
Un error temporal puede corresponder a una incidencia transitoria y permite valorar una nueva consulta. Un error permanente normalmente aconseja revisar o excluir el número.
¿Puedo consultar varios números?
Sí. Desde el panel puedes comprobar un grupo de contactos y mediante la API puedes enviar varios números con prefijo internacional separados por comas.
¿Una respuesta disponible garantiza la entrega del SMS?
No. La consulta mejora la selección técnica de destinatarios, pero la entrega final también depende de la cobertura, el terminal, la red y otros factores del envío.