Conversor online gratuito de VCARD para CSV

Muitos sistemas de CRM, ferramentas de mailing, planilhas e bancos de dados exigem contatos como uma tabela, e não como cartões de endereço. Converter um catálogo de endereços .vcf produz linhas editáveis para importação em massa, revisão ou arquivamento, preservando o arquivo de contato original para recuperação.

O que é o formato VCARD

VCARD, geralmente armazenado com a extensão .vcf, é um formato estruturado para cartões de contato. Telefones, clientes de email e aplicativos de catálogo de endereços usam esse formato para armazenar nomes, organizações, cargos, números de telefone, endereços de email, endereços postais, URLs, observações, datas de aniversário, fotos e outras propriedades.

Um arquivo pode conter um cartão exportado de um dispositivo ou muitos cartões de um catálogo de endereços completo. As versões comuns incluem vCard 2.1, 3.0 e 4.0. A versão e o aplicativo de exportação afetam os nomes das propriedades, a codificação de caracteres, a divisão de linhas e os campos compatíveis.

O que é o formato CSV

CSV, ou valores separados por vírgulas, armazena dados tabulares em linhas e colunas. Um CSV de contatos geralmente tem uma linha por pessoa e colunas como Full name, Organization, Phone, Email, Street, City e Postal code.

Excel, Google Sheets, LibreOffice Calc, plataformas de CRM, sistemas de mailing em massa, bancos de dados e scripts geralmente aceitam CSV. Ele é texto simples e fácil de editar ou processar, mas não possui um esquema universal de contatos. Portanto, um CSV pode omitir ou simplificar recursos do vCard, como fotos, categorias, vários endereços tipados, relacionamentos e propriedades personalizadas.

Como converter o arquivo

Usando 101convert.com

1. Abra o conversor de VCF para CSV em 101convert.com.
2. Selecione ou arraste o arquivo .vcf para o conversor. Um arquivo contendo vários cartões deve ser enviado como um único arquivo, para que cada cartão possa se tornar uma linha separada no CSV.
3. Inicie a conversão e baixe o arquivo .csv resultante. A conversão está disponível sem instalar software.
4. Abra o CSV no Excel, LibreOffice Calc ou outra planilha. Se uma caixa de diálogo de importação aparecer, selecione UTF-8 e o delimitador usado pela saída, normalmente uma vírgula. Algumas configurações regionais de planilhas usam ponto e vírgula.
5. Verifique vários registros antes de importá-los para outro sistema, incluindo nomes com acentos, números de telefone, endereços, quebras de linha e registros com vários endereços de email ou números de telefone.

A conversão online exige o envio do arquivo de contato. Portanto, use um método local quando o catálogo de endereços contiver dados confidenciais ou informações organizacionais que devem permanecer no dispositivo.

Usando um script Python local

Para dados privados ou conversão em lote repetível, instale o parser vobject de código aberto:

python -m pip install vobject

Salve isto como vcf_to_csv.py:

import csv
import sys
import vobject

def value(card, name):
    item = getattr(card, name, None)
    return item.value if item else ""

def values(card, name):
    return "; ".join(item.value for item in getattr(card, name + "_list", []))

with open(sys.argv[1], encoding="utf-8-sig") as source, open(
    sys.argv[2], "w", newline="", encoding="utf-8-sig"
) as output:
    fields = ["full_name", "organization", "phone", "email", "street", "city", "region", "postal_code", "country"]
    writer = csv.DictWriter(output, fieldnames=fields)
    writer.writeheader()

    for card in vobject.readComponents(source):
        address = getattr(card, "adr", None)
        adr = address.value if address else None
        writer.writerow({
            "full_name": value(card, "fn"),
            "organization": value(card, "org"),
            "phone": values(card, "tel"),
            "email": values(card, "email"),
            "street": adr.street if adr else "",
            "city": adr.city if adr else "",
            "region": adr.region if adr else "",
            "postal_code": adr.code if adr else "",
            "country": adr.country if adr else ""
        })

Execute o script com os nomes dos arquivos de entrada e saída:

python vcf_to_csv.py contacts.vcf contacts.csv

Este exemplo combina vários números de telefone e endereços de email em uma única célula e exporta o primeiro endereço postal. Amplie a lista de campos e a lógica de extração se o sistema de destino exigir colunas separadas para valores de celular, trabalho e residência.

Limites de qualidade e compatibilidade

As propriedades VCARD podem conter linhas divididas, texto quoted-printable ou UTF-8, vírgulas e ponto e vírgulas escapados, parâmetros como TEL;TYPE=CELL e campos repetidos. Use um conversor baseado em parser; substituir vírgulas ou ponto e vírgulas diretamente pode corromper nomes, endereços, observações e dados de telefone.

O CSV não pode preservar todas as propriedades do vCard. Fotos, categorias, observações com quebras de linha, campos personalizados, vários endereços e rótulos de tipo podem ser descartados ou combinados. Mantenha o arquivo .vcf original até que o CSV tenha sido verificado e importado com sucesso.

Ao abrir o resultado em uma planilha, importe as colunas de números de telefone como texto para que zeros à esquerda, sinais de mais e extensões permaneçam intactos. Verifique os campos que começam com =, +, - ou @ antes de abrir dados não confiáveis em uma planilha, pois alguns aplicativos podem interpretá-los como fórmulas em vez de texto de contato.