Verificá operador y estado de línea en una API
La consulta valida formato, tipo de línea y operador con Telnyx. Cuando necesitás conocer el estado actual de un móvil, sumá HLR con live:true.
Qué incluye
Normalización E.164
Normalizamos a formato internacional (+54911...) para que el resto del sistema trabaje con un formato consistente.
País por prefijo o default
Si viene con +, usamos el prefijo. Si no, usás el parámetro country para que lo interpretemos como ese país.
Tipo de línea real
Móvil, fijo, VoIP de consumo (apps de segundo número), VoIP empresarial, 0800, premium rate, con detección de VoIP descartable.
Operador (Telnyx)
Carrier real, portabilidad (está portado del operador original a otro) y mobile network codes MCC/MNC cuando aplica.
Línea en vivo (HLR)
Consulta en tiempo real a la red celular: connected/absent/unknown + roaming y red actual.
Patrones sospechosos
Dígitos repetidos (111111), secuencias (123456), teclado (258014), baja entropía — típicos de datos inventados.
WhatsApp probable
Estimación por tipo de línea y región. No consulta WhatsApp; es señal, no confirmación.
Blacklist propia
Agregás números no deseados a tu lista; se cortan antes de consultar al proveedor y no se cobran.
Cómo lo hacemos
Normalización
Pasamos el número a E.164 usando el prefijo internacional o el country que mandes como default.
Validación de formato
Reglas de numeración del país + patrones sospechosos (repetidos, teclado, baja entropía). Si no es válido, no cobra.
Lookup de operador
Para números válidos consultamos Telnyx: carrier, portabilidad, tipo de línea y MCC/MNC cuando están disponibles.
Línea en vivo (opcional)
Si pedís live:true, Neutrino hace la consulta HLR a la red celular: connected/absent/unknown + roaming. Solo celulares; fijos y VoIP no se cobran.
En código
cURLcurl -X POST https://api.byebouncer.com/api/v1/verify-phone \ -H "Authorization: Bearer $BYEBOUNCER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"phone":"+5491141235678","live":true}'
Node / TypeScriptimport { ByeBouncer } from '@bye_bouncer/sdk'; const bb = new ByeBouncer({ apiKey: process.env.BYEBOUNCER_API_KEY! }); const scored = await bb.verifyPhone('+5491141235678'); console.log(scored.status, scored.carrier);
Elegí la profundidad de la consulta
| Operador (3 cr) | Operador + HLR (hasta 9 cr) | |
|---|---|---|
| Formato E.164 y país | Sí | Sí |
| Tipo de línea | Sí | Sí |
| Carrier real | Sí | Sí |
| Portabilidad | Sí | Sí |
| Puntaje 0-100 | Sí | Sí |
| Patrones sospechosos | Sí | Sí |
| Estado actual del móvil | No | Sí, si está disponible |
Preguntas frecuentes
¿Qué incluye la consulta de operador?
Primero validamos formato y país. Para números válidos consultamos Telnyx y devolvemos carrier, portabilidad, tipo de línea y un puntaje de calidad. Cuesta 3 créditos.
¿Cuándo conviene agregar HLR?
Antes de llamar o enviar un mensaje a un móvil, si necesitás conocer su estado actual. Enviá live:true; la consulta HLR puede sumar hasta 6 créditos adicionales cuando aplica.
¿La línea en vivo funciona con fijos o VoIP?
No. HLR es un protocolo de redes celulares. Para teléfonos fijos devolvemos "fixed_line" (y no se cobra), para VoIP "voip" (y no se cobra). Para móviles devolvemos connected/absent/unknown con el detalle de portabilidad y roaming.
¿Qué significa "prendido y con señal" exactamente?
Que la red celular ve el dispositivo registrado y alcanzable en este instante. No significa que la persona vaya a atender ni que el número le pertenezca; es un chequeo de infraestructura, no de voluntad.
¿Si el teléfono está apagado es porque es falso?
No. Devolvemos "absent" (ausente): el número es real, pero el dispositivo está apagado o fuera de cobertura ahora. Probá de nuevo más tarde en lugar de descartar el contacto.
¿Cuánto demora una consulta de línea en vivo?
La consulta HLR depende de la red del operador y puede tardar más que la validación de formato o el lookup de operador. Definí el timeout de tu integración según tu caso de uso.
¿Soportan WhatsApp?
Damos una estimación de probabilidad de WhatsApp basada en tipo de línea y región ("likely", "possible", "unlikely"). No consultamos a WhatsApp directamente — para confirmación activa necesitás un proveedor BSP.
¿Qué pasa con los números inválidos?
Los que no cumplen el formato del país ni siquiera se consultan al operador, y no se cobran. Los que tenés marcados en tu lista negra personal tampoco se cobran: se cortan antes.
¿Puedo tener mi propia lista negra de números?
Sí. Agregás números a tu blacklist desde el dashboard o API; cualquier consulta sobre esos números devuelve "no" sin consultar al proveedor y sin cobrarte.
¿Cobran los resultados cacheados?
Sí, igual que en los otros servicios. Si repetís la misma consulta en pocos minutos te servimos el resultado guardado y mostramos la hora de la última comprobación — cobra lo mismo que una fresca.
Probalo con 500 créditos gratis
Sin tarjeta. Empezás a usar la API apenas creás la cuenta.
Crear cuenta