QR Code de Wi-Fi: como criar (e o erro de imprimir a rede errada)

Por Gianluca Ferro · 19 de agosto de 2026 · 6 min de leitura

Um QR Code de Wi-Fi é um código que guarda o nome da rede, o tipo de segurança e a senha em um texto padronizado no formato WIFI:S:NomeDaRede;T:WPA;P:senha;;. Ao apontar a câmera, o celular lê esse texto e oferece conectar sem digitar nada. Qualquer gerador que aceite texto livre cria um: basta codificar essa linha. Como a senha fica legível para quem escanear, imprima sempre o QR da rede de visitantes, nunca o da rede principal.

O que é um QR Code de Wi-Fi

É um QR Code que guarda três informações: o nome da rede, o tipo de segurança e a senha. Quando alguém aponta a câmera, o celular reconhece esse padrão e oferece um botão de conectar. Ninguém digita senha, ninguém erra maiúscula.

Não é mágica nem tecnologia proprietária. É texto simples dentro de um QR Code, num formato que todo celular moderno entende.

Como criar um QR Code de Wi-Fi

Existem três caminhos, e eles resolvem problemas diferentes.

O caminho do Android é o mais rápido e o menos arriscado, porque a senha nunca sai do aparelho. No iPhone não existe geração nativa: dá para ler, não para criar.

Um detalhe que confunde muita gente: gerador de QR de link e gerador de QR de Wi-Fi não são a mesma coisa. Ferramentas focadas em URL, como o gerador de QR Code do gourl.ai, transformam um endereço da web em código. Para Wi-Fi você precisa de um gerador que aceite o texto bruto do formato abaixo, ou de um que tenha o modo Wi-Fi explícito.

O formato por trás: WIFI:S:...

Este é o pedaço que quase nenhum artigo em português mostra, e é o que resolve 90% dos problemas quando o QR não funciona. O conteúdo do código é literalmente esta linha:

`` WIFI:S:NomeDaRede;T:WPA;P:minhasenha123;; ``

Os campos:

Repare nos dois pontos e vírgula do final. Não é erro de digitação: cada campo termina em ; e a string inteira termina com mais um. Faltando esse fechamento, alguns leitores ignoram o código.

Duas armadilhas de escape que derrubam QR aparentemente perfeitos:

1. Se o nome da rede ou a senha contiver \, ;, ,, : ou ", cada um desses caracteres precisa ser precedido de uma contrabarra. Uma senha casa;123 vira casa\;123.
2. Se a senha for composta só de caracteres hexadecimais (números e letras de A a F), coloque entre aspas duplas. Sem isso, o leitor pode interpretar como chave hexadecimal e não como texto.

Rede oculta fica assim:

`` WIFI:S:RedeEscondida;T:WPA;P:senha;H:true;; ``

O erro que ninguém avisa: você acabou de imprimir sua senha

O QR Code não criptografa nada. Ele codifica. Qualquer pessoa que escanear com um leitor comum vê a senha em texto puro na tela, e pode fotografar o código para usar semanas depois, de dentro do carro estacionado na frente.

Isso não é um problema quando a rede é só internet. Vira um problema sério quando é a rede principal, porque nela costumam estar a impressora, as câmeras, o computador do caixa, o NAS com arquivos e qualquer dispositivo doméstico com senha padrão de fábrica. Quem entra na rede não fica só navegando: fica junto dos seus aparelhos.

A regra prática é curta: QR impresso e visível só para a rede de visitantes. Praticamente todo roteador atual tem essa opção, às vezes chamada de rede de convidados ou guest. Ative, dê uma senha diferente da principal, marque a opção de isolar clientes se existir, e gere o QR dessa rede. Se um dia a senha vazar, o prejuízo é banda, não acesso.

Em casa, entre pessoas conhecidas, compartilhar a rede principal pelo QR direto do Android é aceitável, porque o código não fica pendurado na parede.

iPhone, Android e os casos em que não funciona

iPhone lê QR de Wi-Fi pela câmera nativa desde o iOS 11. Android lê desde a versão 10, e ainda gera o código. Em ambos, a leitura não depende de app extra.

Os casos em que falha, na ordem de frequência:

• Rede corporativa com login e senha individuais (WPA2-Enterprise, aquela em que você digita usuário). O formato padrão não cobre bem esse cenário e a maioria dos celulares ignora.
• Portal de captura, aquela tela que abre pedindo aceite ou cadastro. O QR conecta na rede, mas o acesso à internet ainda depende do portal.
• Erro de digitação no SSID. O nome precisa bater caractere por caractere, incluindo maiúsculas.
• Caracteres especiais sem escape, o problema descrito acima.
• Aparelhos antigos, que leem o código mas não oferecem a opção de conectar.

Onde imprimir sem estragar a leitura

Tamanho e contraste importam mais que design. Um QR de Wi-Fi carrega bastante texto, então ele fica mais denso que um QR de link curto, e um código denso impresso pequeno demais simplesmente não lê.

O que funciona na prática:

• Mínimo de 3 cm de lado para leitura a um braço de distância. Placa de parede em recepção: 8 cm ou mais.
• Margem branca em volta, do tamanho de uns 4 módulos do próprio código. Sem margem, o leitor não encontra as bordas.
• Fundo claro, código escuro. Invertido funciona em alguns leitores e falha em outros.
• Nada de imprimir sobre foto, textura ou plástico muito brilhante.
• Escreva o nome da rede embaixo, em texto legível. Quem estiver com o celular sem bateria ainda consegue digitar.

E teste com dois celulares diferentes, um iPhone e um Android, antes de mandar imprimir cem adesivos.

Quando não usar QR de Wi-Fi

Nem toda situação pede esse tipo de código.

Se a sua intenção é levar o cliente ao cardápio, ao catálogo ou ao WhatsApp, o QR certo é de link, não de Wi-Fi. São coisas diferentes, e juntar as duas num código só não é possível. Nesse caso vale ter dois códigos, ou um QR de link apontando para uma página com todos os links.

Também não use se a senha muda com frequência, porque cada troca invalida todo material impresso. E não use em rede aberta sem senha: o nopass funciona, mas o ganho é quase nulo, já que conectar em rede aberta é um toque na lista.

Por fim, se o ambiente exige controle de quem entra (coworking, evento pago, escritório com dados sensíveis), QR impresso é o oposto do que você quer. Ali o caminho é senha rotativa entregue individualmente, ou uma solução com autenticação de verdade.