Voltar aos guias

Como criar um cartão de visita digital em uma tag NFC: vCard, Smart Poster ou URL

Três formas de colocar seus contatos em uma tag NFC (um registro MIME vCard, um registro de URL ou um Smart Poster) e qual delas combina com seu público, o chip da tag e a frequência de atualização.

Publicado

Um cartão de visita digital em NFC é uma mensagem NDEF gravada em uma tag. Você tem três opções reais de payload: um registro MIME vCard, um registro de URL apontando para uma página de contato hospedada ou um Smart Poster, que envolve a URL com um título. A escolha certa depende de o seu público usar iPhone ou Android, da frequência com que você vai atualizar seus dados e de qual chip NTAG você comprou.

Escolha a codificação: vCard, URL ou Smart Poster

Registro MIME vCard

Um vCard é um arquivo de contato em texto simples definido pela RFC 6350 (versão 4.0) e por suas versões anteriores, 3.0 e 2.1. Em uma tag, ele fica dentro de um registro NDEF com TNF = 0x02 e tipo MIME text/vcard. O sistema abre a tela de contato diretamente quando o leitor entrega o registro: sem site, sem desvio. O porém: o iOS só trata registros MIME de forma confiável quando um app leitor de NFC já está aberto. O NDEF dispatch do Android encaminha text/vcard direto para o app Contatos, que é exatamente o que você quer. Se o seu público é mais Android, o registro vCard é o caminho mais limpo.

Registro de URL

Um registro de URL usa o Well Known URI RTD, que comprime o prefixo (https://, tel:, mailto:) em um único byte e guarda o restante como uma string curta. Aproximou, o navegador abre e sua página mostra um botão "Salvar contato" que baixa um vCard. Registros de URL funcionam em praticamente qualquer celular: todo iPhone XS ou mais novo com iOS 13+ os exibe na leitura de tags em segundo plano no iPhone sem precisar de app aberto, segundo a documentação NFCNDEFTag da Apple. Bônus: você pode atualizar a página de destino depois sem encostar na tag.

Smart Poster

O Smart Poster é a especificação do NFC Forum que reúne um registro URI com registros opcionais de Título e Ação. O celular pode mostrar o título antes de abrir a URL, então a caixa de diálogo diz "Adicionar Jane Doe aos contatos" em vez de um domínio cru.

Orçamento de memória

O overhead do NDEF mais o seu payload precisa caber na memória de usuário do chip. Os chips Type-2 mais comuns oferecem cerca de 144 bytes (NTAG213), 504 bytes (NTAG215) ou 888 bytes (NTAG216). Um vCard enxuto cabe com folga em um NTAG215; uma URL cabe em qualquer um deles. Veja o chip NTAG certo para cada uso para a comparação completa.

Passo a passo: gravando a tag

Você vai precisar de um celular com NFC (iPhone XS ou mais novo com iOS 13+ para gravação, ou qualquer Android moderno), uma NTAG213/215/216 virgem e o NFCore ou qualquer gravador NDEF.

  1. Escreva seu vCard em qualquer editor de texto simples. O payload mínimo útil é BEGIN:VCARD, VERSION:3.0, FN:, N:, TEL;TYPE=cell:, EMAIL:, ORG:, URL:, REV:, END:VCARD. Salve em UTF-8.
  2. Abra o NFCore e comece uma nova tag. Escolha o tipo de registro: vCard, URL ou Smart Poster.
  3. Cole seu vCard (ou sua URL), toque em Gravar e mantenha a tag firme junto à antena NFC do celular até sentir a vibração de sucesso. A posição da antena importa mais do que as pessoas imaginam. Veja o passo a passo completo de como gravar uma tag NFC com o celular.
  4. Confira em um segundo aparelho. A tela de contato deve aparecer para vCards; uma prévia da URL deve aparecer para URL e Smart Poster.

Por baixo dos panos no Android, as chamadas são NdefRecord.createMime("text/vcard", bytes) e NdefRecord.createUri(uri), dentro de uma NdefMessage e gravadas via Ndef.writeNdefMessage(), conforme a documentação básica de NFC do Android. O NFCore cuida disso para você, mas saber o que acontece por baixo do wrapper NDEF que todo leitor entende ajuda quando algo dá errado.

Problemas comuns e soluções

Nada acontece ao aproximar no iPhone: provavelmente você gravou um vCard MIME. A leitura em segundo plano do iOS é confiável para registros de URL e irregular para MIME puro. Abra o NFCore primeiro ou troque para URL ou Smart Poster.

A tela de contato aparece com campos em branco: geralmente é um vCard 4.0 com FN malformado ou sem N. Volte para o vCard 3.0 com o conjunto básico.

A gravação falha ou só funciona uma vez: a tag foi bloqueada, ou é um chip Type-V (ICODE SLIX) em vez de Type-2. Use NTAG213/215/216. Elas já vêm formatadas em NDEF e desbloqueadas.

O cartão ficou sem espaço: tire PHOTO e LOGO, encurte NOTE ou passe para uma NTAG216.

Fazendo isso especificamente no NFCore

O NFCore traz um modelo de Cartão de Visita Digital para cada codificação, então você não precisa montar o texto do vCard na mão. O Tag Inspector mostra o layout exato do registro NDEF depois da gravação (TNF, campo de tipo, tamanho do payload), que é a forma mais rápida de confirmar que text/vcard realmente chegou à tag. Nada sai do seu celular; os dados de contato ficam na tag e no app, não em um servidor.

Perguntas frequentes

Um iPhone consegue ler uma tag NFC com vCard sem app aberto?

Não de forma confiável. iPhone XS e posteriores com iOS 13+ exibem registros de URL em segundo plano, mas um registro MIME vCard puro geralmente exige um app leitor de NFC aberto. Para um toque só no iOS, grave uma URL apontando para uma página de contato hospedada que ofereça o download do vCard.

Qual tag NFC devo comprar para um cartão de visita?

A NTAG215 é a escolha segura: cerca de 504 bytes de memória de usuário, o suficiente para um vCard enxuto. A NTAG213 (~144 bytes) serve para uma URL ou um vCard bem pequeno. A NTAG216 (~888 bytes) é útil se você pretende adicionar uma foto ou um campo NOTE longo.

vCard, URL ou Smart Poster: qual é a diferença ao aproximar?

O vCard abre a tela de contato diretamente nos aparelhos que tratam text/vcard. A URL abre uma página web e é a opção mais universal entre iOS e Android. O Smart Poster envolve uma URL com um título para que a caixa de diálogo mostre um rótulo antes de abrir. Escolha URL ou Smart Poster se o toque em segundo plano no iOS importa; escolha vCard se o seu público é majoritariamente Android.

Posso atualizar uma tag de cartão de visita NFC depois de gravada?

Sim, desde que você não a bloqueie. Tags NDEF continuam regraváveis até você definir os lock bytes. Se seus dados mudam com frequência, deixe a tag desbloqueada ou grave uma URL que aponte para uma página que você possa editar.

O vCard precisa ser da versão 4.0?

O vCard 3.0 é lido de forma mais confiável em apps de contatos Android mais antigos; o 4.0 é o padrão atual (RFC 6350). Para um público misto, um vCard 3.0 com FN, N, TEL, EMAIL, ORG e URL é o payload mais seguro.