Guia de gerador de QR Code: formatos, tamanho e testes

Última atualização: June 28, 2026

Um QR code é um código de barras 2D que uma câmera de telefone escaneia para abrir uma URL, compartilhar informações de contato, conectar-se ao Wi-Fi ou enviar uma mensagem. Gerar um é fácil; gerar um que escaneie de forma confiável depende de três coisas: correção de erro suficiente, alto contraste e o tamanho físico correto para a distância de leitura. Este guia aborda o que os QR codes codificam, como gerar um personalizado e os erros que tornam os códigos ilegíveis.

Resposta rápida: como gerar um código QR?

Para um código, use o QR Code Generator; para lotes, a biblioteca Python qrcode ou o CLI qrencode. Se o código for usado em um material gráfico de campanha, prepare a arte circundante com o image resizer e verifique as dimensões de destino no social media image sizes guide.

O que um código QR pode codificar?

Códigos QR não são apenas URLs — eles podem codificar vários tipos de dados que os telefones reconhecem e agem:

• URL — abre uma página da web (o uso mais comum).
• vCard — adiciona um contato à agenda do telefone.
• Wi-Fi — conecta-se a uma rede Wi-Fi (SSID + senha embutida).
• SMS / email / phone — abre uma mensagem ou disca um número.
• Texto simples — qualquer string, exibida como texto.

O tipo de dado é codificado na carga útil (payload) do QR, para que o telefone escaneador saiba o que fazer. Um QR URL abre o navegador; um QR Wi-Fi abre o prompt de conexão à rede.

Como gerar um código QR?

Gerador de Navegador

Para um código, use o QR Code Generator: escolha o tipo (URL, vCard, Wi-Fi), insira os dados, defina opcionalmente uma cor de marca ou logotipo e baixe o PNG/SVG. SVG é melhor para impressão porque escala sem pixelização.

Linha de Comando (qrencode)

## Generate a URL QR as PNG
qrencode -o qr.png -s 20 -m 2 "https://imagic-ai.com"

## As SVG (for print)
qrencode -o qr.svg -t SVG "https://imagic-ai.com"

Python (qrcode)

import qrcode
qr = qrcode.QRCode(box_size=20, border=2, error_correction=qrcode.constants.ERROR_CORRECT_M)
qr.add_data("https://imagic-ai.com")
qr.make(fit=True)
qr.make_image(fill_color="black", back_color="white").save("qr.png")

Para lotes (centenas de códigos de um CSV), a biblioteca Python é a ferramenta certa.

O que é correção de erros e por que isso importa?

Os QR codes possuem correção de erros embutida (Reed-Solomon) para que continuem escaneando mesmo quando parcialmente danificados, sujos ou sobrepostos com um logotipo. Existem quatro níveis:

Uma correção mais alta permite que você coloque um logotipo no centro ou sobreviva ao desgaste, mas torna o código mais denso (mais módulos). Use H ao adicionar um logotipo ou imprimir para uso externo; M é suficiente para a maioria dos casos.

Como você marca um código QR sem estragá-lo?

Você pode mudar a cor do primeiro plano e adicionar um logotipo central, mas ambos arriscam a escaneabilidade:

• Cor: mantenha alto contraste — um primeiro plano escuro em fundo branco é o mais seguro. Evite pares de baixo contraste (amarelo sobre branco). O ISO/IEC 18004 QR code standard define a especificação; as diretrizes práticas de leitura do Google's QR code best practices ecoam a regra de alto contraste.
• Logotipo: mantenha-o pequeno (abaixo de ~30% da área) e centralizado, e use a correção de erro H para que o código ainda seja escaneado com o logotipo cobrindo o meio.
• Formato: mantenha os três padrões de canto "localizador" intactos; eles são como o scanner localiza e orienta o código.

Sempre teste um código com marca em um telefone real antes de imprimi-lo em qualquer lugar caro.

Qual deve ser o tamanho de um QR code impresso?

A regra geral de escaneamento: o código deve ter pelo menos 1/10 da distância de escaneamento transversal. Um código escaneado a partir de 1 meter (um pôster) precisa de ~10cm; um código escaneado a partir de 20cm (um cartão de visita) precisa de ~2cm. Torná-lo menor que isso dificulta que as câmeras de celular resolvam os módulos. Para impressão, exporte como SVG para que permaneça nítido em qualquer tamanho.

Static vs dynamic QR codes

• Static: os dados são codificados diretamente no código. O destino não pode ser alterado após a geração. Ideal para Wi-Fi, vCard e URLs permanentes.
• Dynamic: o código codifica uma URL de redirecionamento curta; o destino pode ser alterado mais tarde (e os scans rastreados). Isso requer um servidor e geralmente é um serviço pago. Ideal para campanhas de marketing onde você pode alterar a página de destino.

A escolha é importante em termos de custo e flexibilidade. Um código estático é gratuito para sempre e não depende de nenhum serviço — ele continua funcionando mesmo que a empresa geradora desapareça, porque os dados vivem no próprio código. Um código dinâmico custa dinheiro e depende de um servidor de redirecionamento ativo, mas permite alterar o destino após a impressão (corrigir um erro de digitação, trocar uma campanha) e contar scans. A divisão prática: use estático para qualquer coisa que deva funcionar para sempre sem custo contínuo (um cartão de visita, uma placa Wi-Fi, um manual de produto), e dinâmico para marketing com prazo definido onde você deseja análise e a capacidade de redirecionar. Misturar os dois é comum — estático para materiais permanentes, dinâmico para campanhas.

Erros comuns

• Baixo contraste. Um código tênue em um fundo colorido não pode ser escaneado. Use dark-on-light.
• Logotipo muito grande. Cobre os dados; use error correction H e mantenha o logotipo abaixo de 30%.
• Muito pequeno para a distância. Um código de 1cm em um pôster não pode ser escaneado do outro lado da sala.
• Padrões localizadores danificados. Os três quadrados nos cantos devem permanecer intactos.
• Rasterizando para impressão. Use SVG para que o código permaneça nítido ao ser ampliado.

Perguntas frequentes

Os códigos QR expiram?

Códigos estáticos nunca expiram — os dados estão no código. Códigos dinâmicos (uma URL de redirecionamento) expiram apenas se o serviço de redirecionamento for desativado.

Um código QR pode ter um logotipo?

Sim — coloque um pequeno logotipo no centro e use a correção de erro H. Mantenha-o abaixo de ~30% da área.

Qual é o melhor nível de correção de erro?

M para uso geral, H ao adicionar um logotipo ou imprimir para risco externo/de desgaste. O artigo Wikipedia sobre QR code cobre os níveis em detalhes.

Posso rastrear escaneamentos de código QR?

Apenas com um QR dinâmico (uma URL de redirecionamento com análise). Códigos estáticos não podem ser rastreados.

O que um código QR pode codificar?

Uma URL, texto simples, um vCard (contato), uma rede Wi-Fi, um e-mail, um SMS ou um evento de calendário. As URLs são de longe as mais comuns. O tipo de dado define como o scanner lida com o resultado — uma URL abre em um navegador, um vCard adiciona um contato, um código Wi-Fi conecta a uma rede.

O que é correção de erro e por que isso importa?

Correção de erro é redundância que permite que um QR code seja escaneado mesmo se parte estiver danificada ou coberta (até 30 por cento, no nível mais alto). Uma correção de erro maior torna um código maior e mais denso. Use-a quando o código puder estar arranhado ou quando você sobrepor um logotipo — o centro é o local mais seguro para um pequeno logotipo.

Qual tamanho deve ter um código QR impresso?

Grande o suficiente para ser escaneado da distância esperada — aproximadamente 1 polegada para um escaneamento de 2 pés, maior para distâncias maiores. Quanto menor o código, mais perto o scanner deve estar. Teste o tamanho impresso com um telefone antes de produzir em massa, porque um código muito pequeno simplesmente falha ao ser escaneado.

O que é um código QR dinâmico?

Um QR code que codifica uma URL de redirecionamento curta em vez do destino final, para que você possa mudar o ponto para onde ele aponta sem reimprimir o código e registrar escaneamentos para análise. Um QR code estático codifica o destino diretamente e não pode ser alterado ou rastreado. Códigos dinâmicos custam mais, mas são flexíveis e mensuráveis.

Como eu crio uma marca em um código QR sem quebrá-lo?

Mantenha a cor da marca com alto contraste (escuro em claro) e nunca cubra mais do que o nível de correção de erro permite — o centro é o local mais seguro para um pequeno logotipo. Teste o código com a marca em um scanner real antes de imprimir, porque baixo contraste ou muita sobreposição interrompe o escaneamento e um QR code quebrado é apenas decoração.

Um código QR pode ser muito pequeno para escanear?

Sim — abaixo de aproximadamente 1 polegada, a maioria das câmeras de telefone tem dificuldade, especialmente à distância. Dimensionar o código para a distância de escaneamento: maior para escaneamentos mais distantes. Teste o tamanho impresso com um telefone antes de produzir em massa, porque um código muito pequeno simplesmente falha ao ser escaneado e é apenas decoração.

Créditos das Imagens

• Exemplo de QR-code, QR personalizado e diagramas what-qr-encodes — os códigos QR são reais, gerados pelo autor usando a biblioteca Python qrcode codificando https://imagic-ai.com; o diagrama de tipos de codificação é ilustrado pelo autor.