Tipos de Conteudo de QR Code: URL vs vCard vs Wi-Fi vs Texto - Qual Escolher

Ultima revisao 2026-05-06. Direcionado ao momento em que voce se senta para fazer seu primeiro QR code e o gerador pergunta "que tipo de payload?". Roteia a geracao real para QR Code Generator (no navegador, sem upload).

O que esta realmente dentro de um QR code?

Um QR code e, mecanicamente, um quadrado de modulos pretos e brancos que codificam uma string de bytes. A especificacao QR (ISO/IEC 18004) nao define que string colocar - apenas define como codificar qualquer string no padrao visual. O "tipo de conteudo" de um QR code e puramente uma convencao acordada entre geradores de QR e aplicativos de scanner sobre que prefixo a string comeca. Quando um scanner le https://example.com, ele ve o prefixo https:// e trata o payload como uma URL; quando le BEGIN:VCARD, trata o payload como um cartao de contato. O QR code em si nao "sabe" o tipo; o prefixo conta ao scanner.

Tres lugares definem as convencoes de prefixo na pratica. Primeiro, esquemas URI registrados pela RFC (http, https, mailto, tel, geo, sms) sao os padroes formais da Internet que scanners confiam sem questionar. Segundo, RFC 6350 vCard 4.0 (e o mais antigo RFC 2426 vCard 3.0) define o formato de texto de cartao de contato - se um payload QR comeca com BEGIN:VCARD, segue esse formato. Terceiro, o wiki do projeto ZXing - o decodificador QR canonico de codigo aberto usado em muitos aplicativos de scanner - documenta um pequeno conjunto de prefixos de facto que nao tem especificacao formal da IETF mas sao universalmente implementados; o mais importante e o esquema URI WIFI: que iOS Camera, Android Camera e Google Lens todos interpretam como uma solicitacao de entrada em rede. Entender qual das tres fontes sustenta seu tipo de conteudo escolhido informa quao confiavelmente ele sera escaneado em telefones de fabricantes diferentes.

Tipo 1: URL - o tipo mais comum

Um QR code de URL e o payload mais simples: os caracteres literais da URL, incluindo o prefixo https://. Por exemplo, https://freetoolonline.com/utility-tools/qr-code-generator.html codificado diretamente. Cada aplicativo de scanner em cada telefone moderno reconhece isso e oferece abrir a URL no navegador padrao; muitos tambem abrem automaticamente quando a camera e apontada para o codigo a partir de um aviso "viewfinder" sem o usuario tocar explicitamente.

O prefixo https:// importa: um payload de apenas freetoolonline.com sem o esquema e tecnicamente um payload de texto puro, e a maioria dos scanners o exibe como texto em vez de oferecer abri-lo. Sempre inclua o esquema. Para codigos mais curtos, https:// tambem e ligeiramente mais longo que http:// no nivel de bytes, mas a diferenca e um byte e scanners modernos exigem https:// para que avisos de seguranca se comportem corretamente - nunca tire o s para economizar um byte.

Quando escolher URL. Tenda de mesa de conferencia que abre uma pagina de aterrissagem de evento; cardapio de restaurante que abre um menu online; embalagem de produto que abre um video de instrucao; folheto que abre um formulario de inscricao; assinatura de e-mail que abre seu portfolio. Qualquer cenario onde a acao desejada e "abrir esta pagina da web em um navegador de telefone" e um QR code de URL.

Tipo 2: vCard - para cartoes de contato

Um QR code vCard codifica um cartao de contato no formato vCard 4.0 do RFC 6350 (ou o mais antigo vCard 3.0 do RFC 2426; ambos ainda em uso ativo). O payload comeca com BEGIN:VCARD e termina com END:VCARD, com campos de nome, telefone, e-mail, organizacao e URL entre eles. Um vCard 3.0 minimo se parece com:

BEGIN:VCARD
VERSION:3.0
N:Smith;Jane
FN:Jane Smith
ORG:Example Corp
TEL:+1-555-0100
EMAIL:jane@example.com
URL:https://example.com/jane
END:VCARD

Quando um scanner le isso, ele oferece salvar o contato - normalmente abrindo o aplicativo de contatos do telefone pre-preenchido com os campos, pronto para confirmar. iOS Camera, Android Camera, Google Lens e a maioria dos aplicativos de scanner QR de terceiros todos suportam payloads vCard.

O trade-off e o comprimento do payload: um vCard completo com nome, telefone, e-mail, organizacao, endereco e URL frequentemente tem 200-350 bytes, o que produz um QR code denso que e mais dificil de escanear em tamanhos de impressao pequenos. Duas mitigacoes praticas: (a) mantenha o vCard minimo (nome, telefone unico, e-mail unico - pule endereco e organizacao se nao forem essenciais), e (b) imprima o QR code com pelo menos 3 cm x 3 cm para que o padrao denso permaneca legivel em distancias de leitura tipicas. O guia complementar sobre tamanho de payload em QR Code Error Correction and Scan Failures cobre o trade-off tamanho-vs-payload em detalhe.

MECARD: uma alternativa vCard menor. Um formato mais antigo chamado MECARD (originado pela NTT DoCoMo para telefones feature japoneses) usa o prefixo MECARD: e uma sintaxe de campo mais compacta: MECARD:N:Smith,Jane;TEL:5550100;EMAIL:jane@example.com;;. Payloads MECARD sao tipicamente 30-40% mais curtos que o vCard equivalente, o que produz um codigo mais esparso e facil de escanear. A maioria dos scanners modernos (iOS Camera, Android Camera, Google Lens, aplicativos baseados em ZXing) reconhecem MECARD; scanners mais antigos podem nao. Se seu publico e global e principalmente em telefones de versao atual, MECARD e uma boa escolha quando o tamanho de impressao e restrito; caso contrario vCard 3.0 e o padrao mais seguro.

Quando escolher vCard ou MECARD. Cartao de visita com um QR "escanear para salvar meu contato"; cordao em uma conferencia; cracha de funcionario de evento que permite que participantes peguem o contato do organizador; folheto impresso de imobiliaria com o contato do agente pre-preenchido. Qualquer cenario onde a acao desejada e "salvar os detalhes de contato desta pessoa no telefone" e um QR code vCard ou MECARD.

Tipo 3: Wi-Fi - para entrar em uma rede

Um QR code Wi-Fi codifica uma credencial de rede que pede ao scanner para entrar na rede. O formato e documentado no wiki do projeto ZXing e e implementado nativamente pelo iOS Camera (desde iOS 11), Android Camera (desde Android 10 no Pixel; varia em outros fabricantes) e Google Lens. A sintaxe do payload e:

WIFI:S:<ssid>;T:<auth_type>;P:<password>;H:<hidden>;;

Onde S: e o nome da rede (SSID), T: e o tipo de autenticacao (WPA para WPA / WPA2 / WPA3, WEP para WEP legado, nopass para redes abertas), P: e a senha (omita para redes abertas), e H:true marca a rede como oculta (a maioria das redes omite este campo). Um codigo Wi-Fi tipico de cafe se parece com: WIFI:S:CafeGuest;T:WPA;P:welcome2026;;. Note o ponto e virgula duplo final - ele termina o payload.

O formato Wi-Fi nao tem RFC formal da IETF; e um padrao de facto documentado no wiki ZXing e implementado pelos principais aplicativos de camera. Isso significa que em um iPhone atual estavel ou Pixel o codigo "simplesmente funciona", mas em telefones mais antigos (pre-iOS 11; pre-Android 10 na maioria dos fabricantes nao-Pixel) o payload pode exibir como texto bruto em vez de disparar um prompt de entrada em rede. Para audiencias mistas, imprima o SSID e a senha como texto puro embaixo do QR code para que usuarios com telefones mais antigos ainda possam entrar manualmente.

Caracteres especiais em senhas. Se o SSID ou senha contem um literal ;, :, ,, ", ou \, esses caracteres devem ser escapados com barra invertida no payload (\\;, \\:, etc.). A maioria dos geradores QR lida com isso automaticamente, mas se voce esta editando um payload a mao isso e a fonte mais comum de relatos "o codigo gerou mas meu telefone se recusa a entrar".

Quando escolher Wi-Fi. Rede de convidados de cafe em um cartao de mesa; pacote de boas-vindas de coworking; folheto de green-room de conferencia; listagem de Airbnb que pre-compartilha o codigo na mensagem de boas-vindas. Qualquer cenario onde a acao desejada e "deixar o visitante entrar no meu Wi-Fi sem digitar uma senha" e um QR code Wi-Fi.

Tipo 4: Texto puro - para notas curtas

Um QR code de texto puro e os caracteres literais do texto, sem prefixo especial. Quando um scanner le isso, o texto e exibido em um painel "conteudo escaneado" e o usuario pode copia-lo para a area de transferencia. Nao ha abertura automatica, nao ha salvamento automatico, nao ha entrada automatica - apenas texto na tela.

Texto puro e a escolha certa quando nenhum dos outros tipos serve: uma senha de Wi-Fi onde voce nao quer entrada automatica (voce quer que o usuario copie e cole sozinho), um numero de serie curto em um equipamento, um codigo do dia do evento, um endereco de Bitcoin, um codigo de cupom de desconto. O trade-off e que na maioria dos scanners texto puro recebe a interface de menor atrito - o usuario tem que ler o texto e decidir o que fazer com ele - o que e exatamente certo para alguns payloads (um codigo de cupom) e exatamente errado para outros (uma URL de 150 caracteres que teria sido melhor como um QR code de URL).

Quando escolher texto puro. Codigo de cupom em folheto impresso; numero de serie em equipamento; senha de Wi-Fi de conferencia onde o SSID e anunciado em voz alta e o QR contem apenas a senha; endereco de criptomoeda; nota curta ("peca a recepcao para validacao de estacionamento"). Qualquer cenario onde a acao desejada e "o usuario le o texto e digita manualmente em outro lugar" e um QR code de texto puro.

Outros tipos de conteudo que vale a pena saber

Alem dos quatro tipos primarios, varios prefixos menos comuns tem suporte universal de scanner e podem ser o ajuste certo para cenarios estreitos:

• E-mail (mailto:) - abre o aplicativo de e-mail padrao com o endereco e assunto/corpo opcional pre-preenchidos. Formato: mailto:hello@example.com?subject=Inquiry&body=From%20conference%20booth. Os caracteres reservados em assunto e corpo devem ser codificados em percentual conforme RFC 3986 (codificacao URL).
• Telefone (tel:) - abre o discador com o numero pre-inserido (o usuario ainda pressiona Ligar). Formato: tel:+15551234567. Sempre inclua o codigo do pais com um + inicial.
• SMS (smsto: ou sms:) - abre o aplicativo de mensagens com o destinatario e corpo opcional pre-preenchidos. Formato: smsto:+15551234567:Hello,%20I%20saw%20your%20flyer ou sms:+15551234567?body=Hello. Os dois formatos coexistem; smsto: e mais antigo mas ainda amplamente suportado.
• Geolocalizacao (geo:) - abre o aplicativo de mapas padrao na latitude/longitude fornecida. Formato: geo:48.8566,2.3522?q=Notre+Dame+Paris. O rotulo ?q= e opcional; sem ele o aplicativo mostra apenas um alfinete.
• Evento de calendario (BEGIN:VEVENT do iCalendar RFC 5545) - pede ao scanner para adicionar um evento ao calendario. Formato comeca com BEGIN:VEVENT e termina com END:VEVENT. Menos suportado universalmente que vCard - teste nos telefones do publico alvo antes de imprimir em escala.

Decisao: qual tipo para qual cenario

Se voce sabe o que quer que o scanner faca, o tipo e normalmente obvio. O mapeamento:

• Abrir uma pagina web no navegador → URL.
• Salvar um contato no telefone → vCard (ou MECARD se o tamanho de impressao e pequeno).
• Entrar em uma rede Wi-Fi → Wi-Fi. Imprima SSID e senha como texto puro ao lado para telefones mais antigos.
• Exibir um codigo ou nota para o usuario copiar → texto puro.
• Compor um e-mail → mailto:. Pre-preencha assunto e corpo para clareza.
• Fazer uma chamada telefonica → tel:. Sempre inclua o codigo de pais internacional.
• Enviar um SMS pre-preenchido → smsto:.
• Abrir um mapa em uma localizacao → geo:.
• Adicionar um evento de calendario → VEVENT (teste primeiro o suporte de scanner).

Quando em duvida entre duas opcoes, escolha aquela com o payload mais curto - payloads mais curtos produzem codigos mais esparsos e confiaveis. Uma URL curta que redireciona para uma URL longa e quase sempre mais confiavel que codificar a URL longa diretamente; o redirecionamento carrega os parametros de rastreamento do lado do servidor.

Tamanho de payload, correcao de erro, e o trade-off de confiabilidade de leitura

QR codes tem um payload maximo fixo em cada tamanho; quanto mais longo o payload, mais denso o padrao, e maior o tamanho de impressao necessario para mante-lo escaneavel. Como guia aproximado: uma URL de 25 caracteres produz um codigo esparso que escaneia a um metro de distancia em uma camera de telefone; um vCard de 200 caracteres produz um codigo denso que precisa ter pelo menos 3 cm x 3 cm e ser escaneado a no maximo 30 cm. O guia dedicado em QR Code Error Correction and Scan Failures cobre os quatro niveis de correcao de erro (L / M / Q / H) e o trade-off tamanho-vs-payload, com recomendacoes concretas de tamanho de impressao por cenario.

Dois padroes praticos que funcionam para quase todo cenario de impressao: nivel M de correcao de erro (~15% de tolerancia a dano) para uso interno e nivel Q (~25%) para superficies externas ou desgastadas; um tamanho minimo de 2 cm x 2 cm para payloads curtos (URL abaixo de 50 caracteres), 3 cm x 3 cm para payloads medios (vCard, Wi-Fi), e 4 cm x 4 cm para URLs longas acima de 100 caracteres. Qualquer coisa menor e uma fracao significativa de telefones falhara ao escanear.

Privacidade: o que um QR code codifica e o que nao

Um QR code codifica apenas a string literal de payload. Nao ha endereco IP, nao ha ID de dispositivo, nao ha timestamp, nao ha localizacao, nao ha dados de analytics ocultos no padrao - o codigo e exatamente o que voce coloca dentro, nada mais. Gerar um QR code localmente no navegador (que e o que QR Code Generator neste site faz) mantem o payload inteiramente no seu dispositivo; nada sobre seus QR codes e enviado para qualquer servidor durante a geracao.

Se voce codifica uma URL que aponta para um rastreador de analytics do lado do servidor ou uma URL com parametros UTM, os analytics acontecem do lado do recebimento quando o scanner abre a URL - o QR code em si e apenas bytes estaticos. Codigos Wi-Fi carregam a senha literal; trate codigos Wi-Fi impressos da mesma forma que trataria a senha em texto puro (nao os deixe em pontos publicamente fotografaveis se a rede e sensivel).

Leitura relacionada

• QR Code Generator - o gerador no navegador que cria cada um dos tipos de conteudo descritos acima; escolha o tipo, preencha os campos, baixe o PNG. Sem upload, sem instalacao.
• QR Code Generator: Best Practices - nivel de correcao de erro, contraste, tamanho fisico, e as cinco configuracoes que decidem se um codigo escaneia confiavelmente.
• QR Code Error Correction and Scan Failures - como diagnosticar um codigo que nao escaneia, com correcoes concretas para os modos de falha mais comuns.
• Free Online Tools That Work Without Uploading Files - a selecao mais ampla de ferramentas privacidade-primeiro neste site, da qual o gerador QR e um exemplo.