Converter TXT para VCARD

Telefones e aplicações de agenda de endereços normalmente importam contatos de arquivos .vcf, não de listas de texto simples. Converter uma lista de contatos TXT estruturada produz um arquivo que pode ser transferido entre dispositivos, compartilhado ou importado para softwares de email e contatos.

O que é o formato TXT

.txt é um formato de texto simples não estruturado usado pelo Notepad, TextEdit, ferramentas de terminal, aplicações antigas e listas de contatos mantidas manualmente. Ele não possui campos de contato nem delimitador padrão.

Uma lista de contatos pode conter um contato por linha, colunas separadas por vírgulas ou tabulações, ou rótulos como Name:, Phone: e Email:. Inspecione o conteúdo antes da conversão; apenas a extensão não permite identificar qual valor é um sobrenome, número de telefone, código postal ou observação.

O que é o formato vCard

vCard é um padrão estruturado de contatos normalmente salvo com a extensão .vcf. Ele pode armazenar nome formatado, nome e sobrenome estruturados, números de telefone, endereços de email, organização, endereço postal, site, observações e, dependendo da versão e da aplicação, uma foto do contato.

Um único arquivo VCF pode conter um contato ou vários contatos. vCard 3.0 é geralmente mais compatível com telefones antigos e agendas de endereços para desktop; vCard 4.0 tem recursos mais recentes, mas não é compatível com todos os importadores. Android, iOS, Outlook, Thunderbird, Apple Contacts e Google Contacts são compatíveis com vCard, embora o mapeamento de campos varie entre as aplicações.

Converter TXT com LibreOffice e Thunderbird

1. Abra o arquivo TXT no LibreOffice Calc. Na caixa de diálogo de importação, selecione Separated by e escolha o delimitador real, como Tab, vírgula ou ponto e vírgula. Verifique se cada campo aparece na coluna correta.
2. Limpe a tabela e use uma linha de cabeçalho com nomes inequívocos, como First Name, Last Name, Mobile Number, Email e Organization. Salve-a como contacts.csv por meio de File → Save As.
3. Abra a agenda de endereços do Thunderbird e escolha Tools → Import. Selecione a opção de importação de CSV ou agenda de endereços de texto e, em seguida, mapeie cada coluna de origem para o campo apropriado do Thunderbird.
4. Inspecione vários registros importados para verificar nomes invertidos, zeros à esquerda perdidos, tipos de telefone incorretos, caracteres acentuados corrompidos e endereços de email malformados.
5. Selecione os contatos verificados e escolha Tools → Export. Salve o resultado como contacts.vcf; selecione vCard 3.0 se o Thunderbird oferecer uma escolha de versão.

Os nomes dos menus podem variar ligeiramente entre versões do Thunderbird. Se o assistente de importação não reconhecer o arquivo como CSV, salve-o primeiro no Calc como CSV separado por vírgulas com codificação UTF-8.

Usar um script Python local para dados separados por tabulação

Um script é adequado quando o arquivo TXT tem uma linha de cabeçalho chamada name, phone, email e, opcionalmente, organization, com um contato por linha separada por tabulação. Salve-o como txt_to_vcard.py:

import csv
import sys


def escape(value):
    value = str(value or '').replace('\\r\\n', '\\n').replace('\\r', '\\n')
    return value.replace('\\', '\\\\').replace(';', '\\;').replace(',', '\\,').replace('\\n', '\\n')


def fold(line):
    parts = []
    current = ''
    limit = 75
    for character in line:
        if len((current + character).encode('utf-8')) > limit:
            parts.append(current)
            current = ' ' + character
            limit = 74
        else:
            current += character
    parts.append(current)
    return '\\r\\n'.join(parts)


with open(sys.argv[1], encoding='utf-8-sig', newline='') as source, open('contacts.vcf', 'w', encoding='utf-8', newline='') as output:
    contacts = csv.DictReader(source, delimiter='\\t')
    for contact in contacts:
        full_name = (contact.get('name') or '').strip()
        name_parts = full_name.split()
        family = name_parts[-1] if name_parts else ''
        given = ' '.join(name_parts[:-1])
        lines = [
            'BEGIN:VCARD',
            'VERSION:3.0',
            'FN:' + escape(full_name),
            'N:' + escape(family) + ';' + escape(given) + ';;;'
        ]
        phone = escape(contact.get('phone', ''))
        email = escape(contact.get('email', ''))
        organization = escape(contact.get('organization', ''))
        if phone:
            lines.append('TEL;TYPE=CELL:' + phone)
        if email:
            lines.append('EMAIL:' + email)
        if organization:
            lines.append('ORG:' + organization)
        lines.extend(['END:VCARD'])
        output.write('\\r\\n'.join(fold(line) for line in lines) + '\\r\\n')

Execute-o com python txt_to_vcard.py contacts.txt. O script cria contacts.vcf no diretório atual. O analisador de nomes considera a última palavra separada por espaços como o sobrenome; portanto, edite essa lógica para sobrenomes compostos, títulos, sufixos ou colunas separadas para nome e sobrenome.

Usar um conversor online para dados não confidenciais

Serviços online como CloudConvert ou Online-Convert podem oferecer conversão de CSV para VCF, mas o suporte direto a TXT e o mapeamento de campos variam. Se o serviço não aceitar corretamente o delimitador do TXT, abra o arquivo no LibreOffice Calc, salve-o como CSV UTF-8 e converta esse CSV para VCF. Envie apenas uma pequena amostra sanitizada ou contatos não privados; uma lista de contatos contém dados pessoais e pode ser retida pelo serviço. Um fluxo de trabalho local com Thunderbird ou um script evita essa divulgação.

Verificações de qualidade e compatibilidade

TXT não possui um esquema universal de contatos, portanto a conversão automática não consegue inferir de forma confiável o significado dos campos. Normalize os números de telefone, preserve os códigos de país e verifique os valores que contêm vírgulas, tabulações, pontos e vírgulas, quebras de linha ou zeros à esquerda antes de exportar.

Use UTF-8 para preservar nomes acentuados. Os valores de texto do vCard exigem escape para barras invertidas, vírgulas, pontos e vírgulas e quebras de linha; as linhas geradas também devem ser dobradas quando excederem o limite de comprimento de linha do vCard. Teste alguns registros antes de importar um arquivo grande e, em seguida, verifique contatos duplicados, campos truncados, fotos não compatíveis e mapeamentos incorretos de nomes ou tipos de telefone.