Importando contatos via CSV
Última atualização em
Para trazer uma base existente de uma vez, use Contatos → Importar.
Formato do arquivo
O CSV precisa ter uma coluna phone — é a única obrigatória. As colunas opcionais são:
nameemailcompanytags— nomes separados por vírgula; se um contato tiver mais de uma tag, coloque o valor da célula entre aspas (ex.:"vip, atacado") para a vírgula interna não ser lida como separador de coluna.
Antes de confirmar, o Cerne Talk mostra uma prévia das primeiras linhas lidas e quantos registros estão prontos para importar, para você conferir se o mapeamento das colunas ficou certo antes de rodar de verdade.
Tags que ainda não existem
A importação não cria tags novas automaticamente a partir da coluna tags — se o CSV citar uma tag que a conta ainda não tem cadastrada, essa atribuição específica é pulada (o contato é importado normalmente, só não recebe aquela tag). O resultado final da importação lista quais tags foram ignoradas por esse motivo, para você criá-las em Configurações → Tags e rodar de novo se precisar.
Duplicados
Contatos cujo telefone já existe na base são contados como duplicados e pulados — a importação não sobrescreve um contato existente, então editar em lote via CSV não é o caminho (para isso, edite contato por contato ou use a API pública com o endpoint de contatos).
O resumo ao final
Toda importação termina com um resumo: quantos contatos foram criados, quantas atribuições de tag foram aplicadas, quantos registros foram pulados por duplicidade e quantos falharam por outro motivo. Vale conferir esse resumo antes de considerar a importação concluída — um CSV mal formatado (sem a coluna phone, por exemplo) é rejeitado inteiro, com um aviso claro do motivo.