Una API de validación de números de teléfono comprueba un número antes de enviarle un mensaje o llamarlo. Según el nivel, confirma el formato y el país, identifica el tipo de línea y el operador actual (MNP lookup) y consulta a la red móvil si el número está activo (HLR lookup). Los remitentes la usan para depurar listas, enrutar a la red correcta, bloquear registros de riesgo y no pagar por mensajes que no se pueden entregar.
¿Qué devuelve una API de validación de números de teléfono?
Las consultas se organizan por niveles, y cada uno cuesta más y tarda más que el anterior:
| Nivel | Cómo funciona | Devuelve | Velocidad y coste |
|---|---|---|---|
| Validación del formato | Reglas de los planes de numeración nacionales | Válido o no, país, forma E.164, tipo posible | Instantánea, a menudo gratuita (librerías open source) |
| Tipo de línea y operador | Bases de datos de rangos de numeración y de operadores | Móvil, fijo, VoIP, gratuito; operador original | Rápida, bajo coste |
| MNP lookup | Bases de datos de portabilidad numérica | Operador actual tras la portabilidad, MCC/MNC | Rápida, bajo coste, no disponible en todos los países |
| HLR lookup | Consulta en tiempo real al registro de abonados de la red móvil | Activo o no, red actual, a veces estado de roaming | Más lenta, el coste más alto; solo números móviles |
Las comprobaciones de formato deben estar en todos los formularios. Las de operador y tipo de línea compensan en el registro y para el enrutamiento. El HLR es para comprobaciones de alto valor y para depurar listas. Los detalles están en el HLR lookup explicado y la consulta de números VoIP.
Validación vs verificación del número de teléfono: ¿qué diferencia hay?
La validación comprueba el número: si es real, de qué tipo es, a qué red pertenece. La verificación comprueba a la persona: demuestra que controla el número introduciendo un código enviado por SMS o por voz. Un buen flujo de registro hace las dos cosas, en ese orden: primero valida, para no enviar OTP a números no válidos, fijos o de riesgo, y después verifica con un OTP. Consulte las buenas prácticas para SMS OTP.
¿Para qué se usa una API de HLR lookup?
- Depurar listas: eliminar los números inactivos antes de una campaña para no pagar por mensajes que no se pueden entregar.
- Enrutamiento: enviar cada mensaje por la ruta de la red actual del abonado, usando los códigos MCC y MNC.
- Controles antifraude: marcar en el registro los números que no están activos o no están en una red móvil.
- Diagnosticar la entrega: cuando un mensaje falla, comprobar si el número existe antes de culpar a la ruta.
Los registros que hay detrás de estas consultas se explican en HLR vs VLR.
Cómo elegir una API de validación de números de teléfono
- Cobertura por país: la calidad de los datos MNP y HLR varía mucho entre países; pida la cobertura país por país, no una promesa global.
- Actualidad de los datos: cada cuánto se actualizan los datos de operador y de portabilidad.
- Precisión con su tráfico: pruebe una muestra de números conocidos de sus propios usuarios.
- Latencia: las comprobaciones en el registro necesitan respuestas en mucho menos de un segundo; el HLR puede tardar más.
- Modelo de precios: por consulta, por nivel; compruebe si se cobran las consultas fallidas o servidas desde caché.
- Privacidad: dónde se procesan las consultas y cuánto tiempo se guardan los números.
Dónde usar la validación en su flujo
- En el formulario: comprobación del formato mientras el usuario escribe, con el país preseleccionado, y guarde los números en formato E.164.
- Al enviar el formulario: consulta de tipo de línea y operador; bloquee los rangos de tarificación especial y aplique su política para los números VoIP.
- Antes del OTP: límites de frecuencia por número, IP y dispositivo, y después envíe el código por SMS, o por voz para los fijos.
- Antes de las campañas: HLR o MNP lookup sobre listas antiguas para eliminar los números inactivos y enrutar a la red correcta.
¿Es legal validar números de teléfono?
Comprobar el formato y el operador de sus propios usuarios y contactos es una práctica habitual. El HLR y otras consultas similares a la red devuelven un estado técnico, no la identidad del titular, pero aun así trata datos personales, así que necesita una base legal y debe cumplir la normativa de privacidad (por ejemplo el RGPD en la UE). No use las consultas para elaborar perfiles de personas ni para crear listas de números con los que no tiene ninguna relación.
Combine la validación con buenas rutas
La validación reduce el desperdicio, y la ruta adecuada entrega lo que queda. VoIPMatcher obtiene rutas SMS A2P de sus carriers y las gestiona por usted. Solicite una ruta SMS.
Preguntas frecuentes
¿Existe una API gratuita de validación de números de teléfono?
La validación del formato puede ser gratuita: librerías open source como libphonenumber de Google comprueban el formato del número y el tipo posible sin conexión. Los datos de operador, portabilidad y HLR proceden de bases de datos de pago y de consultas a la red, así que las API que los devuelven suelen cobrar por consulta, a veces con una pequeña prueba gratuita.
¿Qué diferencia hay entre un HLR lookup y un MNP lookup?
Un MNP lookup consulta las bases de datos de portabilidad para saber el operador actual de un número. Un HLR lookup consulta el registro de abonados de la red móvil y además puede indicar si el número está activo. El MNP es más rápido y barato; el HLR da el estado en tiempo real, pero solo para números móviles.
¿Una API de validación puede saber si un número tiene WhatsApp?
Las API de validación estándar devuelven datos de telecomunicaciones como el formato, el tipo de línea, el operador y el estado en la red. Saber si un número usa una app de mensajería no forma parte de las consultas de telecomunicaciones, y comprobarlo sin consentimiento puede incumplir las condiciones de la app y las normas de privacidad.
¿Qué precisión tiene la validación de números de teléfono?
Las comprobaciones de formato son muy precisas. Los datos de tipo de línea y operador suelen ser fiables para distinguir móvil de fijo, pero menos para las categorías VoIP y para números portados o asignados recientemente. Los resultados HLR son en tiempo real, pero pueden fallar cuando las redes restringen las consultas. Pruebe cualquier proveedor con sus propios números.
¿Necesita una ruta?
Envíe el destino, el tipo de ruta y la tarifa objetivo. Le respondemos con lo que podemos ofrecer.