Como faço um QR code para o Wi-Fi dos clientes?

Por que um link não dá conta desse trabalho

Nenhuma página da web consegue conectar um celular a uma rede Wi-Fi. Os navegadores não têm como fazer isso: num iPhone o único caminho é instalar um perfil de configuração, ou seja, vários passos pelos Ajustes com um aviso de «Não verificado» no meio, e no Android é preciso um aplicativo. Então um código que abre uma página pode mostrar a senha para o cliente copiar, e é só isso que ele consegue fazer.

Um QR code de Wi-Fi funciona de outro jeito. Em vez de um endereço da web, o desenho soletra uma linha de texto que os celulares leem há anos, e são os próprios ajustes de Wi-Fi do celular que fazem a conexão. Nada é carregado e não é preciso conexão com a internet para lê-lo, o que importa mais do que parece: um cliente não tem internet antes de estar na rede.

O que o código carrega

A linha que fica dentro de um QR code de Wi-Fi tem esta cara: WIFI:T:WPA;S:Cafe Guest;P:flat-white-42;;. Três campos fazem o trabalho.

• `S` — o nome da rede. O SSID, exatamente como o roteador o transmite, maiúsculas incluídas. «Cafe Guest» e «cafe guest» são duas redes diferentes para um celular, e um espaço no fim faz parte do nome.
• `P` — a senha. Também exatamente, maiúsculas incluídas. Omitida por completo numa rede aberta.
• `T` — o tipo de segurança. WPA cobre WPA, WPA2 e WPA3, isto é, quase todo roteador vendido neste século. WEP é para roteadores velhos o bastante para merecer troca. nopass é uma rede sem senha alguma.

Um quarto campo, H:true, é para uma rede que não transmite o próprio nome. Marque-o só se o nome estiver realmente oculto no roteador: um celular procura uma rede oculta de outra maneira, e no sentido contrário a conexão também falha.

Pontuação na senha

É o ponto e vírgula que separa um campo do seguinte, então uma senha com ponto e vírgula quebra o código, a menos que esse ponto e vírgula seja marcado como parte da senha em vez de fim de campo. Cinco caracteres precisam dessa marca — \, ;, ,, : e " — cada um com uma barra invertida na frente. Uma senha feita só de dígitos hexadecimais, deadbeef12 por exemplo, ainda precisa vir entre aspas, senão um celular pode lê-la como uma chave WEP em hexadecimal em vez do texto que você quis.

Esse é o motivo habitual de um QR code de Wi-Fi feito à mão ser lido mas não conectar. A aba Wi-Fi da QRVane cuida do escape e das aspas por você. Se você mesmo escrever a linha, teste num iPhone e num celular Android antes de qualquer coisa ir para a impressão.

Quais celulares oferecem a entrada com um toque

A câmera do iPhone lê QR codes de Wi-Fi desde o iOS 11, de 2017: aponte para o código e um aviso oferece a rede, depois os Ajustes pedem confirmação. O Android faz o mesmo desde o Android 10, de 2019, pela câmera ou pelo Google Lens. Celulares mais antigos, e algumas interfaces Android, querem primeiro um aplicativo leitor de QR code: o formato é uma norma e não a invenção particular de alguém, então esse aplicativo lê o mesmo código que uma câmera.

O celular precisa estar no alcance da rede para a conexão se completar. Um cliente que fotografa o código e escaneia a foto em casa não consegue nada, o que é sensato e não um defeito.

Onde imprimir

• Na mesa. Um display de mesa ou um cartãozinho é a primeira coisa que um cliente olha, e fica ao alcance do braço de quem está sentado.
• Ao lado do balcão, na altura dos olhos. Um código atrás de um vidro, embaixo do caixa ou no fundo de uma prateleira é um código que ninguém escaneia.
• Não só no roteador. A etiqueta do roteador é para a equipe. Um cliente não deveria ter de se debruçar sobre o balcão para lê-la.

Imprima o nome da rede ao lado do código em letra legível, e a senha também, se a rede é para clientes de qualquer forma. Um celular que se recusa a escanear, e qualquer notebook, ainda têm assim um jeito de entrar. De que tamanho imprimir um QR code calcula uma largura para cada um desses lugares.

Quando a senha muda

Os celulares se conectam direto por este código. Se a senha mudar, crie um novo.

Não há como contornar: a senha está no desenho, e tinta não se reescreve. Vale então decidir com que frequência a senha dos clientes vai mudar antes de mandar uma tiragem para a impressão. Um café que a troca todo mês quer cartões baratos que possa reimprimir; o que define uma senha e deixa quieto pode imprimir algo durável.

Se o que você quer poder mudar depois é uma página e não uma rede — um cardápio, um formulário de reserva, um link de avaliações —, isso é outro tipo de código, e um que você pode apontar para outro lugar depois de imprimir. Como mudar o destino de um QR code trata disso, e colocar o cardápio atrás de um QR code é a versão que a maioria dos cafés quer.

Uma rede de visitantes separada vale esses dez minutos

Seja qual for o código que você imprima, a rede em que ele coloca as pessoas não deveria ser a da maquininha de cartão, do caixa e do computador do escritório. Quase todo roteador tem um ajuste de rede de visitantes que dá internet aos visitantes e nada mais; ligá-lo leva poucos minutos nos ajustes do roteador e é a coisa mais útil desta página. Imprima o código dessa rede, não o da principal.

O que a QRVane guarda

Nada. O QR code de Wi-Fi é montado no seu navegador: o nome da rede e a senha nunca são enviados para nós, nunca são escritos no nosso banco de dados e nunca entram em contagem de leituras alguma. Não há página atrás deste código nem link curto dentro dele — os dados da rede são todo o seu conteúdo. Ele fica fora do período gratuito de 14 dias e fora dos planos, e não conta para os códigos que um plano mantém ativos.

Baixá-lo ainda pede seu endereço de e-mail e o código de 4 dígitos que enviamos, porque é assim que qualquer código ganha um dono. O arquivo se salva sozinho assim que o código é verificado. Desenhe um código, informe um e-mail e digite o código de 4 dígitos que enviamos para ele. Não há senha nem nada para configurar. O código pertence a esse endereço: só quem lê essa caixa de entrada pode alterá-lo, ver suas leituras ou assinar um plano que o mantenha ativo.