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.
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, ;;.
| Campo | Significado | Exemplo |
|---|---|---|
| T | Segurança | T:WPA |
| S | Nome da rede | S:Aurora |
| P | Senha | P:broa-2026 |
| H | Rede oculta | H: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.
| Largura | Módulo | Distância |
|---|---|---|
| 3 cm | 1,0 mm | 30 cm |
| 5 cm | 1,7 mm | 50 cm |
| 10 cm | 3,4 mm | 1 m |
| 20 cm | 6,9 mm | 2 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
- Abra o Gerador de QR Code e escolha Wi-Fi.
- Preencha Nome da rede (SSID) e Senha do Wi-Fi exatamente como no roteador. As barras invertidas entram sozinhas.
- 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.
- 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.
- 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.