Validador de número de telefone

Vale a pena ser direto sobre isso, porque a maioria das ferramentas com esse nome não é.

Este validador faz uma verificação sintática com base nos planos nacionais de numeração publicados. Ele confirma que o número começa com um código de país válido, que a parte nacional tem um comprimento plausível para esse país e — quando o país publica faixas de prefixos distintas — que os dígitos iniciais estão em uma faixa de celular ou de linha fixa. Essas três verificações identificam a grande maioria dos números incorretos: erros de digitação, dígitos ausentes, um zero de tronco mantido ou um número inserido sem o código do país.

Ele não pode informar se a linha está em serviço. Nada que rode em um navegador pode fazer isso. Para confirmar que um número está ativo, é preciso fazer uma chamada ou consultar o Home Location Register da operadora por meio de um serviço pago de consulta, e qualquer ferramenta gratuita que mostre um sinal verde com a indicação "ativo" está exibindo um resultado sintático com uma palavra enganosa associada a ele.

Ele também não pode informar quem é o proprietário do número, se ele foi portado para outra operadora ou se é um número virtual. A portabilidade numérica, em particular, tornou pouco confiável identificar a operadora com base no prefixo na maioria dos mercados desenvolvidos: um número que começa com uma faixa historicamente atribuída a uma operadora pode ter sido transferido anos atrás. As faixas de prefixo ainda distinguem com segurança celulares de linhas fixas, porque essas faixas não são portáveis de um tipo para o outro.

E.164 é o padrão da ITU que define o que é um número de telefone internacional: até quinze dígitos, dos quais um a três correspondem ao código do país, sem qualquer outra pontuação. Quando escrito, ele recebe um sinal de mais no início para indicar que é internacional, e não local.

O argumento prático para armazenar números no formato E.164 é que ele é o único formato sem ambiguidades. 020 7946 0958 significa um número de Londres para um leitor britânico e não significa nada para um sistema de outro país. +442079460958 significa o mesmo número em qualquer lugar, pode ser discado diretamente de qualquer lugar e é classificado e deduplicado corretamente.

O erro comum na direção oposta é armazenar o E.164 e exibi-lo. Uma pessoa que consulta o próprio número quer vê-lo no formato nacional que reconhece, portanto, a arquitetura correta é armazenar um formato canônico e formatá-lo para exibição — nunca o contrário.

O limite de quinze dígitos é uma restrição rígida do padrão, e um número maior que isso é inválido, independentemente do que um formulário tenha aceitado. Os números válidos mais curtos são consideravelmente menores: alguns países insulares do Pacífico emitem números nacionais de cinco dígitos, por isso a verificação de comprimento precisa ser feita por país, e não com um mínimo global.

O plano de numeração de cada país reserva blocos de dígitos iniciais para finalidades específicas. No Reino Unido, 07 é celular, enquanto 01 e 02 são linhas fixas geográficas. Na Índia, os celulares começam com 6, 7, 8 ou 9. Na Nigéria, 070, 080, 081, 090 e 091 são celulares. Em grande parte da Europa continental, 6 ou 7 depois do código do país indica um celular.

Isso ainda funciona porque a divisão entre celular e linha fixa não é portável: um número pode mudar de operadora, mas não pode passar de um bloco de celulares para um bloco geográfico. Já a identificação da operadora com base no prefixo deixou de ser confiável na maioria dos mercados desde a introdução da portabilidade.

Por que isso importa para o custo: na grande maioria dos países, ligar para um celular custa mais do que ligar para uma linha fixa, às vezes várias vezes mais. Saber qual dos dois você tem antes de discar é a diferença entre uma cobrança esperada e uma surpresa. Em uma minoria de países — entre eles o Reino Unido, a Alemanha e o Quênia — a relação é inversa e o celular é mais barato, por isso nossas páginas de tarifas publicam as duas colunas, em vez de um único valor "a partir de".

Países com um plano único e unificado, ou nos quais a atribuição não é publicada de forma separável, exibem aqui um honesto "não é possível determinar", em vez de uma suposição. O Plano de Numeração da América do Norte é o maior caso desse tipo: nos Estados Unidos e no Canadá, um código de área não distingue de forma alguma um celular de uma linha fixa, e somente uma consulta à rede pode fazer isso.

Se você estiver validando números em massa — uma lista de clientes, uma exportação de inscrições em um evento ou uma planilha herdada de outra pessoa — a sequência útil é: remover tudo o que não seja um dígito ou um sinal de mais inicial, adicionar o código do país quando o número for local de um mercado conhecido, remover o prefixo de tronco se ele tiver sido mantido e então verificar o comprimento.

Fazer isso nessa ordem é importante. Remover o prefixo de tronco antes de saber o país elimina o dígito errado nos países cujos números legitimamente começam com 0 depois do código do país. Verificar o comprimento antes de adicionar o código do país marca todo número local válido como curto demais.

Os registros que falharem depois das quatro etapas estão realmente incorretos e devem ser corrigidos na origem, em vez de receberem um palpite. Um número com um dígito a menos não pode ser recuperado adicionando um zero em algum ponto plausível; trata-se de um erro de inserção de dados que precisa do original.

Para qualquer volume maior que alguns milhares de registros, uma biblioteca que incorpore todos os metadados do plano de numeração é a ferramenta certa, e não uma página da web. Este validador usa os mesmos dados de planos publicados que essas bibliotecas usam, um número por vez.