API HLR de CaptainVerify

API de búsqueda de HLR

Con la API de CaptainVerify, puede integrar la verificación HLR Lookup en sus propias aplicaciones. También puede consultar la documentación de HLR.

Clave API

Se requiere una cuenta para generar la clave para la API, esto es lo que le dará acceso al servicio.

La solicitud

Para realizar una solicitud a la API, simplemente llame al protocolo GET en esta URL:

https://api.captainverify.com/verify?phone={PHONE_NUMBER}&apikey=XXXXXXXXXXXXXXXXXXXX

Reemplace {PHONE_NUMBER} con el número de teléfono móvil para verificar (en formato internacional: +346...)

Límites de API

La API está limitada a un máximo de 2 conexiones simultáneas y 50 comprobaciones por minuto. Al integrar la API, asegúrese de que su aplicación no exceda este límite.

La respuesta

Se devolverá una tabla json con estas variables:

Variables	valor posible
status	true, false. El estado de la solicitud.
credits	89 Créditos disponibles en su cuenta.
message	default : null Cuando el estado es falso, se enviará un mensaje de error.
requested_number	34600000000 El número de móvil a consultar.
formatted_number	+34600000000 El número de móvil en formato internacional.
network	MOVISTAR el nombre de la red.
original_network	ORANGE El nombre de la red original.
roaming	true, false Estado de itinerancia actual.
ported	true, false Si el usuario ha cambiado de operador con el mismo número.
country	France El nombre completo del país para el número solicitado.
country_prefix	33 El prefijo numérico del país del número.
details	DELIVERED_TO_HANDSET, UNDELIVERABLE_NOT_DELIVERED DELIVERED_TO_HANDSET : Se ha procesado la verificación de HLR (número asignado). UNDELIVERABLE_NOT_DELIVERED: No se completó la verificación de HLR (número no asignado).
result	El estado del número: válido, no válido, desconocido Si todos sus créditos se han agotado, siempre se devolverá el estado desconocido, para no bloquear su aplicación.

¿Por qué integrar una API HLR?

Un fichero de números móviles envejece rápido. Hay líneas que se dan de baja, números que cambian de operador y otros que contienen un error de escritura y nunca han existido. Cada SMS enviado a un número inválido se factura, pero nunca llega. En una campaña de varios miles de mensajes, esos envíos perdidos pesan directamente sobre el presupuesto sin producir el más mínimo retorno.

El problema va más allá del SMS. En prospección telefónica, un fichero contaminado por números dados de baja hace perder tiempo a los equipos: cada llamada a una línea muerta es una llamada que no llegará a nada. Las estadísticas de campaña se vuelven ilegibles, la entregabilidad SMS se degrada y resulta imposible distinguir un mensaje ignorado de un mensaje nunca entregado.

Una API HLR trata el problema en su origen. El HLR (Home Location Register) es el registro de los operadores que recoge el estado de las líneas móviles. Al consultar la red del operador en tiempo real, la API confirma que una línea está activa antes de que usted la contacte. Deja de enviar a ciegas y deja de pagar por intentar llegar a números que ya no existen.

Casos de uso de la API HLR

Limpieza de un fichero móvil antes de una campaña SMS

Antes de un envío masivo, pase cada número por la API. Las líneas activas se conservan, los números dados de baja o inválidos se descartan del fichero. Solo paga SMS que tienen una posibilidad real de ser entregados, y sus tasas de campaña reflejan la calidad de su mensaje en lugar del desgaste de su base.

Filtrado antes de la prospección telefónica

Un centro de llamadas pierde dinero con cada número muerto marcado. Al verificar el estado de las líneas de antemano, usted solo transmite a los equipos números activos. Los comerciales dedican su tiempo a hablar con prospectos, no a escuchar mensajes de error del operador. El coste por contacto útil baja de forma mecánica.

Detección de los números dados de baja en un CRM

Las fichas de contacto de un CRM se degradan en silencio. Una verificación HLR periódica identifica las líneas dadas de baja y permite marcar esas fichas, activar una actualización o cambiar a otro canal de contacto. Su base sigue siendo explotable en lugar de acumular números muertos que falsean todos sus indicadores.

Identificación del operador real a pesar de la portabilidad

Un número portado conserva su prefijo de origen pero ahora depende de otro operador. La respuesta de la API distingue la red actual (network) de la red de origen (original_network). Usted sabe qué operador gestiona realmente la línea, una información valiosa para el enrutamiento de sus SMS o el análisis de la composición de su fichero.

Preguntas frecuentes sobre la API HLR

¿Qué verifica exactamente la API HLR?

La API consulta al operador para conocer el estado de la línea móvil. La respuesta JSON contiene el estado de la solicitud, el número formateado en internacional, la red actual y la red de origen. La comparación de estos dos últimos campos revela si el número ha sido portado a otro operador.

¿Funciona la API en tiempo real?

Sí. Cada solicitud activa una consulta a la red del operador en el momento en que usted la envía. Dos límites documentados encuadran el uso: 2 conexiones simultáneas como máximo y 50 verificaciones por minuto. Para tratar grandes volúmenes, basta con espaciar sus llamadas respetando estos umbrales.

¿Cuánto cuesta?

La facturación funciona por créditos, y cada respuesta de la API incluye un campo credits que le permite seguir su consumo directamente desde sus llamadas. Las tarifas detalladas de las verificaciones HLR están disponibles en la página HLR Lookup.