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.
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
- 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.
- Compare com o roteador, letra por letra. Toque no olho para revelar a senha.
- 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.
- Se a rede for oculta, abra Opções avançadas e ative Rede oculta.
- 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
| Mensagem | Por que importa | Como corrigir |
|---|---|---|
| O nome da rede não pode passar de 32 caracteres | Nomes 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 senha | Uma 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 caracteres | Chaves 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 hexadecimais | Esses 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:
| Caso | Nome / senha | Texto no código |
|---|---|---|
| Dois pontos e ponto e vírgula na senha | Casa Rossi / sole;mare:2024 | WIFI:T:WPA;S:Casa Rossi;P:sole\;mare\:2024;; |
| Vírgula no nome, aspas na senha | Casa, Rossi / Sole"Mare88 | WIFI:T:WPA;S:Casa\, Rossi;P:Sole\"Mare88;; |
| Senha que parece hexadecimal | HomeNet / 1234abcd | WIFI:T:WPA;S:HomeNet;P:"1234abcd";; |
| Nome que parece hexadecimal | CAFE2024 / espresso-bar | WIFI:T:WPA;S:"CAFE2024";P:espresso-bar;; |
| Rede oculta | Office-5G / Blue+Sky7 | WIFI:T:WPA;S:Office-5G;P:Blue+Sky7;H:true;; |
| Rede aberta | Cafe Guest / nenhuma | WIFI:T:nopass;S:Cafe Guest;; |
| Chave WEP hexadecimal | Old / A1B2C3D4E5 | WIFI: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?
Um código QR de Wi-Fi funciona com WPA3?
Um código QR de Wi-Fi consegue conectar a uma rede oculta?
Por que minha senha com ponto e vírgula quebra o código?
Mais guias do WiFi QR
- Como criar um código QR para seu Wi-Fi no iPhone
- Como compartilhar a senha do seu Wi-Fi com um código QR, do iPhone para qualquer celular
- Crie uma placa de código QR de Wi-Fi para imprimir, para convidados, Airbnb ou café
- Como escanear um código QR de Wi-Fi no iPhone e ver a senha
- Design personalizado de código QR de Wi-Fi: cores, formas e um ícone central
- Onde encontrar o código QR do Wi-Fi no iPhone
- Todas as perguntas sobre o WiFi QR
- Voltar para o WiFi QR