· 6 min read
O que verificar quando uma biblioteca de telefones rejeita uma nova faixa numérica
Investigue o contexto do país, metadados instalados e evidências oficiais de numeração antes de descartar um número de telefone de cliente contestado.
Trate uma suspeita de rejeição de nova faixa como uma investigação. Reproduza o resultado com a entrada exata e o contexto do país, compare a biblioteca implantada com os metadados atuais e encontre evidências oficiais para a faixa antes de decidir o que fazer com o registro.
Capture a rejeição antes de alterar o número
Um cliente afirma que seu número está correto, mas sua importação o rejeita. Remover repetidamente um dígito inicial até que o validador aceite algo é um reparo perigoso: o novo valor pode identificar um número diferente. Comece preservando a entrada original e o valor exato que chegou à biblioteca.
Registre o país padrão fornecido para a análise, o código do país resultante se a análise for bem-sucedida e a operação de validação que falhou. Distinga um erro de análise de uma falha de comprimento possível e uma falha de validade de faixa. Um número sem contexto de país ainda não é evidência de uma nova faixa de numeração.
Reproduza o caso fora da lógica do formulário, usando o mesmo pacote implantado e metadados. Isso revela se a rejeição vem da biblioteca ou de uma regra de aplicação adicional. Uma máscara de front-end, uma expressão regular em cache ou uma restrição de país no lado do servidor podem rejeitar a entrada mesmo quando a biblioteca de telefones a aceita.
Verifique qual versão está realmente em execução
Encontre a versão da dependência resolvida no aplicativo implantado, em vez de ler apenas o intervalo de versão em um manifesto de pacote. Se o aplicativo agrupa metadados de telefone separadamente, registre esse ativo também. Uma máquina de desenvolvimento pode produzir um resultado diferente de um pacote implantado que ainda contém uma versão mais antiga.
Repita a mesma entrada e contexto de país em relação à versão mantida atual em um teste isolado. Mantenha os dois resultados lado a lado. Se a versão mais recente aceitar a faixa, inspecione a versão relevante ou a alteração de metadados antes de planejar uma atualização. Execute números existentes representativos através da atualização também, especialmente de países centrais para sua base de clientes.
Se ambas as versões rejeitarem o número, a atualização por si só não resolveu a questão. Continue com a evidência de numeração. Não remova a verificação de validade globalmente apenas porque um cliente relata um número válido; essa alteração afetaria todas as submissões subsequentes, incluindo as genuinamente malformadas.
Procure evidências que abordem a faixa exata
O FAQ da libphonenumber do Google descreve uma faixa válida como aquela para a qual documentação oficial suficiente indica que os números podem ser atribuídos. Ele também explica que as alterações nos metadados podem atrasar a introdução de uma faixa. Esse é um motivo para investigar uma rejeição, não um motivo para presumir que todo prefixo desconhecido seja recém-válido.
Procure o plano de numeração da autoridade nacional de telecomunicações relevante ou um aviso oficial de alocação. Combine o código de discagem do país, o comprimento do número nacional e os limites de prefixo. Verifique a data de vigência: um anúncio sobre uma faixa futura pode não estabelecer que ela já está disponível para atribuição.
O aviso oficial de uma operadora pode adicionar contexto onde o plano nacional está incompleto. Salve a URL original, a data do documento e a passagem que suporta a faixa em suas notas de investigação. Um relatório de fórum ou outro site que aceite a entrada pode fornecer uma pista, mas não substitui essa evidência. Uma cópia histórica de um FAQ de numeração explica a questão geral; ela não pode confirmar uma alocação atual.
Escolha uma resposta restrita à evidência
Quando os metadados atuais aceitam o número e os metadados implantados mais antigos o rejeitam, teste e libere a atualização suportada através do seu processo normal de implantação. Mantenha o número relatado como um caso de regressão para que a mesma rejeição não retorne silenciosamente com uma alteração de pacote posterior.
Quando uma alocação oficial efetiva estiver faltando nos metadados atuais, prepare um relatório conciso para o upstream com uma entrada reproduzível, contexto do país e a fonte oficial. Remova os detalhes de identidade do cliente do relatório. Evite publicar o registro de contato completo de um cliente quando um caso de teste permitido ou descrição de faixa puder explicar o problema.
Para seu próprio fluxo de trabalho, mantenha os registros afetados em uma fila de faixas contestadas em vez de excluí-los ou declará-los silenciosamente como válidos. Qualquer exceção temporária deve ser restrita à faixa comprovada e à decisão de negócios específica. Por exemplo, permitir que um usuário salve um registro de contato não precisa conceder permissão para iniciar todas as ações dependentes de telefone. Documente quando a exceção deve ser revisada após os metadados serem atualizados.
Adicione uma verificação separada apenas para a pergunta que ela responde
Uma investigação de plano de numeração e um resultado de verificação em massa são observações separadas. A Validação de número de telefone do CheckNumber fornece um sinal de validade documentado para listas suportadas. Outros produtos do catálogo respondem a perguntas diferentes, como o registro em uma plataforma nomeada. Escolha o produto de acordo com a decisão que sua equipe precisa tomar.
Prepare os candidatos aprovados em CSV ou TXT com um país por arquivo e um número por linha, incluindo o código do país. Confirme a cobertura atual do país do produto selecionado. Mantenha as entradas originais não resolvidas em sua própria planilha de revisão, para que uma exportação posterior possa ser reconciliada com a investigação em vez de sobrescrever suas notas.
Uma observação de verificação positiva não estabelece propriedade nem repara um registro de alocação oficial ausente. Da mesma forma, uma rejeição de biblioteca não deve apagar uma observação separada sem revisão. Armazene a fonte e a hora de cada conclusão e, em seguida, decida se o registro do cliente pode prosseguir, precisa de correção ou permanece retido.
Comece com a rejeição reproduzível e a versão instalada. Uma vez que a questão da faixa seja compreendida, use nosso verificador de número de telefone para a tarefa de verificação de lista suportada que se segue. Isso preserva a distinção útil entre corrigir sua regra de validação e entender a lista de contatos.