CodeBox Hub
GRÁTIS

O que é um QR Code de WiFi?

Como funcionam os QR codes de WiFi — o formato da string WIFI:, suporte a WPA2 e WPA3, redes ocultas, escape de caracteres especiais e como gerar um.

# 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:

CampoSignificadoExemplo
TTipo de segurança: nopass, WEP, WPA, WPA2 ou WPA3WPA2
SSSID — o nome da rede, sensível a maiúsculas/minúsculas e deve corresponder exatamenteCodeBox-Guest
PSenha — obrigatória para qualquer tipo que não seja nopassMySecret123
HRede 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 redeValor de TObservações
AbertanopassSem campo de senha; qualquer pessoa pode se conectar
WEPWEPLegado, inseguro — evite
WPAWPAEra do TKIP; instalações mais antigas
WPA2WPA2AES/CCMP, o padrão para a maioria das residências e empresas hoje
WPA3WPA3Handshake SAE, o mais forte; alguns celulares antigos não suportam
Misto WPA/WPA2 ou WPA2/WPA3WPA/WPA2, WPA2/WPA3Aceito 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

  1. Abra o Gerador de QR Code Wi-Fi (ou qualquer tipo no Gerador de QR Code Online).
  2. Insira o SSID, a senha e escolha o tipo de segurança; marque "rede oculta" se o roteador ocultar o SSID.
  3. 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).
  4. 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.

FAQ

O que um QR code de WiFi faz?

Ele armazena o nome da rede, o tipo de segurança e a senha em uma string escaneável, para que o celular se conecte à rede a partir do prompt da câmera em vez de digitar uma senha.

Qual é o formato de um QR code de WiFi?

WIFI:T:<type>;S:<ssid>;P:<password>;H:<hidden>;; — texto simples dentro de um QR code comum conforme ISO/IEC 18004.

Um QR code de WiFi pode funcionar com uma rede oculta?

Sim, defina H:true; sem a flag, o celular não listará uma rede cujo SSID o roteador não transmite.

E se a senha contiver um ; ou um : ?

Escape com uma barra invertida (P:My\;Secret) ou deixe um gerador escapar — separadores sem escape truncam o payload.

Um QR code de WiFi pode usar WPA3 ou autenticação corporativa?

WPA3 funciona via T:WPA3 em celulares compatíveis; 802.1X corporativo está fora do formato padrão e não conecta a partir da maioria das câmeras de celular.

De que tamanho deve ser um QR code de WiFi impresso?

Códigos de versão 3-6 precisam de cerca de 2 cm com módulos de 0,3 mm; para um pôster de parede ou placa de porta, imprima em 3-5 cm com correção de nível H.

Posso mudar a senha do WiFi depois?

O código impresso não muda com a senha — regenere o QR code. Códigos dinâmicos que apontam para uma página gerenciada podem redirecionar sem reimpressão.

Por que o celular de um convidado falha ao conectar?

Geralmente uma divergência de maiúsculas/minúsculas no SSID, um caractere especial sem escape, falta de H:true em uma rede oculta, ou WPA3 em um celular antigo — verifique a string contra as configurações do roteador primeiro.

Continue lendo

Fale conosco