Formato do QR Code vCard: campos, versões e um exemplo que funciona

    QR Cake TeamPublicado:

    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.

    Um QR Code vCard é um QR Code cujos dados são um contato escrito no formato vCard: texto simples que começa com BEGIN:VCARD, traz um dado por linha e termina com END:VCARD. Quando a câmera do celular lê esse texto, reconhece um contato e oferece a opção de adicioná-lo à agenda. Um arquivo .vcf contém exatamente o mesmo formato.

    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:VCARD


    Trê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:

    CampoO que guardaExemplo
    FNO nome completo, do jeito que deve aparecer. Obrigatório.FN:Alex Rivera
    NO nome em partes: sobrenome, nome, nomes do meio, prefixo e sufixo. Obrigatório na versão 3.0.N:Rivera;Alex;;;
    ORGEmpresa ou organizaçãoORG:Example Studio
    TITLECargoTITLE:Account Manager
    TELNúmero de telefone. TYPE o marca como CELL (celular), WORK (trabalho) ou HOME (residencial).TEL;TYPE=CELL:+12025550123
    EMAILEndereço de e-mailEMAIL:[email protected]
    URLSiteURL:https://example.com
    ADREndereç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
    NOTEUma observação em texto livreNOTE: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.

    PerguntaCódigo vCard estáticoCódigo vCard dinâmico
    O que o desenho guardaO texto vCard completoUm link curto
    Funciona sem internetSimNão, o escaneamento precisa de conexão
    Pode ser editado depois de impressoNãoSim
    Densidade do desenhoAumenta a cada campoContinua a mesma
    FotoNão é viávelAparece no cartão de contato
    Depende de um provedorNãoSim


    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:

    1. Abra o gerador de QR Code vCard do QR Cake.
    2. 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.
    3. Personalize o código com suas cores, um logo ou uma moldura com um texto como “Escaneie para salvar meu contato”.
    4. Entre com uma conta gratuita e salve o código; depois baixe em PNG ou SVG.
    5. 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.

    QR Cake Team

    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 Cake

    Perguntas 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.
    Formato do QR Code vCard: campos, versões e um exemplo