Conversor online gratuito de XLSX para VCF

Agendas telefônicas, clientes de email e sistemas de gerenciamento de contatos normalmente importam contatos como arquivos VCF. Converter uma lista de contatos XLSX evita redigitar manualmente nomes, números de telefone, endereços de email e detalhes da organização.

O que é o formato XLSX

XLSX é o formato de pasta de trabalho Open XML baseado em ZIP do Microsoft Excel, compatível com Excel, LibreOffice Calc, Apple Numbers e muitos sistemas empresariais. Uma pasta de trabalho pode conter várias planilhas, valores de células, fórmulas, formatação, tabelas e dados de contatos organizados em linhas e colunas.

XLSX não define um esquema padrão de contatos. Portanto, a conversão deve mapear cabeçalhos como First Name, Last Name, Phone e Email para propriedades VCF correspondentes. Normalmente, uma pasta de trabalho deve usar um contato por linha, com uma linha de cabeçalho no topo.

O que é o formato VCF

VCF, também chamado de vCard, é um formato baseado em texto para trocar registros de contatos. Um arquivo pode conter um ou vários contatos, com propriedades como FN para o nome de exibição, N para o nome estruturado, TEL para números de telefone, EMAIL, ORG, TITLE e ADR para um endereço.

Aplicativos de contatos do Android e iOS, Microsoft Outlook, Apple Contacts, Thunderbird, sistemas de webmail e agendas de endereços empresariais normalmente oferecem suporte à importação de VCF. Diferentemente de um arquivo CSV genérico, o VCF identifica diretamente os campos de contato, mas os aplicativos diferem quanto aos campos, rótulos, codificações de caracteres e versões VCF aceitos.

Converter XLSX para VCF online

Você pode converter o arquivo gratuitamente em 101convert.com, sem instalar software. Envie a pasta de trabalho XLSX, inicie a conversão e baixe o arquivo VCF gerado. Se a pasta de trabalho contiver várias planilhas ou cabeçalhos incomuns, verifique qual planilha e quais colunas o conversor usa antes de importar o resultado.

A conversão online exige o envio da planilha. Use um método local para listas confidenciais de contatos de clientes, funcionários ou pessoais quando os dados precisarem permanecer no seu computador.

Converter XLSX para VCF localmente com Python

Python oferece um método local repetível usando openpyxl para ler XLSX e vobject para criar dados vCard 3.0. Instale os dois pacotes:

python -m pip install openpyxl vobject

Coloque os contatos na planilha ativa e use cabeçalhos como First Name, Last Name, Phone, Mobile, Work Phone, Email, Organization, Title, Street, City, State, Postal Code e Country. Salve isto como xlsx_to_vcf.py na mesma pasta que contacts.xlsx:

from openpyxl import load_workbook
import vobject

workbook = load_workbook("contacts.xlsx", data_only=True, read_only=True)
worksheet = workbook.active
rows = worksheet.iter_rows(values_only=True)
headers = [str(value or "").strip().lower() for value in next(rows)]

with open("contacts.vcf", "w", encoding="utf-8", newline="") as output:
    for values in rows:
        row = dict(zip(headers, values))

        def get(*names):
            for name in names:
                value = row.get(name.lower())
                if value not in (None, ""):
                    return str(value).strip()
            return ""

        first = get("first name", "given name")
        last = get("last name", "surname", "family name")
        display = get("full name", "name") or " ".join(
            part for part in (first, last) if part
        )
        if not display:
            continue

        card = vobject.vCard()
        card.add("fn").value = display
        card.add("n").value = vobject.vcard.Name(family=last, given=first)

        for column, label in (("phone", "VOICE"), ("mobile", "CELL"), ("work phone", "WORK")):
            number = get(column)
            if number:
                telephone = card.add("tel")
                telephone.value = number
                telephone.type_param = label

        email = get("email", "email address")
        if email:
            card.add("email").value = email

        organization = get("organization", "company")
        if organization:
            card.add("org").value = [organization]

        title = get("title", "job title")
        if title:
            card.add("title").value = title

        address = vobject.vcard.Address(
            street=get("street", "address"),
            city=get("city"),
            region=get("state", "province", "region"),
            code=get("postal code", "zip", "zip code"),
            country=get("country")
        )
        if any(address.value):
            card.add("adr").value = address

        output.write(card.serialize())

Execute o script a partir dessa pasta:

python xlsx_to_vcf.py

O script lê a primeira planilha ativa e grava todos os registros convertidos em contacts.vcf. Adicione outros nomes de cabeçalho às chamadas de get() quando a planilha usar rótulos diferentes; adicione outro mapeamento de telefone quando o arquivo tiver campos como Home Phone ou Phone 2.

Importe o resultado usando o comando de contatos do aplicativo de destino, como Contacts → Settings → Import ou File → Import. O menu exato e a aceitação de um VCF com vários contatos dependem do software.

Limites de qualidade e compatibilidade

• O mapeamento de colunas controla o resultado. Renomeie cabeçalhos ambíguos antes da conversão. Um cabeçalho como Phone 2 não será reconhecido pelo script de exemplo até ser adicionado ao mapeamento.
• Mantenha um contato por linha. Vários números de telefone ou endereços de email em uma célula podem ser importados como um único valor não estruturado, a menos que as regras de conversão os dividam.
• O exemplo em Python usa data_only=True, portanto as células com fórmulas exigem resultados armazenados em cache pelo Excel ou LibreOffice. Recalcule e salve a pasta de trabalho antes de executar o script.
• A formatação XLSX, as cores, as larguras das colunas, os filtros, as fórmulas e a estrutura das planilhas não têm equivalente em VCF e são descartados.
• Revise nomes, registros duplicados, códigos de país, extensões, linhas em branco e rótulos de telefone após a importação. Os números da planilha também podem ser alterados pela formatação numérica automática; armazene os números de telefone como texto quando for necessário preservar zeros à esquerda ou sinais de mais.
• VCF 3.0 é amplamente aceito, enquanto alguns aplicativos mais recentes também oferecem suporte ao VCF 4.0 e dispositivos mais antigos podem exigir VCF 2.1. Se um importador rejeitar o resultado, exporte na versão especificada por ele ou divida um arquivo grande em lotes menores.
• UTF-8 geralmente preserva caracteres acentuados, mas telefones e programas de contatos mais antigos podem processar incorretamente texto não ASCII, notas longas, vários rótulos de telefone ou campos de endereço menos comuns.