Converter VCF para CSV

Ninguém converte contatos para ler. O arquivo existe porque algo precisa se mover: a agenda de um celular para um CRM, os contatos de um colega que saiu para uma conta compartilhada, uma lista de e-mail do Outlook para uma ferramenta de newsletter, quinhentos cartões coletados numa feira para o que o time de vendas usa.

Isso torna as expectativas do destino a coisa que importa, e destinos têm opinião forte. Uma tela de importação de CRM quer uma coluna chamada algo como "Celular" e outra "E-mail Corporativo", mapeadas uma a uma. Um vCard não tem esse conceito: tem uma lista de propriedades de telefone com etiquetas de tipo, em qualquer quantidade e ordem.

Todo contato vira uma linha de nome, primeiro nome, sobrenome, organização, cargo, e-mails, telefones, endereços e observação. As três colunas plurais guardam tudo daquele tipo para o contato, separadas por ponto e vírgula, com o tipo na frente onde o cartão informou: "celular: +55 11 91234-5678; comercial: +55 11 3456-7890".

A alternativa seria colunas numeradas, pior nos dois sentidos. Escolha cinco e o contato com seis números perde um em silêncio. Escolha o máximo encontrado no arquivo e todo mundo ganha uma linha com uma dúzia de colunas vazias cujo significado muda de contato para contato. Coletar mantém a tabela honesta sobre o que um vCard realmente é.

Duas rotas, dependendo de quão uniforme é a exportação. Se quase todo contato tem a mesma forma — um celular, um número comercial — Texto para Colunas no ponto e vírgula do Excel ou Google Sheets faz num passo só, e depois você apaga os prefixos de tipo com localizar e substituir.

Se a forma varia, o Power Query é a ferramenta: Dividir Coluna por Delimitador em linhas dá uma linha por número, que você pode dinamizar pelo prefixo de tipo em colunas nomeadas corretamente. São dez minutos e sobrevive à próxima exportação, o que importa porque isso raramente é trabalho único.

Um endereço vCard é um valor estruturado com sete componentes em ordem fixa: caixa postal, endereço estendido, rua, cidade, estado, CEP e país. A maioria dos cartões deixa vários vazios, então um endereço brasileiro comum é escrito com dois ponto e vírgula à frente e caixa e extensão vazias.

Esses componentes vazios são descartados e o que resta é unido com vírgulas, dando um legível "Rua das Flores 120, São Paulo, 01310-100, Brasil" e destruindo a estrutura. Nada na célula resultante diz que "01310-100" era o CEP em vez de outra coisa. Para um mala direta isso é perfeito; para um CRM que quer campos separados, a coluna precisa ser revisada à mão.

Um vCard carrega o nome duas vezes: uma como string formatada para exibição, que vira a coluna "nome", e uma como valor estruturado na ordem sobrenome, primeiro nome, nome do meio, prefixo, sufixo. Esse valor estruturado preenche "sobrenome" e "primeiro nome", nessa ordem.

As duas são mantidas porque discordam mais do que se esperaria. Cartões criados escaneando um cartão de visita frequentemente têm um nome formatado e um estruturado vazio. Ordenar por "sobrenome" é certo quando está preenchido; recorrer a "nome" quando não está é a regra mais segura, e ter as duas colunas à sua frente é o que torna essa decisão possível.

Um vCard moderno pode carregar uma fotografia, um aniversário, vários sites, contatos de mensageiro instantâneo, uma posição geográfica, um fuso horário, categorias e qualquer número de extensões específicas de fornecedor com prefixo X-. Nenhum aparece na saída.

A fotografia merece menção à parte, porque normalmente é o grosso do arquivo — uma imagem codificada em base64 em cada cartão é por isso que uma exportação de quinhentos contatos tem vários megabytes em vez de cem kilobytes. Nada numa tabela conseguiria guardar isso.

Tanto este formato quanto seu irmão de calendário quebram valores longos a cada setenta e cinco octetos e marcam a continuação com um espaço ou tabulação no início. Isso é rejuntado antes de qualquer interpretação, o que evita que observações e endereços longos sejam truncados silenciosamente.

O que não é tratado é quoted-printable, a codificação que o vCard 2.1 usava para qualquer coisa fora do ASCII simples. Exportações de celulares mais antigos escrevem "João" como "Jo=C3=A3o". Esses valores atravessam como estão escritos. Reexporte como vCard 3.0 ou 4.0 se a origem permitir.

A conversão é JavaScript comum nesta aba do navegador. Nenhum motor é baixado, nada é enviado, não há cadastro nem limite diário, e o painel de rede durante uma conversão é como confirmar isso em vez desta frase.

Para esse tipo de arquivo, isso não é um detalhe. Uma agenda é dado pessoal de outras pessoas — nomes, números privados, endereços residenciais — sob sua guarda e pertencendo a elas, e enviar isso para um conversor é uma transferência a terceiro que a LGPD trataria como tratamento de dados. Aqui não há nada a registrar.