Como criar QR codes para URLs, Wi-Fi e cartões de contato

Códigos QR estão em todo lugar: menus de restaurante, cartões de visita, embalagens de produto, ingressos de eventos, apps de pagamento, passaportes vacinais. São um jeito rápido de levar alguém do mundo físico a um destino digital sem digitar uma URL, ditar uma senha de Wi-Fi ou copiar dados de contato. Criar um leva segundos, não custa nada, e (ao contrário dos serviços de link curto) o código QR continua funcionando para sempre porque o destino é codificado direto na imagem.

Breve história do código QR

Códigos QR foram inventados em 1994 por Masahiro Hara e uma pequena equipe na Denso Wave, subsidiária da Denso Corporation, a maior fabricante japonesa de componentes automotivos. «QR» significa «Quick Response»: as fábricas da Toyota precisavam de um código de barras lido em qualquer rotação, que armazenasse mais dados que um Code 39, e fosse escaneado quase instantaneamente para a linha de montagem não parar. O resultado foi um código bidimensional quadrado com três grandes padrões de detecção de posição nos cantos, permitindo a qualquer scanner determinar orientação num só frame.

A Denso Wave publicou o design abertamente. A ISO o padronizou como ISO/IEC 18004 em 2000, com revisões em 2006 e 2015. Crucialmente, a Denso Wave escolheu nunca exigir suas patentes, o que deixou os QR se espalharem livremente. O Japão os adotou primeiro para tudo, do rastreio de cadeia logística a máquinas de venda; Ásia e Europa seguiram nos anos 2000. A virada no Ocidente veio quando iOS 11 (setembro de 2017) e Android (via Google Lens, também 2017) adicionaram leitura nativa de QR ao app de câmera, eliminando a necessidade de app separado. A pandemia de 2020-2021 terminou o serviço: todo restaurante, toda academia, todo museu precisou de menu ou check-in sem contato, e o QR já estava em todo bolso.

Hoje o código QR carrega centenas de bilhões de leituras por ano. WeChat Pay e Alipay na China dependem inteiramente dele; UPI na Índia movimenta pagamentos via QR para um bilhão de usuários; vCards em cartões de visita praticamente substituíram dados digitados. É um dos poucos padrões trintões que ficou mais útil, não menos, com o tempo.

O que códigos QR podem fazer

Um código QR é uma forma de codificar uma carga útil de texto numa imagem escaneável. O que acontece quando alguém escaneia depende do formato desse texto:

• URL: https://example.com/... abre o link no navegador do scanner.
• Credenciais Wi-Fi: WIFI:T:WPA;S:NetworkName;P:Password;; entra na rede automaticamente.
• vCard (cartão de contato): BEGIN:VCARD ... END:VCARD adiciona o contato à agenda.
• Texto puro: qualquer outra string aparece na tela do scanner.
• Email: mailto:address@example.com?subject=...&body=... abre um rascunho de email.
• Número de telefone: tel:+15551234567 oferece ligar.
• SMS: smsto:+15551234567:Olá abre uma mensagem pré-preenchida.
• Localização geo: geo:48.8566,2.3522 abre as coordenadas no app de mapas do aparelho.
• Evento de calendário: BEGIN:VEVENT ... END:VEVENT (iCalendar) adiciona o evento ao calendário.

O código QR em si não liga; os handlers de URL do aparelho que escaneia é que decidem.

Como um código QR é construído

Um código QR é uma grade quadrada de «módulos» preto-e-branco (os quadradinhos). A estrutura é fixa:

• Três padrões localizadores (os grandes quadrados concêntricos em três cantos) dizem ao scanner onde está o código e qual lado é cima.
• Padrões de alinhamento (menores, em códigos maiores) corrigem a distorção de perspectiva quando o código é fotografado de ângulo.
• Padrões de temporização (linhas alternadas preto/branco entre os localizadores) dizem ao scanner o tamanho de cada módulo.
• Informação de formato guarda o nível de correção de erro e o padrão de mascaramento, repetida duas vezes para redundância.
• Palavras de dados e correção ocupam o grosso da área. A correção Reed-Solomon permite ao scanner recuperar a mensagem mesmo se parte do código estiver suja, arranhada ou obstruída.

Códigos QR vêm em 40 versões, da versão 1 (21x21 módulos, máx. ~25 caracteres alfanuméricos com correção L) à versão 40 (177x177 módulos, máx. ~4 296 caracteres alfanuméricos com L). O gerador escolhe a menor versão que cabe na sua carga no nível de correção escolhido.

Como criar um código QR

1. Escolha o tipo de QR: URL, texto puro, rede Wi-Fi, vCard, email, telefone, SMS, ou geo. A ferramenta monta o formato de carga certo para você.
2. Insira o conteúdo: cole a URL ou preencha os campos estruturados. A pré-visualização do QR atualiza enquanto você digita.
3. Escolha um nível de correção: L (baixo) para telas digitais, M (médio) para uso geral, Q (quartil) para impressos que podem desgastar, H (alto) se quiser sobrepor um logo.
4. Personalize aparência (opcional): ajuste cor de frente, cor de fundo, forma do módulo, e adicione um logo no centro. Mantenha sempre contraste suficiente.
5. Baixe: PNG para telas, SVG para impressão, PDF se quiser colocar o código numa diagramação. A ferramenta também gera uma miniatura 32x32 para pré-testar antes de exportar.

Entendendo a correção de erro

Códigos QR têm redundância embutida que permite serem lidos mesmo se parte do código estiver danificada ou oculta. Há quatro níveis:

Correção maior significa mais módulos (mais quadradinhos), então a mesma carga vira um código mais denso que precisa ser impresso um pouco maior para continuar escaneável. O tradeoff é confiabilidade versus tamanho.

Usos práticos

Para empresas:

• Imprima vCard em cartões de visita para que contatos salvem seus dados num escaneio, sem digitar.
• Adicione um QR à embalagem do produto levando a um vídeo de configuração, página de registro de garantia ou guia de troubleshooting.
• Exiba na vitrine um QR para seu site, menu, horários ou página de avaliações Google.
• Coloque um QR Wi-Fi no recibo ou no cavalete de mesa para clientes entrarem sem você ler a senha.
• Adicione a faturas de evento um QR que leve direto a uma página de pagamento (Stripe, Square, UPI).

Para eventos:

• Gere QR Wi-Fi para convidados, sem mais soletrar senhas.
• Linke o programa impresso ao cronograma ao vivo, mapas ou formulário de feedback da sessão.
• Adicione aos crachás QR para perfis LinkedIn ou bios de palestrantes.
• Faça uma promo «escaneie para entrar no sorteio» que leve a um formulário de inscrição.
• Imprima nos cartões de mesa QR ligando à hashtag do evento no Instagram ou X.

Para uso pessoal:

• Compartilhe a senha Wi-Fi de casa com visitantes sem ditá-la.
• Crie um QR para seu site pessoal, portfólio ou currículo.
• Adicione a convites impressos um QR para páginas de RSVP.
• Use um QR vCard no verso de crachás de conferência.
• Gere um QR que entra numa videochamada (Zoom ou Google Meet) para reuniões híbridas.

Dicas para QR que funcionam bem

• Teste antes de imprimir. Escaneie sempre com um celular real antes de mandar imprimir. Teste com câmera iOS e Google Lens no Android se possível.
• Mantenha URLs curtas. URLs mais curtas produzem QR mais simples (versão menor, menos módulos), mais fáceis de escanear em tamanho pequeno. Use um encurtador sem tracking se precisar.
• Garanta contraste. Módulos escuros sobre fundo claro vai melhor. O invertido (claro sobre escuro) é tecnicamente permitido pela spec mas mal suportado por scanners antigos.
• Mantenha a zona quieta. A borda branca em volta do QR, de quatro módulos, ajuda scanners a detectá-lo. Não corte para dentro nem coloque outros gráficos dentro.
• Ajuste tamanho à distância de leitura. Regra: a largura do código deve ser pelo menos 10 % da distância esperada: 5 cm para 50 cm de leitura, 1 m para 10 m.
• Escolha correção H se adicionar logo. Cubra no máximo 20 % da área, mantenha o logo perto do centro, e teste sempre o escaneio.
• Evite pares de cor extremos. Vermelho sobre verde, azul sobre roxo e outros pares de baixo contraste escaneiam mal. Fique com pares de alto contraste ou no preto-sobre-branco.
• Use QR estáticos quando puder. Eles nunca expiram e não dependem de nenhum serviço de terceiros.
• Adicione um rótulo legível. Imprima «Escaneie para entrar no Wi-Fi» ou «Escaneie para o menu» ao lado do código para as pessoas saberem para que é antes de escanear.

Armadilhas comuns

• URLs cheias de tracking. Uma URL curta e limpa é mais confiável e amigável que um link UTM de 200 caracteres. Use UTM só se o valor analítico justificar os módulos extras.
• Inverter cores sem testar. QRs branco-sobre-preto são permitidos mas rejeitados por ~10 % dos scanners em circulação. Se as cores de marca conflitam, mude as cores de marca para essa impressão, não o QR.
• Logo grande demais. Mesmo na correção H, cobertura acima de 25-30 % começa a falhar. Teste em três celulares diferentes antes de imprimir.
• Distorção em superfície curva. Um QR no lado de uma garrafa ou placa curva pode falhar porque a perspectiva distorce os módulos. Use um adesivo plano, código maior, ou o coloque na parte plana.
• Resolução de impressão. Um QR impresso a 72 dpi a partir de um PNG de baixa resolução borra. Gere a 300 dpi ou use SVG.
• Códigos estáticos para o que vai mudar. Se a URL de destino vai mudar (evento que muda de lugar, desconto que acaba), use QR dinâmico (serviço pago) ou uma URL de redirecionamento estável que você controle.
• Pular a zona quieta. Um QR que encosta em gráficos ou texto ao redor falha em ser reconhecido. Deixe sempre quatro módulos de margem.
• Desencontro de distância de leitura. Um QR de 5 cm num cartaz pensado para leitura a 3 m não funciona. Ajuste o tamanho à distância.
• Risco de phishing. QRs podem esconder a URL. Scanners que mostram o destino antes de abrir (iOS, Google Lens) ajudam, mas um atacante esperto pode falsificar. Imprima «Escaneie para o menu» ao lado do código para destinos inesperados parecerem errados.
• QR Wi-Fi com senha em texto claro. É por design (o formato é WIFI:T:WPA;S:Nome;P:Senha;;), mas significa que quem fotografar o código tem a senha. Trate QR Wi-Fi impressos como uma senha impressa.

Alternativas e formatos vizinhos

QR é o código 2D mais universal mas não o único. Formatos diferentes ganham em contextos diferentes.

Para quase todos os usos voltados ao consumidor, Código QR é a resposta certa porque todo celular moderno o escaneia nativamente. Os outros são especializados.

Privacidade e o gerador

O gerador de código QR roda inteiramente no seu navegador. A URL, senha Wi-Fi, vCard ou outra carga que você insere é renderizada para uma matriz QR por JavaScript no seu dispositivo, o PNG ou SVG resultante é oferecido como download, e nada é enviado a um servidor. Nada é registrado, nenhuma URL encurtada é criada, e nenhum tracker de terceiros é adicionado ao destino. Para cargas que realmente importam (sua senha Wi-Fi de casa, uma URL de produto não lançado, um link Zoom interno, seu celular pessoal), esse fluxo estritamente local é a diferença entre confiar no encurtador de um estranho e não confiar em ninguém. A ferramenta inteira pode rodar offline depois que a página carrega, o que você pode verificar desligando a rede e regenerando o mesmo código.