Uma API de validação de números de telefone verifica um número antes de você enviar uma mensagem ou ligar. Dependendo do nível, ela confirma o formato e o país, identifica o tipo de linha e a operadora atual (MNP lookup) e consulta a rede móvel para saber se o número está ativo (HLR lookup). Quem envia a usa para limpar listas, rotear para a rede certa, barrar cadastros de risco e não pagar por mensagens que não podem ser entregues.
O que uma API de validação de números devolve?
As consultas têm níveis, e cada um custa mais e demora mais que o anterior:
| Nível | Como funciona | Devolve | Velocidade e custo |
|---|---|---|---|
| Validação de formato | Regras dos planos de numeração nacionais | Válido ou não, país, forma E.164, tipo possível | Instantânea, muitas vezes gratuita (bibliotecas open source) |
| Tipo de linha e operadora | Faixas de numeração e bases de operadoras | Móvel, fixo, VoIP, toll-free; operadora original | Rápida, custo baixo |
| MNP lookup | Bases de portabilidade numérica | Operadora atual após portabilidade, MCC/MNC | Rápida, custo baixo, não disponível em todos os países |
| HLR lookup | Consulta ao vivo ao registro de assinantes da rede móvel | Ativo ou não, rede atual, às vezes status de roaming | Mais lenta, custo mais alto; só números móveis |
A checagem de formato deve estar em todo formulário. As checagens de operadora e tipo de linha valem a pena no cadastro e para roteamento. O HLR é para verificações de alto valor e limpeza de listas. Os detalhes estão em HLR lookup explicado e consulta de números VoIP.
Validação ou verificação de números: qual é a diferença?
A validação verifica o número: se é real, de que tipo, de qual rede. A verificação confirma a pessoa: ela prova que controla o número digitando um código enviado por SMS ou voz. Um bom fluxo de cadastro faz as duas, nessa ordem: primeiro valide, para não enviar OTPs a números inválidos, fixos ou de alto risco, depois verifique com um OTP. Veja boas práticas de SMS OTP.
Para que serve uma API de HLR lookup?
- Limpeza de listas: remova números inativos antes de uma campanha para não pagar por mensagens que não podem ser entregues.
- Roteamento: envie cada mensagem pela rota da rede atual do assinante, usando os códigos MCC e MNC.
- Antifraude: sinalize no cadastro números que não estão ativos ou não estão em uma rede móvel.
- Diagnóstico de entrega: quando uma mensagem falha, verifique se o número existe antes de culpar a rota.
Os registros por trás dessas consultas estão explicados em HLR e VLR.
Como escolher uma API de validação de números
- Cobertura por país: a qualidade dos dados de MNP e HLR varia muito entre países; peça a cobertura por país, não uma promessa global.
- Atualização dos dados: com que frequência os dados de operadora e portabilidade são atualizados.
- Precisão no seu tráfego: teste uma amostra de números conhecidos dos seus próprios usuários.
- Latência: as checagens de cadastro precisam de resposta em bem menos de um segundo; o HLR pode demorar mais.
- Modelo de preço: por consulta, por nível; verifique se consultas que falham ou vêm do cache são cobradas.
- Privacidade: onde as consultas são processadas e por quanto tempo os números são guardados.
Onde usar a validação no seu fluxo
- No formulário: checagem de formato enquanto o usuário digita, com o país pré-selecionado, e guarde os números no formato E.164.
- No envio do formulário: consulta de tipo de linha e operadora; bloqueie faixas premium e aplique a sua política para números VoIP.
- Antes do OTP: limites de taxa por número, IP e dispositivo, depois envie o código por SMS ou por voz para fixos.
- Antes de campanhas: consultas HLR ou MNP em listas antigas para remover números inativos e rotear para a rede certa.
A validação de números de telefone é legal?
Verificar formato e operadora dos seus próprios usuários e contatos é prática comum. HLR e consultas de rede parecidas devolvem status técnico, não a identidade do dono, mas você continua tratando dados pessoais, então precisa de uma base legal e deve seguir a lei de privacidade (por exemplo o GDPR na UE). Não use consultas para traçar perfis de pessoas nem para montar listas de números com os quais você não tem relação.
Combine validação com boas rotas
A validação reduz o desperdício, e a rota certa entrega o que sobra. A VoIPMatcher obtém rotas SMS A2P com seus carriers e faz a gestão delas para você. Solicite uma rota SMS.
Perguntas frequentes
Existe API gratuita de validação de números de telefone?
A validação de formato pode ser gratuita: bibliotecas open source como a libphonenumber do Google verificam o formato e o tipo possível do número offline. Dados de operadora, portabilidade e HLR vêm de bases pagas e consultas à rede, então as APIs que os devolvem costumam cobrar por consulta, às vezes com um pequeno teste grátis.
Qual é a diferença entre HLR lookup e MNP lookup?
Um MNP lookup consulta bases de portabilidade para descobrir a operadora atual de um número. Um HLR lookup consulta o registro de assinantes da rede móvel e também pode dizer se o número está ativo. O MNP é mais rápido e mais barato; o HLR dá o status ao vivo, mas só para números móveis.
Uma API de validação consegue dizer se um número está no WhatsApp?
As APIs de validação padrão devolvem dados de telecom como formato, tipo de linha, operadora e status na rede. Saber se um número usa um app de mensagens não faz parte das consultas de telecom, e verificar isso sem consentimento pode violar os termos do app e as regras de privacidade.
Quão precisa é a validação de números de telefone?
As checagens de formato são muito precisas. Os dados de tipo de linha e operadora costumam ser confiáveis para distinguir móvel de fixo, mas são mais fracos nas categorias VoIP e em números portados ou alocados recentemente. Os resultados de HLR são ao vivo, mas podem falhar quando as redes restringem as consultas. Teste qualquer provedor com os seus próprios números.
Precisa de uma rota?
Envie o destino, o tipo de rota e a tarifa alvo. Respondemos com o que podemos entregar.