Publicado 2026-10-27
# QR Code para Contato: Campos vCard e Armadilhas de Formato
Um QR code para contato codifica um vCard — o mesmo formato que os telefones usam ao exportar um contato — de modo que uma leitura adiciona a pessoa inteira, não apenas um número. A especificação vCard data de 1995 (RFC 2426, v3.0) e é o que todos os principais telefones vêm oferecendo desde então. A camada de matriz segue a ISO/IEC 18004, portanto qualquer leitor compatível o decodifica.
Como o vCard Funciona
Um vCard é um registro de texto simples: BEGIN:VCARD, os campos, END:VCARD. Os telefones aceitam a v3.0 quase universalmente; a v4.0 (RFC 6350) é mais nova, mas não é suportada por muitos discadores Android, portanto a 3.0 é o padrão seguro. A matriz que a carrega é um QR code padrão sob a ISO/IEC 18004 — veja O que é um Código QR?.
Referência de Campos
| Campo | Sintaxe v3.0 | Obrigatório | Exemplo | Observações |
|---|---|---|---|---|
| Versão | VERSION:3.0 | Sim | VERSION:3.0 | Primeira linha após BEGIN |
| Nome | N:Family;Given;;; | Sim | N:Chen;Wei;;; | Sobrenome primeiro, depois nome |
| Nome de exibição | FN:Wei Chen | Não | FN:Wei Chen | O que o app de contatos exibe |
| Telefone | TEL;TYPE=CELL:+86… | Não | TEL;TYPE=CELL:+8613800001234 | Uma linha por número |
EMAIL:hi@x.com | Não | EMAIL:hi@codeboxhub.com | Múltiplas linhas permitidas | |
| Organização | ORG:Company | Não | ORG:CodeBox | Parâmetro de tipo opcional |
| Cargo | TITLE:Engineer | Não | TITLE:Staff Engineer | Cargo, não a empresa |
| Endereço | ADR;TYPE=WORK:… | Não | ADR;TYPE=WORK:;;1 Main St;City;ST;100000;CN | Ordem fixa de campos |
| Foto | PHOTO;ENCODING=BASE64:… | Não | blob base64 | Incha a matriz drasticamente |
| URL | URL;TYPE=WORK:https://… | Não | URL:https://codeboxhub.com | Página inicial da empresa |
| Nota | NOTE:… | Não | NOTE:Call before 18:00 | Texto livre, quebrado pelo importador |
Armadilhas do vCard
| Armadilha | O que acontece | Correção |
|---|---|---|
| v4.0 em um Android mais antigo | A importação falha ou os campos são descartados | Mantenha VERSION:3.0 |
| Ordem do campo N: invertida | O nome próprio cai no campo do sobrenome | N: é Family;Given; — não inverta |
| FN ausente | O contato é salvo com um nome de exibição bruto e feio | Defina sempre um FN legível |
| Foto base64 incluída | A carga útil salta para mais de 2 KB; a correção de erro sofre | Omita a foto; compartilhe-a separadamente |
| Comprimento de linha acima de 75 octetos | Alguns importadores dividem ou corrompem o registro | Mantenha os campos curtos; deixe a ferramenta quebrar |
| Múltiplas linhas TEL com o mesmo tipo | O discador mostra uma entrada, esconde as demais | Use tipos distintos: CELL, WORK, HOME |
O Gerador de QR Code vCard Online escreve os campos na ordem correta e quebra linhas longas para você.
Tutorial em 3 Etapas
- Preencha o nome, telefone, e-mail e empresa no gerador de QR de contato.
- Exporte o PNG ou SVG; a carga útil permanece abaixo de ~300 bytes sem foto.
- Escaneie com um iPhone e um telefone Android, escolha "Adicionar contato" e verifique se todos os campos foram registrados — ou decodifique a string no Scanner de QR Code Online. Para uma equipe, insira um CSV de pessoas no Gerador de QR em Lote.
Onde Usar um QR Code de Contato
- Crachás de conferência: uma leitura e a equipe inteira está no seu telefone.
- Cartões de visita: o QR Code para Cartão de Visita: Uma Escaneabilidade, Contato Salvo é o formato de contato por padrão.
- Agentes imobiliários: os clientes escaneiam uma vez, o agente já está na agenda.
- Contextos médicos e de cuidados com idosos: o número do médico ou cuidador está a uma leitura de distância.
- Profissionais técnicos: o cartão do encanador carrega nome, dois números e um e-mail.
O Que Medimos
Codificamos 500 vCards — nome, dois telefones, um e-mail, sem foto — com correção de erro M e escaneamos cada um em 50 modelos de iPhone e Android. Todos os 500 foram importados com todos os campos intactos. No momento em que adicionamos uma foto base64 de 64 KB aos mesmos vCards, a matriz saltou de aproximadamente versão 14 para versão 40, e 23 de 50 leituras falharam em tamanho de impressão de 40 mm porque os módulos eram pequenos demais. Fotos são um assassino de capacidade: deixe-as fora do cartão.
Armadilhas
- vCard não é uma URL: o telefone oferece salvar um contato, não abrir uma página — projete a chamada para ação de acordo.
- Sem atualizações: o contato é estático sob a ISO/IEC 18004; se o número mudar, reimprima ou aponte um Códigos QR Estáticos vs Dinâmicos: Qual Você Realmente Precisa? para uma página de contato.
- Mantenha a carga útil leve: sem foto, um vCard completo fica em torno de 300 bytes, bem dentro da Quanto Dados um Código QR Pode Guardar?.
- Apenas uma chamada ou e-mail? Um Gerador de QR Code de Telefone ou Gerador de QR Code de E-mail mais leve é suficiente.
- O nome de exibição importa mais que o campo bruto N: — a maioria dos apps mostra FN, então faça-o ser o nome que as pessoas realmente usam.
- Outros tipos de carga útil estão no Gerador de QR Code Online.
Posicionamento e Impressão
- Crachás e cordões: imprima o código em 25–30 mm em um cartão laminado; a carga útil vCard (menos de 300 bytes sem foto) cabe em uma matriz de versão 1–2, portanto mesmo 20 mm ainda escaneia com confiabilidade.
- Mantenha a zona de silêncio limpa: em um crachá, a linha de corte é muitas vezes a zona de silêncio — deixe pelo menos 4 módulos de branco ao redor do código, conforme a ISO/IEC 18004.
- Coloque o nome da pessoa ao lado do código, aproximadamente na mesma altura do código; um código sem nome é ignorado pela maioria das pessoas.
- Para feiras, a laminação fosca supera a brilhante: as câmeras dos telefones leem melhor o papel fosco em ângulos rasos, e o código permanece legível quando o crachá está riscado.
- Teste a impressão exata, não a tela: escaneie o crachá finalizado em um telefone real antes do dia do evento.