O Telefone Precisa Estar No Formato Xx Xxxxxxxxx

Formato de telefone no Brasil: como funciona na prática

A maioria dos sistemas no Brasil exige que os números de telefone sejam registrados ou validados no padrão com dois dígitos para o DDD mais nove dígitos para o número, separados por um espaço. Esse formato padrão é amplamente reconhecido, mas na hora de implementar, as coisas costumam complicar de maneiras que ninguém explica direito. Na prática, isso significa que um número como (11) 98765-4321 deve ser convertido para 11 987654321. O primeiro par de dígitos é o DDD da operadora ou região, e os nove seguintes são o número em si. Celulares brasileiros têm nove dígitos desde a mudança para a banda D em 2012. Antes disso, muitos números tinham oito dígitos, o que ainda gera confusão em bancos de dados legados. Eu já passei problema com um sistema de cadastro empresarial que não aceitava números no formato correto porque o validador tinha uma regex mal construída. A expressão regular pegava apenas números com exatamente onze dígitos, mas um número como 11987654321 tem onze dígitos no total, e funcionava normalmente. O problema era que o validador também exigia que houvesse um hífen obrigatório entre o quinto e o sexto dígito, então 11 98765-4321 era aceito mas 11 987654321 não. Perdi cerca de três horas refatorando o regex para tratar os casos de forma consistente. A solução final foi simplesmente aceitar qualquer sequência de onze dígitos e formatar depois da validação, aplicando a máscara apenas na exibição.

Outro detalhe importante: o DDD de alguns estados tem uma pegadinha. São Paulo e Minas Gerais usam DDDs que variam de 11 a 19, mas o DDD 18 (São José do Rio Preto) às vezes é confundido com parte do número porque parece um mês. Se você estiver trabalhando com validação de entrada, sempre trate o DDD como separado do número, não como parte de uma string única. Para aplicar esse formato corretamente, o processo mais simples é remover todos os caracteres não numéricos da entrada, verificar se o resultado tem onze dígitos, e então inserir um espaço após o segundo dígito. Isso evita a maioria dos erros comuns de formatação. Em Python, um exemplo funcional seria algo assim:

def formatar_telefone(numero):
digitos = ''.join(filter(str.isdigit, numero))
if len(digitos) != 11:
return None
return f"{digitos[:2]} {digitos[2:]}" Isso vai transformar "11987654321", "(11) 98765-4321", ou "11.987654321" tudo em "11 987654321". A função retorna None se o número não tiver exatamente onze dígitos, o que serve como filtro antes de qualquer tentativa de formatar. Um erro muito comum que eu vejo em código novo é tentar validar o DDD através de uma lista hardcoded. Existem centenas de DDDs válidos no Brasil, e listá-los manualmente é manutenção desnecessária. Use uma tabela de referência ou, se estiver em um contexto onde você só precisa formatar e não validar a região, ignore essa etapa.

Se você está lidando com uma API que exige esse formato, lembre-se de que alguns provedores de SMS e de voice APIaceitam variações. O Twilio, por exemplo, é tolerante com formatos diferentes, mas o banco de dados interno dele padroniza tudo internamente. Não adianta insistir em enviar com máscara se o endpoint espera apenas os dígitos brutos. Agora, se o número tem apenas dez dígitos, pode ser um número fixo antigo ou um erro de digitação. A primeira coisa a checar é se o DDD foi omitido. Em muitos formulários, o campo de DDD é separado, então o número propriamente dito pode ter oito dígitos. Nesse caso, o formato completo seria dd + número, resultando em dez ou onze dígitos dependendo se o fixo tem oito ou nove. Fixos agora têm nove dígitos na maioria dos estados, então dd + ddddddddd também dá onze. Para quem precisa de uma biblioteca pronta em vez de escrever do zero, a phonenumbers do Google é a opção mais confiável. Ela trata parsing, validação e formatação de uma vez, suportando praticamente qualquer variante de entrada. Instalação:

pip install phonenumbers Uso básico: import phonenumbers
número = phonenumbers.parse("+5511987654321", "BR")
print(phonenumbers.format_number(número, phonenumbers.PhoneNumberFormat.NATIONAL))

Isso retorna no formato nacional brasileiro, que para celulares costuma ser (11) 98765-4321. Você pode adaptar o formato de saída conforme a necessidade do seu sistema. Há uma limitação que poucas pessoas consideram: números de serviços como 100, 136, 190 etc. Eles não têm DDD e têm apenas três dígitos. Se o seu formulário aceitar qualquer tipo de telefone, inclua tratamento separado para esses casos, senão eles vão falhar na validação de onze dígitos sem explicação clara para o usuário. Também vale mencionar que alguns sistemas antigos ainda esperam o formato com hífen, não com espaço. A diferença é sutil, mas se o backend faz uma comparação literal de strings, espaço versus hífen quebra a verificação. Sempre confirme com a equipe de backend qual formato exato é esperado antes de implementar.

Resumindo sem resumo: limpe a entrada, conte os dígitos, formate com espaço após o DDD, e valide com uma biblioteca séria se o volume de dados justificar. Evite reinventar a roda para validação de DDDs e nunca assuma que todos os números têm onze dígitos sem verificar o contexto do número fixo versus móvel.