Uma consulta HLR (HLR lookup) é uma consulta em tempo real ao Home Location Register de uma rede móvel que diz se um número de celular é válido, a qual rede ele pertence hoje (MCC/MNC, depois da portabilidade) e às vezes se está alcançável ou em roaming. Quem envia SMS usa a consulta para limpar listas, rotear corretamente e combater fraude.
O que é o HLR
O Home Location Register é o banco de dados do núcleo de uma rede móvel 2G/3G que guarda o perfil e o status atual de cada assinante. Nas redes 4G e 5G, a função equivalente é do HSS e do UDM, mas o serviço comercial continua se chamando "HLR lookup". O provedor de consultas envia uma consulta de sinalização para o número e transforma a resposta num resultado simples.
O que uma consulta retorna
| Campo | Significado |
|---|---|
| Status | Se o número existe e está ativo, ou se é desconhecido, não alocado ou bloqueado |
| Rede original | A operadora dona da faixa de números |
| Rede atual (MCC/MNC) | A operadora que atende o número hoje, depois da portabilidade |
| Portado | Se o número mudou para outra operadora |
| Roaming | Se o assinante está no exterior e, às vezes, a rede visitada (nem sempre disponível) |
| Alcançabilidade | Alguns provedores informam se o telefone está conectado à rede naquele momento |
A qualidade dos resultados depende do país e de como o provedor consulta a rede. Algumas operadoras restringem essas consultas, e em alguns países só há dados de portabilidade. Pergunte ao provedor em que se baseia cada campo.
HLR vs MNP vs validação de número
- Consulta HLR: consulta à rede ao vivo. A mais completa, mas mais lenta (muitas vezes um segundo ou mais) e mais cara.
- Consulta MNP: confere um banco de dados de portabilidade numérica. Dá a rede atual, não se o telefone está ativo. Mais rápida e mais barata.
- Validação do formato do número: confere o número com o plano de numeração, sem nenhuma consulta à rede. Gratuita, mas só diz se o formato é plausível. Veja formato de número E.164.
Por que quem envia SMS usa consultas HLR
- Roteamento correto: saber a rede atual permite à plataforma escolher o fornecedor e a tarifa certos. Veja códigos MCC e MNC e portabilidade numérica e roteamento.
- Limpeza de listas: tirar números inválidos e inativos antes de uma campanha evita pagar por mensagens que não podem ser entregues, principalmente na cobrança por mensagem enviada.
- Verificação de fraude: no cadastro, uma consulta pode sinalizar números em redes inesperadas ou em faixas premium, o que ajuda contra o SMS pumping.
- Conferência de DLR: números que o HLR mostra como não alocados nunca deveriam voltar como entregues. Se voltarem, suspeite de DLRs falsos.
Quando não usar
Uma consulta antes de cada OTP acrescenta latência e custo. Para tráfego em que o tempo é crítico, muitos remetentes confiam no roteamento por portabilidade da própria plataforma de SMS e fazem consultas só no cadastro ou em números que falham repetidamente. Para listas de envio em massa, uma consulta pouco antes da campanha normalmente basta, porque o status dos números muda devagar. Lembre-se das regras de privacidade: a consulta trata dados pessoais, então use-a para uma finalidade legítima e guarde os resultados só pelo tempo necessário.
Dicas práticas
- Compare dois ou três provedores de consulta com uma amostra de números que você conhece, por país.
- Guarde os resultados em cache por um tempo limitado (dias, não meses) para economizar.
- Trate "desconhecido" separado de "inválido": algumas redes não respondem às consultas.
- Use os resultados das consultas junto com os status de DLR para entender as falhas.
Rotas e consultas
Muitas rotas de SMS já incluem roteamento por portabilidade do lado do fornecedor. Quando você solicita rotas SMS A2P pela VoIPMatcher, diga se precisa de roteamento pela rede atual em países específicos. Solicite uma rota de SMS.
Perguntas frequentes
A consulta HLR mostra a localização de um telefone?
Não. Uma consulta HLR mostra se um número é válido e está ativo, qual rede o atende, se foi portado e às vezes se está em roaming. Ela não informa a localização física do telefone. Os serviços de consulta legítimos servem para roteamento, limpeza de listas e verificação de fraude, não para rastrear pessoas.
A consulta HLR é gratuita?
Normalmente não. Uma consulta HLR real envia uma consulta de sinalização à rede móvel, então os provedores cobram por consulta. Ferramentas gratuitas em geral só conferem o formato do número com o plano de numeração, o que diz se o número é plausível, mas não se está ativo nem qual rede o atende depois da portabilidade.
A consulta HLR é legal?
Usar um serviço comercial de consulta HLR para uma finalidade legítima, como rotear mensagens ou limpar uma lista de clientes, é uma prática normal do setor. A consulta trata dados pessoais, então as regras de privacidade se aplicam: tenha uma finalidade clara, guarde os resultados só pelo tempo necessário e não use consultas para traçar perfis ou rastrear pessoas.
Qual a diferença entre HLR e VLR?
O HLR (Home Location Register) é o banco de dados da rede de origem que guarda o perfil e o status de cada assinante. O VLR (Visitor Location Register) guarda dados temporários dos assinantes que estão naquele momento na área atendida por uma central de comutação, inclusive visitantes de outras redes. Uma consulta HLR comercial consulta o registro de origem, não o VLR.
O que é uma API de consulta HLR?
Uma API de consulta HLR permite que a sua plataforma envie um número de telefone e receba o resultado da consulta como dados estruturados, normalmente por HTTP. Plataformas de SMS chamam a API no cadastro, antes de uma campanha ou em números que falham repetidamente. Compare provedores com números de amostra que você conhece, porque a qualidade dos resultados muda conforme o país e a forma como cada provedor consulta as redes.
Precisa de uma rota?
Envie o destino, o tipo de rota e a tarifa alvo. Respondemos com o que podemos entregar.