CodeBox Hub
GRÁTIS

QR Code para Contato: Campos vCard e Armadilhas de Formato

Codifique um contato no formato vCard 3.0: tabela de campos, armadilhas de FN/TEL/N e um tutorial em 3 etapas.

# 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

CampoSintaxe v3.0ObrigatórioExemploObservações
VersãoVERSION:3.0SimVERSION:3.0Primeira linha após BEGIN
NomeN:Family;Given;;;SimN:Chen;Wei;;;Sobrenome primeiro, depois nome
Nome de exibiçãoFN:Wei ChenNãoFN:Wei ChenO que o app de contatos exibe
TelefoneTEL;TYPE=CELL:+86…NãoTEL;TYPE=CELL:+8613800001234Uma linha por número
E-mailEMAIL:hi@x.comNãoEMAIL:hi@codeboxhub.comMúltiplas linhas permitidas
OrganizaçãoORG:CompanyNãoORG:CodeBoxParâmetro de tipo opcional
CargoTITLE:EngineerNãoTITLE:Staff EngineerCargo, não a empresa
EndereçoADR;TYPE=WORK:…NãoADR;TYPE=WORK:;;1 Main St;City;ST;100000;CNOrdem fixa de campos
FotoPHOTO;ENCODING=BASE64:…Nãoblob base64Incha a matriz drasticamente
URLURL;TYPE=WORK:https://…NãoURL:https://codeboxhub.comPágina inicial da empresa
NotaNOTE:…NãoNOTE:Call before 18:00Texto livre, quebrado pelo importador

Armadilhas do vCard

ArmadilhaO que aconteceCorreção
v4.0 em um Android mais antigoA importação falha ou os campos são descartadosMantenha VERSION:3.0
Ordem do campo N: invertidaO nome próprio cai no campo do sobrenomeN: é Family;Given; — não inverta
FN ausenteO contato é salvo com um nome de exibição bruto e feioDefina sempre um FN legível
Foto base64 incluídaA carga útil salta para mais de 2 KB; a correção de erro sofreOmita a foto; compartilhe-a separadamente
Comprimento de linha acima de 75 octetosAlguns importadores dividem ou corrompem o registroMantenha os campos curtos; deixe a ferramenta quebrar
Múltiplas linhas TEL com o mesmo tipoO discador mostra uma entrada, esconde as demaisUse 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

  1. Preencha o nome, telefone, e-mail e empresa no gerador de QR de contato.
  2. Exporte o PNG ou SVG; a carga útil permanece abaixo de ~300 bytes sem foto.
  3. 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

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.

FAQ

O que um QR code para contato faz?

Ele abre um prompt de "Adicionar contato" com um vCard completo — nome, números, e-mail, empresa — pronto para salvar.

Devo usar vCard 3.0 ou 4.0?

3.0 (RFC 2426). Ele importa limpo em todos os principais telefones; a v4.0 quebra em alguns discadores Android mais antigos.

Um QR code de contato pode incluir uma foto?

Tecnicamente sim, via um campo PHOTO base64, mas ele incha a matriz tanto que impressões pequenas falham; omita-o.

Como adiciono dois números de telefone a um vCard?

Escreva duas linhas TEL com tipos diferentes, por exemplo `TEL;TYPE=CELL` e `TEL;TYPE=WORK`.

QR codes de contato funcionam no Android?

Sim. O Android trata o vCard como uma importação de contato e mostra o fluxo padrão de adicionar contato.

Qual é a diferença entre os campos N: e FN:?

N: é o nome estruturado de família/próprio usado para ordenação; FN: é o nome de exibição que o app de contatos mostra.

Um QR code de contato é o mesmo que um QR code de cartão de visita?

Normalmente sim — a carga útil padrão de um cartão de visita é um vCard; a diferença é apenas o que você imprime ao redor.

Continue lendo

Fale conosco