Você exporta a agenda de um provedor e importa os contatos em outro. Parece que está tudo resolvido, até conferir o resultado. Os nomes estão lá, assim como os e-mails principais. Mas o segundo telefone, o endereço postal, o cargo anterior e a anotação que você fez em 2021 sobre quem apresentou vocês desapareceram. E ninguém avisou.
A causa pode estar tanto no formato do arquivo quanto nas capacidades do importador. CSV não transfere dados sem uma coluna reconhecida. Mas um formato mais completo também não resolve se o sistema de destino lê apenas parte dos campos.
Veja o que os formatos permitem, como conferir a transferência e o que fazer com possíveis duplicatas.
Um contato não é apenas uma linha
Em uma planilha comum, cada célula contém um valor. Um contato pode incluir:
- Vários e-mails com rótulos: trabalho, casa ou um endereço antigo que ainda encaminha mensagens.
- Vários telefones, também com seus próprios rótulos.
- Endereços postais divididos em campos, não apenas uma sequência de texto.
- Uma organização e um cargo que mudam ao longo do tempo.
- Anotações de tamanhos variados, com vírgulas e quebras de linha.
- Uma fotografia.
- Participação em vários grupos ao mesmo tempo.
Para encaixar essas informações em uma tabela, é preciso manter apenas o primeiro valor repetido ou criar colunas como email_2 e email_3. Cada ferramenta usa suas próprias convenções. Na transferência de um CSV, podem se perder os campos cujos nomes não correspondem entre o exportador e o importador.
A perda pode passar despercebida. Para o importador, a operação dá certo se todas as colunas conhecidas foram lidas. As demais podem simplesmente ficar de fora do resultado, sem aviso.
vCard ou CSV para importar contatos
| vCard (.vcf) | CSV | |
|---|---|---|
| Vários e-mails e telefones | O formato aceita valores com rótulos; aqui a importação de arquivos seleciona um de cada tipo | Precisa de colunas compatíveis; o importador atual também seleciona um valor de cada tipo |
| Endereços postais estruturados | O formato aceita; na importação de arquivos, eles são reunidos em um texto | Geralmente são salvos em um único texto |
| Fotografias | O formato pode armazenar fotos, mas o importador de arquivos atual não as transfere | A importação atual não aceita fotografias |
| Anotações com vírgulas ou quebras de linha | Aceitas se os caracteres forem escapados corretamente | Aceitas com as aspas corretas; erros podem deslocar colunas |
| Grupos | Depende da versão e do aplicativo; a importação de arquivos não transfere os membros dos grupos aqui | A importação atual não transfere a participação em grupos |
| Edição em uma planilha | Não foi feito para um editor de planilhas convencional | Sim |
| Comparação das alterações como texto | Possível, dependendo da representação dos campos | Possível; a ordem das linhas e as aspas podem dificultar a comparação |
Uma versão do formato vCard é descrita na RFC 6350. vCard é amplamente usado para trocar contatos e representa campos repetidos e endereços complexos. Porém, diferentes versões do Contatos do Google, Outlook, Contatos da Apple e aplicativos móveis podem oferecer opções distintas de exportação. Um campo presente no arquivo não será necessariamente preservado pelo importador.
Vale a pena guardar uma exportação vCard da agenda original quando ela estiver disponível. Antes de importar em lote, confira os campos necessários em alguns contatos. CSV é útil para editar os dados em uma planilha ou quando o sistema de destino exige esse formato. A extensão do arquivo, sozinha, não garante uma transferência completa.
Quando vale a pena usar CSV
CSV é prático quando os dados precisam de ajustes: remover duplicatas de várias listas, corrigir maiúsculas, preencher uma coluna de empresa ou retirar pessoas que não foram contatadas desde 2019. Uma planilha costuma facilitar essas tarefas mais do que a interface de uma agenda.
O CSV precisa de uma linha de cabeçalhos. Não há distinção entre maiúsculas e minúsculas, mas a escrita importa: nem todas as variantes abaixo são reconhecidas da mesma forma.
| Coluna | Campo de destino | Obrigatória |
|---|---|---|
email ou email_address | E-mail principal; a segunda variante é detectada pela busca de um cabeçalho adequado | Sim, é preciso um e-mail válido |
name, ou first_name + last_name | Nome do contato; para separar nome e sobrenome, substitua os sublinhados por espaços | Não |
company ou organization | Empresa | Não |
job_title ou title | Cargo; a primeira variante é detectada por uma correspondência parcial do cabeçalho | Não |
phone | Número de telefone | Não |
address | Endereço postal em um único texto | Não |
birthday ou birth_date | Data no formato YYYY-MM-DD; substitua o segundo cabeçalho pelo primeiro ou separe suas palavras com um espaço | Não |
notes | Anotações | Não |
Colunas desconhecidas são ignoradas. Valores vazios não apagam campos existentes na atualização. Linhas sem um e-mail válido são puladas, enquanto um erro estrutural ou o excesso de um limite pode cancelar toda a operação. Teste primeiro uma pequena amostra antes de carregar um arquivo grande.
Planilhas têm mais dois riscos. Telefones que começam com + ou zeros podem ser tratados como números e perder esses caracteres. Defina o formato de texto antes de carregar ou digitar os dados: mudar o formato depois não recupera o que foi perdido. Valores que começam com =, + ou - podem ser interpretados como fórmulas. Abra esses arquivos com cuidado, especialmente se a origem for desconhecida.
Se a ferramenta oferece uma prévia, confira a quantidade de registros, alguns exemplos e os avisos de validação. A importação atual de contatos do webmail carrega o arquivo diretamente e informa depois quantos registros foram processados ou pulados; não oferece uma prévia antes da importação. Faça um backup da agenda e teste um arquivo pequeno primeiro.
Importar para uma agenda que já tem contatos
O caso mais delicado não é uma agenda vazia, mas uma que já contém parte dos contatos que serão importados.
Algumas ferramentas substituem totalmente o contato encontrado pelo registro recebido. Parece correto, mas pode apagar informações: o CSV tinha poucas colunas, enquanto o contato existente também tinha celular, endereço postal e anos de anotações. Após a substituição, restam apenas os campos do arquivo.
Aqui a importação atualiza campos aceitos com valores recebidos não vazios no contato cujo e-mail coincide. Campos ausentes ou vazios ficam como estavam. Você pode acrescentar uma empresa sem apagar o restante. Porém, o cartão original recebido por CardDAV não é reescrito: o webmail e o cliente CardDAV podem mostrar dados diferentes temporariamente. Confira isso separadamente.
Verifique como cada ferramenta atualiza contatos existentes. Recuperar dados depende de backups e do histórico disponível; sem eles, alguns campos perdidos podem ser impossíveis de recuperar.
O problema das duplicatas
Agendas acumulam duplicatas, e uma importação pode acrescentar outras. A mesma pessoa pode usar anna@acme.com, a.smith@acme.com e anna.smith@gmail.com. Todos os endereços são reais, mas o sistema não sabe necessariamente que pertencem à mesma Anna.
Uma comparação automática nem sempre identifica a pessoa. Ter o mesmo nome não basta: pessoas diferentes podem ter nomes iguais. O e-mail fornece uma chave clara para atualizar, mas não prova identidade, pois pode ser compartilhado ou ter sido transferido para outro funcionário. Confira o titular antes de combinar registros.
Depois de importar, ordene por nome e revise possíveis correspondências. Uma lista grande pode exigir mais tempo do que parece. Comparar e-mails, telefones e contexto ajuda a decidir com fundamento, mas não transforma toda semelhança em prova.
É melhor reduzir as diferenças desde o começo. Um contato criado a partir de uma mensagem recebida usa o endereço do remetente; na digitação manual, é fácil errar. Um método consistente ajuda, mas confira quem enviou a mensagem e qual endereço precisa ser salvo.
Sincronizar em vez de importar
Importar cria uma cópia pontual. Para manter as agendas do celular e do webmail alinhadas, use sincronização por CardDAV.
CardDAV permite que os clientes leiam e alterem a agenda no servidor, de forma parecida com IMAP para e-mails. Um contato adicionado no celular aparece depois de uma sincronização bem-sucedida. Isso não precisa ser imediato: conexão, execução em segundo plano e intervalo de atualização influenciam o resultado.
O Contatos da Apple no macOS e no iOS aceita CardDAV. No Android, costuma-se usar DAVx⁵, enquanto o Thunderbird tem suporte próprio. O Outlook geralmente precisa de um complemento de terceiros; a compatibilidade depende da versão e do cliente escolhido.
Guias de configuração: Apple no macOS, iPhone e iPad, Android com DAVx⁵ e Thunderbird.
A sincronização reduz o risco de manter cópias diferentes no celular e no computador por muito tempo. Mas conflitos, exclusões e erros de configuração continuam possíveis. Não considere a sincronização um substituto do backup.
Passos para transferir a agenda
- Guarde uma exportação vCard do provedor anterior, se estiver disponível. Confira as opções da sua versão do Contatos do Google, Outlook ou Contatos da Apple. Se precisar de CSV, mantenha os dados originais separados também.
- Abra o arquivo e confira o conteúdo. Uma vCard é texto. Procure um contato com muitos campos e verifique se os dados necessários foram exportados.
- Ajuste os dados em uma planilha se necessário, considerando os limites do formato e do importador. Guarde a exportação original completa separadamente.
- Teste a importação com uma pequena amostra. Se a ferramenta oferece uma prévia, confira. No webmail atual, revise o resultado depois de carregar o arquivo e faça um backup antes.
- Confira alguns contatos após a importação. Abra o mesmo contato complexo e compare com a origem, inclusive nos clientes conectados.
- Revise possíveis duplicatas manualmente, ordenando por nome e comparando os outros dados.
- Configure CardDAV nos dispositivos para reduzir a necessidade de novas exportações. Confira se a sincronização funciona nos dois sentidos.
- Guarde o arquivo original em um local protegido durante a conferência da transferência. Ele contém dados pessoais: limite o acesso e defina por quanto tempo será mantido.
Também é possível importar contatos pela API. Para um servidor MCP, confira as ferramentas disponíveis e seus campos. A importação de arquivos não transfere a participação em grupos. Na API REST, ela é gerenciada em operações separadas, úteis para montar uma agenda a partir de um CRM.
Perguntas frequentes
Qual formato devo usar para importar contatos?
Guarde uma exportação original completa, de preferência vCard quando disponível, e teste o importador com alguns registros. vCard aceita campos complexos, mas a importação atual de arquivos lê apenas parte deles e não transfere fotos nem grupos. CSV é útil para editar em planilhas se os cabeçalhos forem reconhecidos corretamente.
A importação vai sobrescrever os contatos existentes?
Campos aceitos com valores não vazios atualizam o contato cujo e-mail coincide. Campos ausentes ou vazios não o apagam. Porém, o cartão original CardDAV permanece separado e não é reescrito por essa importação. Confira tanto o webmail quanto o cliente sincronizado.
Por que meus telefones foram importados incorretamente?
A planilha pode tê-los tratado como números e removido o + inicial ou os zeros. Defina o formato de texto antes do processamento. Se já faltam caracteres, volte à exportação original. vCard evita essa conversão da planilha, mas não amplia as capacidades do importador.
Posso importar contatos sem e-mail?
O formato vCard permite, mas a importação atual de arquivos exige um e-mail válido tanto em CSV quanto em vCard e pula registros sem ele. Não confunda as capacidades de um cliente CardDAV com as do carregamento de arquivos.
Como levo os contatos para o celular?
Para uso contínuo, configure CardDAV em um aplicativo compatível. Os clientes sincronizarão a agenda do servidor. Confira a conta, o sentido da sincronização e o resultado; atrasos e conflitos continuam possíveis.
As duplicatas são removidas durante a importação?
A importação atualiza pela correspondência do e-mail, sem identificar a pessoa. Um endereço compartilhado ou transferido para outro funcionário precisa de revisão. Nomes iguais não são combinados automaticamente. Após uma importação grande, confira manualmente as possíveis duplicatas.
Posso exportar meus contatos novamente?
Sim, em CSV ou vCard. São exportados os campos aceitos pela ferramenta atual, não necessariamente o cartão original CardDAV inteiro. Antes de alterações em lote, guarde um backup adequado e confira seu conteúdo.
O que acontece com os grupos de contatos?
As possibilidades de vCard dependem da versão e do aplicativo, mas a importação atual não reconstrói membros de grupos a partir de vCard nem de CSV. A API REST permite gerenciar grupos e membros em operações separadas. No MCP, confira se as ferramentas correspondentes estão disponíveis.
