Formato do QR Code vCard: campos, versões e um exemplo que funciona
O que um QR Code vCard guarda de fato: o formato de texto linha por linha, os campos que os celulares entendem, vCard 3.0 vs 4.0 vs MECARD e por que um contato longo gera um código difícil de escanear.
Este guia mostra o formato linha por linha, qual versão usar, quantos dados cabem e quando é melhor deixar um gerador de QR Code vCard guardar um link curto em vez do contato completo.
Como é o formato vCard dentro de um QR Code
Veja um contato completo e válido. Cada linha é uma propriedade: o nome do campo, dois-pontos e um valor.
BEGIN:VCARD
VERSION:3.0
N:Rivera;Alex;;;
FN:Alex Rivera
ORG:Example Studio
TITLE:Account Manager
TEL;TYPE=CELL:+12025550123
EMAIL:[email protected]
URL:https://example.com
ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA
END:VCARDTrês regras sustentam o formato:
- O cartão começa com BEGIN:VCARD e termina com END:VCARD, e a linha VERSION vem logo depois da primeira.
- Cada propriedade fica em uma linha própria. O ponto e vírgula separa as partes de um valor estruturado, como os pedaços de um nome ou de um endereço.
- Uma vírgula, um ponto e vírgula ou uma barra invertida que faz parte do próprio texto recebe uma barra invertida antes, então “Smith, Jones and Co” é escrito como “Smith\, Jones and Co”.
Os campos vCard que os celulares entendem
Um contato pode ter dezenas de propriedades, mas estas são as que os apps de contatos dos celulares leem de forma consistente:
| Campo | O que guarda | Exemplo |
|---|---|---|
| FN | O nome completo, do jeito que deve aparecer. Obrigatório. | FN:Alex Rivera |
| N | O nome em partes: sobrenome, nome, nomes do meio, prefixo e sufixo. Obrigatório na versão 3.0. | N:Rivera;Alex;;; |
| ORG | Empresa ou organização | ORG:Example Studio |
| TITLE | Cargo | TITLE:Account Manager |
| TEL | Número de telefone. TYPE o marca como CELL (celular), WORK (trabalho) ou HOME (residencial). | TEL;TYPE=CELL:+12025550123 |
| Endereço de e-mail | EMAIL:[email protected] | |
| URL | Site | URL:https://example.com |
| ADR | Endereço postal em sete partes: caixa postal, complemento, rua, cidade, estado ou região, CEP e país. | ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA |
| NOTE | Uma observação em texto livre | NOTE:Nos conhecemos na feira |
Escreva os números de telefone no formato internacional, com o código do país, como +1 para os Estados Unidos, para que o contato salvo funcione ao ligar de qualquer lugar.
O formato também tem um campo PHOTO, mas uma foto não é viável dentro de um QR Code. Uma imagem incorporada chega a dezenas de milhares de caracteres, e um QR Code guarda no máximo 2.953 bytes de dados. Deixe a foto de fora de um código estático ou use um cartão de contato hospedado, que mostra a foto na página.
vCard 2.1, 3.0 ou 4.0: qual versão usar
Há três versões do formato em circulação:
- vCard 2.1 (1996) é a mais antiga. A maioria dos celulares ainda a lê, mas ela exige marcação extra para caracteres acentuados e não latinos.
- vCard 3.0 (1998) é a versão que a maioria dos geradores de QR Code grava e a escolha mais segura para um QR Code. As câmeras do iPhone e dos celulares Android a leem de forma confiável.
- vCard 4.0 (2011) é o padrão atual, definido na RFC 6350. Usa sempre UTF-8 e tem uma sintaxe mais limpa, mas os apps de câmera a suportam de forma menos consistente, e há relatos de celulares que descartam campos ou exibem caracteres especiais de forma errada.
Use a 3.0, a menos que tenha um motivo específico para não usar, e salve o texto em UTF-8 para que nomes com acentos ou em alfabetos não latinos cheguem intactos depois do escaneamento.
MECARD: a alternativa compacta
MECARD é um formato de contato mais curto que a NTT DOCOMO criou para QR Codes em celulares japoneses. Ele coloca o contato inteiro em uma única linha:
MECARD:N:Rivera,Alex;TEL:+12025550123;EMAIL:[email protected];;Como usa menos caracteres, o QR Code fica menos denso e é mais fácil de escanear em tamanhos pequenos. A contrapartida é ter menos campos: o MECARD não tem lugar para o nome da empresa nem para o cargo, e o suporte varia mais entre os apps de leitura do que no caso do vCard. Escolha esse formato só quando o código precisar ser muito pequeno e um nome, um número e um e-mail forem suficientes.
Quantos dados de contato cabem, e por que menos é melhor
Um QR Code comporta até 2.953 bytes, mas esse é o teto da versão maior e mais densa, não uma meta. Cada caractere a mais aumenta o desenho: mais módulos, cada um menor no mesmo tamanho de impressão.
O contato de exemplo acima tem 247 caracteres. Com correção de erros média, ele precisa de um desenho de 61 módulos de largura; impresso com 2,5 cm de largura em um cartão de visita, cada módulo fica com cerca de 0,4 mm. Um link curto de 22 caracteres precisa de apenas 25 módulos, o que deixa cada módulo com 1 mm no mesmo tamanho. São os módulos maiores que permitem escanear um código rapidamente com pouca luz, em papel texturizado ou com um celular mais antigo.
Para manter legível um código vCard estático:
- Inclua só o que alguém precisa para falar com você: um nome, um número de telefone, um e-mail e um site.
- Deixe de fora a foto, observações longas e o endereço postal completo, a menos que sejam importantes.
- Imprima o código maior do que imprimiria um código para um link. O guia de tamanhos de QR Code para impressão traz os tamanhos mínimos.
Código vCard estático vs cartão de contato dinâmico
Há duas formas de colocar um contato por trás de um QR Code.
Um código vCard estático grava o texto vCard no próprio desenho. Funciona sem internet e sem nenhum serviço por trás, e nunca expira. Em compensação, não pode ser alterado: um número de telefone novo significa um código novo e uma nova impressão.
Um código vCard dinâmico guarda um link curto. O escaneamento abre uma página de cartão de contato com um botão Salvar contato, e esse botão baixa o arquivo .vcf. Como os dados ficam em um servidor, você pode editá-los depois de imprimir, o desenho continua pequeno e a página pode mostrar uma foto e links extras.
| Pergunta | Código vCard estático | Código vCard dinâmico |
|---|---|---|
| O que o desenho guarda | O texto vCard completo | Um link curto |
| Funciona sem internet | Sim | Não, o escaneamento precisa de conexão |
| Pode ser editado depois de impresso | Não | Sim |
| Densidade do desenho | Aumenta a cada campo | Continua a mesma |
| Foto | Não é viável | Aparece no cartão de contato |
| Depende de um provedor | Não | Sim |
Para um cartão que você vai distribuir durante anos, ou qualquer material impresso em grande quantidade, o dinâmico é a escolha mais segura. QR Code dinâmico vs estático explica a comparação mais ampla, e o guia de QR Code no cartão de visita trata do tamanho e da posição no próprio cartão.
Como fazer um QR Code vCard
Você não precisa digitar o formato à mão. Um gerador de QR Code vCard monta tudo a partir de um formulário:
- Abra o gerador de QR Code vCard do QR Cake.
- Preencha nome, empresa, cargo, telefone, e-mail e site. Adicione uma foto e seus perfis nas redes sociais, se quiser que apareçam no cartão.
- Personalize o código com suas cores, um logo ou uma moldura com um texto como “Escaneie para salvar meu contato”.
- Entre com uma conta gratuita e salve o código; depois baixe em PNG ou SVG.
- Escaneie com um iPhone e com um celular Android, toque em Salvar contato em cada um e confira o contato salvo antes de imprimir.
Um código vCard salvo no QR Cake é dinâmico. O desenho guarda um link curto, o escaneamento abre o seu cartão de contato hospedado e o botão Salvar contato baixa um arquivo vCard 3.0 padrão. O plano gratuito inclui até 5 códigos dinâmicos com escaneamentos ilimitados, e os códigos salvos não expiram. No plano gratuito, uma breve página de anúncio aparece antes de o cartão abrir, e os planos pagos a removem.
Como ver o que um QR Code vCard contém
Para saber o que um código existente guarda, escaneie e veja o que o celular oferece. Uma prévia do contato com a opção de adicioná-lo à agenda significa que o texto vCard está no desenho, ou seja, o código é estático. Um endereço da web significa que o código é dinâmico. Você também pode enviar uma foto ou uma captura de tela do código para o leitor de QR Code, que mostra o conteúdo decodificado.
Erros comuns em QR Codes vCard
- Falta a linha VERSION ou END:VCARD. Nesse caso, o celular pode mostrar o código como texto simples em vez de um contato.
- Vírgulas e pontos e vírgulas sem escape. Um nome de empresa como “Smith, Jones” se divide em dois valores, a menos que a vírgula tenha uma barra invertida antes.
- Dados demais. Vários telefones, uma observação longa e um endereço completo transformam o código de um cartão de visita em um quadrado denso que câmeras mais antigas não conseguem resolver.
- Uma foto incorporada. Ela não cabe. Use um cartão de contato hospedado se a foto for importante.
- Números de telefone locais. Um número sem código do país falha para quem liga do exterior.
- Nenhum teste nas duas plataformas. Os apps de contatos do iPhone e do Android organizam os mesmos campos de formas diferentes, então confira o contato salvo em cada um.
Em resumo
Um QR Code vCard é um contato em formato de texto simples: BEGIN:VCARD, uma linha VERSION, um campo por linha e END:VCARD. Use a versão 3.0, limite os campos ao essencial e salve o texto em UTF-8. Se os dados puderem mudar ou o código precisar ser pequeno, use um código vCard dinâmico, que guarda um link curto e entrega o contato a partir de uma página que você pode editar.
Gerador de QR Code vCard
Crie um QR code vCard, também chamado de QR code de cartão de contato. Um escaneamento mostra sua foto, telefone, e-mail e endereço com um botão “Salvar contato”. Grátis e dinâmico.
Sobre a equipe do QR Cake
Escrito pela equipe do QR Cake: quem está construindo o QR Cake, uma plataforma de QR codes dinâmicos usada para campanhas impressas editáveis, QR codes no Canva, análise de leituras e redirecionamentos de longa duração que continuam funcionando depois que a assinatura termina.
Saiba mais sobre o QR CakePerguntas frequentes
- Qual formato um QR Code vCard usa?
- Usa o formato vCard, o mesmo texto simples de um arquivo .vcf. Os dados começam com BEGIN:VCARD, seguem com uma linha VERSION e uma propriedade por linha, como FN para o nome, TEL para o telefone e EMAIL para o endereço de e-mail, e terminam com END:VCARD.
- Qual versão do vCard usar em um QR Code?
- Use o vCard 3.0. É a versão que a maioria dos geradores de QR Code grava e a que as câmeras do iPhone e dos celulares Android leem de forma mais consistente. O vCard 4.0 é o padrão mais novo, mas o suporte nos apps de câmera é mais irregular.
- Qual é a diferença entre vCard e MECARD?
- MECARD é um formato de contato compacto criado pela NTT DOCOMO que coloca o contato inteiro em uma única linha. Ele usa menos caracteres, então o QR Code fica menos denso, mas tem menos campos, sem lugar para o nome da empresa nem para o cargo, e o suporte varia mais entre os apps de leitura.
- Quantas informações cabem em um QR Code vCard?
- Um QR Code comporta até 2.953 bytes, mas um código tão cheio fica denso demais para escanear com confiabilidade no tamanho de um cartão de visita. Limite um código vCard estático a algumas centenas de caracteres: um nome, um telefone, um e-mail e um site.
- Um QR Code vCard pode ter foto?
- Não em um código estático. Uma foto incorporada é muito maior do que um QR Code consegue guardar. Um código vCard dinâmico pode mostrar uma foto, porque o escaneamento abre uma página de cartão de contato hospedada em vez de ler o contato direto do desenho.
- Dá para editar um QR Code vCard depois de impresso?
- Só se ele for dinâmico. Um código vCard estático tem os dados do contato gravados no desenho, então qualquer mudança exige um código novo. Um código vCard dinâmico guarda um link curto, e você pode editar os dados por trás dele a qualquer momento.
- Um QR Code vCard funciona sem internet?
- Um código vCard estático funciona, porque o celular lê o contato direto do desenho. Um código vCard dinâmico precisa de conexão, porque o escaneamento abre uma página da web que guarda o contato.
Artigos relacionados
Continue lendo guias práticos, exemplos e dicas para melhorar o desempenho dos seus QR codes.
QR Code no cartão de visita: tamanho, posição e para onde apontar (2026)
Um QR Code no cartão de visita é o uso de maior retorno do QR Code em material impresso. O cartão dura o que o design durar, e o destino acompanha a sua carreira.
QR Code dinâmico vs estático: qual você deve usar de verdade? (Guia 2026)
Os códigos estáticos resolvem bem umas três situações específicas. Para todo o resto, os dinâmicos economizam dinheiro, tempo e o constrangimento de reimprimir folhetos porque alguém mudou a URL da página de destino.
Tamanho de QR Code para impressão: o guia definitivo de 2026
Os QR Codes falham por tamanho pequeno mais do que por qualquer outro motivo. A solução é simples: imprima grande o suficiente. Este guia traz as regras, os números e o tamanho mínimo por caso de uso.