Converter contatos CSV em VCF (vCard)

Como converter CSV em vCard

1. Clique em Abrir arquivo, arraste uma exportação .csv, .tsv ou .txt do seu CRM, planilha ou programa de e-mail, ou escolha Colar. Se os nomes aparecerem embaralhados, confira o delimitador e a codificação em Configurações de importação.
2. Escolha a Versão do vCard: vCard 4.0 para celulares e apps atuais, vCard 3.0 para agendas mais antigas.
3. Revise Associar colunas aos campos do contato. As colunas são associadas pelo nome do cabeçalho; troque qualquer campo ou marque Não usar. Os campos menos comuns ficam em Mais opções.
4. Clique em Baixar VCF e importe o arquivo no seu celular, no Google Contatos, no Outlook ou nos Contatos da Apple.

Se a lista tiver espaços sobrando ou contatos duplicados, limpe-a antes: Limpar dados do CSV remove espaços e duplicados, e Renomear e reordenar colunas do CSV renomeia, reordena ou remove colunas antes da conversão.

Quais campos são gravados

Cada campo recebe uma coluna, e a associação automática usa cada coluna no máximo uma vez. Uma célula com dois endereços, como a@example.com; b@example.com, continua sendo um único valor; coloque o segundo endereço em uma coluna própria e associe-a a E-mail (trabalho).

Escape, espaços cortados e linhas longas

• A associação automática ignora maiúsculas e minúsculas, espaços, sublinhados, hífens e pontos, e reconhece os cabeçalhos mais comuns em exportações de contatos, além dos equivalentes em vários idiomas (Vorname, Nachname, Teléfono, 姓名…). Uma coluna chamada só Phone é associada a Celular, e Email a E-mail (pessoal).
• Vírgulas, pontos e vírgulas e barras invertidas nos valores são escapados como \,, ; e \\, e uma quebra de linha vira \n, como exige a RFC 6350. Acme, Inc. continua sendo um único nome de empresa.
• Os espaços em volta de cada valor são removidos. Nomes acentuados e em escritas não latinas são gravados em UTF-8.
• Linhas com mais de 75 bytes são dobradas em linhas de continuação que começam com um espaço, sem partir um caractere de vários bytes. As linhas terminam com CRLF.
• Uma linha sem nome, empresa nem e-mail não forma um cartão válido; por isso é ignorada e contada em um aviso acima da prévia.

Quando os contatos não são importados direito

• “Associe pelo menos uma coluna a um campo do contato.” Nenhum cabeçalho foi reconhecido. Escolha as colunas você mesmo em Associar colunas aos campos do contato.
• Os nomes aparecem como é depois da importação. O CSV não foi lido como UTF-8. Escolha a codificação dele (muitas vezes Windows-1252, em exportações antigas do Outlook ou do Excel) em Configurações de importação, confira a prévia e baixe de novo.
• Está faltando um contato. A linha dele não tinha nome, empresa nem e-mail e foi ignorada; o aviso acima da prévia mostra quantas foram. Associe uma coluna de nome ou preencha a linha.
• Uma agenda mais antiga recusa o arquivo. Mude a versão do vCard para vCard 3.0 e baixe de novo.

Limites e privacidade

Arquivos de até 25 MB, 100.000 linhas ou 2 milhões de células abrem com prévia ao vivo das primeiras 200 linhas. Arquivos maiores são convertidos em modo de streaming: o arquivo é lido duas vezes, em partes (uma para medir as colunas, outra para gravar), um aviso informa que o download cobre o arquivo inteiro e a opção Copiar não fica disponível. Cada arquivo de saída tem limite de 4 GB.

Os dados dos contatos ficam no seu dispositivo: a conversão roda em um worker em segundo plano nesta aba, Cancelar interrompe o processo e o CSV nunca é enviado a um servidor. Com Lote: converter vários arquivos, todos os arquivos usam as associações de colunas atuais, então converta em lote só arquivos com os mesmos cabeçalhos.

Exemplo: três contatos em vCard 4.0

Três linhas de uma exportação de contatos, convertidas para vCard 4.0 com as associações automáticas. A vírgula de Acme, Inc. e a quebra de linha da observação são escapadas; a linha que só tem empresa recebe o nome da empresa; a última linha não tem nome, empresa nem e-mail e é ignorada. O arquivo baixado usa quebras de linha CRLF.

First Name,Last Name,Company,Email,Phone,City,Notes
Ana,García,"Acme, Inc.",ana@example.com,+34 600 123 456,Madrid,"Met at the expo
Prefers email"
,,Northwind Traders,,+1 206 555 0100,Seattle,
,,,,,,No contact details

BEGIN:VCARD
VERSION:4.0
FN:Ana García
N:García;Ana;;;
ORG:Acme\, Inc.
EMAIL;TYPE=home:ana@example.com
TEL;TYPE=cell,voice:+34 600 123 456
ADR:;;;Madrid;;;
NOTE:Met at the expo\nPrefers email
END:VCARD
BEGIN:VCARD
VERSION:4.0
FN:Northwind Traders
ORG:Northwind Traders
TEL;TYPE=cell,voice:+1 206 555 0100
ADR:;;;Seattle;;;
END:VCARD