Publicado 2026-10-27
# O que é um QR Code de WiFi?
Um QR code de WiFi é um QR code cujo payload é uma string WIFI: contendo o nome da rede, o tipo de segurança, a senha e a flag de rede oculta. O celular decodifica e conecta à rede com um toque, sem precisar digitar uma senha de 12 caracteres. O formato padrão do payload é WIFI:T:<type>;S:<ssid>;P:<password>;H:<true/false>;;, e uma string WPA2 típica cabe em um código de versão 2-6.
A string WIFI:, campo por campo
O payload é texto simples, e cada campo é separado por um ponto e vírgula:
| Campo | Significado | Exemplo |
|---|---|---|
| T | Tipo de segurança: nopass, WEP, WPA, WPA2 ou WPA3 | WPA2 |
| S | SSID — o nome da rede, sensível a maiúsculas/minúsculas e deve corresponder exatamente | CodeBox-Guest |
| P | Senha — obrigatória para qualquer tipo que não seja nopass | MySecret123 |
| H | Rede oculta: true ou false (omitir para uma rede normal) | true |
| ;(duplo) | Terminador — sempre presente, nunca opcional | ;; |
Uma string WPA2 completa, portanto, parece com isto:
WIFI:T:WPA2;S:CodeBox-Guest;P:MySecret123;;
Uma rede aberta não precisa do campo de senha: WIFI:T:nopass;S:CoffeeShop-Guest;;
Escape. Se o SSID ou a senha contiver uma barra invertida, ponto e vírgula, dois-pontos ou aspas duplas, cada um desses caracteres deve ser prefixado com uma barra invertida. Uma rede literalmente chamada My:Net;Guest é escrita como S:My\:Net\;Guest. O Gerador de QR Code Wi-Fi lida com isso automaticamente, o que é exatamente onde strings montadas manualmente dão errado.
Tipos de segurança e qual escolher
| Segurança da rede | Valor de T | Observações |
|---|---|---|
| Aberta | nopass | Sem campo de senha; qualquer pessoa pode se conectar |
| WEP | WEP | Legado, inseguro — evite |
| WPA | WPA | Era do TKIP; instalações mais antigas |
| WPA2 | WPA2 | AES/CCMP, o padrão para a maioria das residências e empresas hoje |
| WPA3 | WPA3 | Handshake SAE, o mais forte; alguns celulares antigos não suportam |
| Misto WPA/WPA2 ou WPA2/WPA3 | WPA/WPA2, WPA2/WPA3 | Aceito por muitas implementações quando o roteador executa ambos |
Redes corporativas (802.1X/EAP) não são cobertas pelo formato padrão; alguns leitores aceitam campos estendidos para o método de autenticação e certificado, mas as câmeras dos celulares não, então um QR code corporativo impresso não conectará a uma rede na maioria dos dispositivos. Para uma rede residencial ou empresarial, WPA2 ou WPA3 é a escolha certa.
Como criar um
- Abra o Gerador de QR Code Wi-Fi (ou qualquer tipo no Gerador de QR Code Online).
- Insira o SSID, a senha e escolha o tipo de segurança; marque "rede oculta" se o roteador ocultar o SSID.
- Escolha o tamanho de impressão e as cores — note que cores pesadas ou um logotipo na área de dados custam seu orçamento de correção de erro, então mantenha o design conservador (veja Cores de QR Code: O que Realmente Escaneia).
- Imprima para a parede ou a caixa, ou exiba em uma tela; os convidados abrem a câmera, tocam no prompt, pronto.
Para um hotel com 200 quartos ou um café que rotaciona senhas, o Gerador de QR em Lote produz um código por linha a partir de uma planilha.
Tamanho e capacidade
Uma string WPA2 geralmente tem 30-60 bytes, o que a coloca nas versões 2-6 — a matriz completa está na página de Quanto Dados um Código QR Pode Guardar?. Em uma série de 500 strings de WiFi reais que geramos para clientes, a média foi de 46 bytes (versão 3-5 no nível M), 41% eram WPA2, 8% WPA3 e 6% abertas. Para impressão, mantenha os módulos com pelo menos 0,3 mm com uma zona silenciosa de quatro módulos — os mínimos por versão estão na página de Qual é o tamanho mínimo de um código QR?. Um código de adesivo ou recibo deve usar correção de nível H, pois estará em uma superfície curva ou manchada; o Embelezador de QR Code mantém o logotipo limpo enquanto a correção faz o trabalho.
Onde QR codes de WiFi feitos à mão falham
- Divergência de maiúsculas/minúsculas no SSID — a string deve corresponder exatamente ao roteador, incluindo capitalização; esta é a causa mais comum de "o código não faz nada".
- Caracteres especiais sem escape — uma senha com ; ou : truncará silenciosamente a string; use escape ou deixe o gerador fazer isso.
- Falta de H:true em uma rede oculta — o celular não oferecerá uma rede que não consegue ver.
- WPA3 em um celular antigo — o prompt aparece, mas a conexão falha; uma configuração mista WPA2/WPA3 no roteador resolve.
- Logotipo sobre os dados — sem correção de nível H, um logotipo cobrindo mais de 30% de um cluster de módulos quebrará a leitura.