Como criar um QR code do Wi-Fi para clientes e visitas

A visita aponta a câmera do celular para o código na mesa ou na parede e entra na rede sem digitar a senha. Este guia explica o que vai dentro do código, como imprimir para ele ser lido de primeira e o que um QR code não protege.

Atualizado em

O que vai dentro do código

O QR code do Wi-Fi é texto simples num formato fixo. A câmera do Android e a do iPhone (desde o iOS 11) reconhecem um texto que começa com WIFI: e oferecem entrar na rede. Para uma padaria cuja rede se chama Aurora, fica assim:

WIFI:T:WPA;S:Aurora;P:broa-2026\;visita;;

O formato nasceu no ZXing, um projeto aberto de leitor de códigos de barras. Depois a Wi-Fi Alliance o incluiu na especificação do WPA3 e registrou o esquema wifi na IANA em 2020, mantendo a compatibilidade. Cada campo termina com ponto e vírgula, a ordem dos campos não importa e o texto todo termina com dois sinais de ponto e vírgula, ;;.

CampoSignificadoExemplo
TSegurançaT:WPA
SNome da redeS:Aurora
PSenhaP:broa-2026
HRede ocultaH:true

T aceita WPA, WEP ou nopass; S, o nome da rede (SSID), é obrigatório; P é ignorado quando T é nopass.

Caracteres que precisam de barra

Como o ponto e vírgula fecha um campo, a senha broa-2026;visita seria lida como broa-2026 se fosse escrita do jeito que é. O ZXing determina que cinco caracteres recebam uma barra invertida antes: \ ; , " :. É o \; do exemplo. Se você montar o texto à mão num gerador genérico, coloque essas barras você mesmo. Maiúsculas, espaços e hifens contam, então copie nome e senha exatamente como estão nas configurações do roteador.

WPA2, WPA3, WEP e rede aberta

O campo T diz como se faz o login, não qual versão de WPA o roteador usa. T:WPA cobre WPA e WPA2 Personal, e a ferramenta do swift.id também o usa para WPA3. Uma diferença merece atenção: quando as configurações do Android compartilham uma rede WPA3-Personal, elas escrevem T:SAE. Se o seu roteador está só em WPA3, e não no modo de transição WPA2/WPA3, teste o código impresso em alguns Androids e iPhones antes de espalhar pela loja. Um aparelho sem suporte a WPA3 não entra numa rede só WPA3, diga o código o que disser; o modo de transição deixa os dois tipos entrarem.

O WEP é inseguro há muito tempo e só aparece em roteadores muito antigos. Numa rede aberta, T:nopass faz o campo P ser ignorado.

Rede oculta

Uma rede com nome oculto não aparece na lista de redes, então o celular precisa procurá-la pelo nome. H:true avisa que a rede é oculta, e o Android a salva como SSID oculto. Sem essa marcação o código é lido, mas o celular pode não encontrar a rede. Esconder o nome não substitui uma senha forte.

Tamanho de impressão e distância de leitura

O texto do exemplo tem 41 bytes. Com correção de erros Média (M), o Gerador de QR Code usa a versão 3, que tem 29 × 29 módulos (os quadradinhos do desenho), mais uma margem branca de 4 módulos de cada lado. O que importa na impressão é a largura de um módulo: a largura do código dividida por 29.

LarguraMóduloDistância
3 cm1,0 mm30 cm
5 cm1,7 mm50 cm
10 cm3,4 mm1 m
20 cm6,9 mm2 m

A coluna da distância segue uma regra prática comum entre gráficas: o código é lido a cerca de 10 vezes a sua largura. Ela não faz parte da norma do QR code, e o resultado real depende da câmera, da luz e do contraste. Imprima uma cópia e teste do lugar onde o cliente fica sentado ou em pé. Um código de 10 cm cabe com folga numa folha A4 dobrada em display de mesa.

Nome ou senha mais longos acrescentam bytes e podem subir a versão. Com a rede chamada Aurora Café, o texto passa a 47 bytes, porque o é ocupa 2 bytes em UTF-8, e vai para a versão 4, com 33 módulos: na mesma largura impressa, cada módulo fica menor.

Adesivos de mesa, que são limpos com pano úmido e levam respingos, duram mais com correção Alta (Q) ou Máxima (H). No exemplo, Q sobe o código para a versão 4 e H para a versão 5 (37 módulos). Mantenha a margem branca e use SVG para gráfica, para as bordas ficarem nítidas em qualquer tamanho.

Escreva também o nome da rede e a senha por extenso embaixo do código. Notebooks e alguns tablets não têm câmera que leia QR code, e os donos vão digitar a senha de qualquer jeito.

O que o QR code do Wi-Fi não faz

  • Esconder a senha. O conteúdo é texto simples. Qualquer app leitor que mostre o conteúdo bruto exibe o campo P:, e quem fotografar a placa pode repassar a senha. Considere que todo mundo que viu o código sabe a senha.
  • Expirar. Um QR code não tem prazo de validade. Para cortar o acesso, troque a senha no roteador e imprima um código novo; o antigo para de funcionar na mesma hora.
  • Limitar o que a visita alcança. Quem conecta fica na mesma rede da impressora, do computador do caixa e das câmeras, a não ser que o roteador separe as redes. Se o roteador tiver rede de convidados, faça o código só dela, com uma senha longa própria; o guia de senha forte explica por que o tamanho vale mais que os símbolos.

Criando o QR code no swift.id

  1. Abra o Gerador de QR Code e escolha Wi-Fi.
  2. Preencha Nome da rede (SSID) e Senha do Wi-Fi exatamente como no roteador. As barras invertidas entram sozinhas.
  3. Em Segurança, escolha WPA / WPA2 / WPA3 para quase todos os roteadores ou Sem senha para rede aberta. Marque Rede oculta se o nome não aparece na lista.
  4. Escolha a Correção de erros e leia a prévia da tela com um celular que nunca entrou nessa rede. Um celular que já conhece a rede não prova nada.
  5. Toque em Baixar SVG para a gráfica ou em Baixar PNG (de 256 a 2048 pixels, em Tamanho do download) para mandar por mensagem ou colocar num documento.

Perguntas frequentes

Por que o celular não conecta depois de ler o código?
As causas mais comuns: maiúsculas e minúsculas do nome ou da senha diferentes das do roteador, tipo de segurança errado, ou o celular ainda tem uma senha antiga salva para essa rede. Peça para o celular esquecer a rede e leia de novo. Num roteador só WPA3, celulares antigos sem WPA3 não entram.
Um código serve para as redes de 2,4 GHz e 5 GHz?
Um código guarda um nome de rede. Se o roteador usa o mesmo nome nas duas faixas, um código basta e o celular escolhe a faixa. Se os nomes são diferentes, por exemplo com o final 5G, faça dois códigos.
A visita consegue ver a senha no código?
Consegue. Qualquer app que mostre o conteúdo bruto revela a senha. Use uma rede de convidados com senha própria e troque essa senha quando quiser cortar o acesso.
O QR code do Wi-Fi feito no swift.id expira?
Não. Nome e senha ficam gravados na própria imagem, não num servidor de redirecionamento. O código só para de funcionar se o nome ou a senha mudarem no roteador.