MasaApps360
Português
WiFi QR

Código QR de Wi-Fi não funciona? Formato, caracteres especiais e redes ocultas

Um código QR de Wi-Fi que escaneia mas não conecta quase sempre tem um detalhe errado: a senha ou o nome não combinam exatamente com o roteador, o tipo de segurança está errado, um caractere especial não foi escapado, ou a rede é oculta e o código não avisa isso. Escaneie o código para ver o que ele realmente contém, depois corrija o detalhe e crie um novo.

4 min de leitura · Atualizado 2026-09-17

Checklist: por que um código QR de Wi-Fi não conecta

  • A senha foi trocada no roteador depois que o código foi criado. O código não se atualiza solo.
  • O nome ou a senha não combinam exatamente: maiúsculas, espaços e símbolos todos importam.
  • O tipo de segurança está errado, como um código marcado como aberto para uma rede com senha.
  • Um ; , : \ ou " no nome ou na senha não foi escapado, então o celular lê uma senha cortada.
  • O nome ou a senha parecem um número hexadecimal e não foram colocados entre aspas, então alguns celulares os leem como bytes.
  • A rede é oculta e o código não carrega a marca de rede oculta.
  • A rede é corporativa (usuário mais senha), que esse tipo de código não consegue carregar.
  • O celular está fora de alcance, ou a rede é só 5 GHz e o aparelho só suporta 2,4 GHz.

Como encontrar o problema com o WiFi QR

  1. Abra a aba Escaneamento e escaneie o código que falha. A folha Rede digitalizada mostra o nome, a segurança e a senha dentro dele.
  2. Compare com o roteador, letra por letra. Toque no olho para revelar a senha.
  3. Na aba Gerar, digite os dados corretos. Se uma mensagem em vermelho aparecer embaixo dos botões, corrija o que ela diz; o código não é desenhado até os dados serem válidos.
  4. Se a rede for oculta, abra Opções avançadas e ative Rede oculta.
  5. Teste o novo código com um celular que ainda não está conectado, depois substitua o código antigo.

O que as mensagens de erro significam

Mensagens de validação do WiFi QR
MensagemPor que importaComo corrigir
O nome da rede não pode passar de 32 caracteresNomes de Wi-Fi são limitados a 32 bytes; um nome mais longo não combina com nenhuma rede.Use o nome exato do roteador. Acentos e emojis ocupam vários bytes cada.
Redes protegidas exigem senhaUma rede WPA ou WEP não pode ser acessada sem a chave.Digite a senha, ou escolha Aberta (sem senha) se realmente não houver senha.
As senhas WPA têm de 8 a 63 caracteresChaves WPA fora desse intervalo são rejeitadas por todo celular.Verifique a senha; uma de 7 caracteres como abc1234 está incompleta ou digitada errado.
As chaves WEP têm 5 ou 13 caracteres, ou 10 ou 26 dígitos hexadecimaisEsses são os únicos tamanhos válidos de chave WEP.Verifique a chave, ou mude o roteador para WPA2 ou WPA3.

O limite do nome é em bytes, não em letras. "Café Wi-Fi ☕ Terrazza Grande" tem 28 caracteres e 31 bytes, então passa. Adicione " 2" e passa a ter 30 caracteres mas 33 bytes, o que é longo demais, porque é e ☕ ocupam mais de um byte cada.

O formato de texto do código QR de Wi-Fi

Um código QR de Wi-Fi é texto simples: WIFI:T:type;S:name;P:password;H:true;;, em que cada palavra em letra minúscula representa um valor. T é WPA, WEP ou nopass para uma rede aberta. P é omitido em uma rede aberta. H:true aparece só em uma rede oculta. O texto termina com dois pontos e vírgula.

Dentro de um valor, os caracteres \ ; , : e " recebem uma barra invertida na frente. E quando um valor inteiro é um número par de dígitos hexadecimais (0-9, a-f), o WiFi QR o coloca entre aspas duplas para que os celulares leiam como texto. Veja o que o app grava para casos diferentes:

Texto de Wi-Fi gravado pelo WiFi QR
CasoNome / senhaTexto no código
Dois pontos e ponto e vírgula na senhaCasa Rossi / sole;mare:2024WIFI:T:WPA;S:Casa Rossi;P:sole\;mare\:2024;;
Vírgula no nome, aspas na senhaCasa, Rossi / Sole"Mare88WIFI:T:WPA;S:Casa\, Rossi;P:Sole\"Mare88;;
Senha que parece hexadecimalHomeNet / 1234abcdWIFI:T:WPA;S:HomeNet;P:"1234abcd";;
Nome que parece hexadecimalCAFE2024 / espresso-barWIFI:T:WPA;S:"CAFE2024";P:espresso-bar;;
Rede ocultaOffice-5G / Blue+Sky7WIFI:T:WPA;S:Office-5G;P:Blue+Sky7;H:true;;
Rede abertaCafe Guest / nenhumaWIFI:T:nopass;S:Cafe Guest;;
Chave WEP hexadecimalOld / A1B2C3D4E5WIFI:T:WEP;S:Old;P:"A1B2C3D4E5";;

SSID oculto e WPA3

Para uma rede oculta, ative Rede oculta para que o código carregue H:true; o celular então procura a rede mesmo que ela não seja transmitida. Para WPA3-Personal, escolha WPA/WPA2/WPA3. O código grava T:WPA, que os celulares usam para WPA2 e WPA3, incluindo roteadores mistos WPA2/WPA3.

Código QR de Wi-Fi não funciona só no iPhone?

Se celulares Android conectam mas um iPhone não, abra o app Câmera, garanta que o código preenche o quadro e espere pelo banner amarelo, depois toque nele. Se o iPhone já salvou essa rede antes com uma senha antiga, esqueça a rede em Configurações, em Wi-Fi, e escaneie de novo.

Perguntas frequentes

Os códigos QR de Wi-Fi param de funcionar depois de um tempo?
Não. O código contém o nome da rede e a senha como texto e nunca muda por conta própria. Ele só para de funcionar quando a senha ou o nome mudam no roteador.
Um código QR de Wi-Fi funciona com WPA3?
Sim para WPA3-Personal: o código grava T:WPA e os celulares o usam tanto para WPA2 quanto para WPA3. No WiFi QR, escolha WPA/WPA2/WPA3. WPA3-Enterprise com usuário não é suportado.
Um código QR de Wi-Fi consegue conectar a uma rede oculta?
Sim, se o código incluir H:true. No WiFi QR ative Rede oculta em Opções avançadas e digite o nome exatamente.
Por que minha senha com ponto e vírgula quebra o código?
O ponto e vírgula separa campos no formato de código QR de Wi-Fi, então um sem escape encerra a senha antes da hora. O WiFi QR adiciona a barra invertida automaticamente.

Mais guias do WiFi QR