Como importar registros de um objeto personalizado por CSV
No menu lateral, abra o objeto (ex.: Imóveis), clique em Importar, envie o CSV, escolha o modo (Criar, Atualizar ou Criar e atualizar), mapeie primeiro o campo principal e depois os outros e clique em Iniciar importação. Acompanhe, pause ou cancele em Contatos › Ações em massa.
Atualizado em
Antes de começar
- O objeto e os campos já precisam estar criados: a importação não cria campos novos.
- Salve a sua planilha em formato CSV, com uma linha de cabeçalho e uma coluna por campo. A coluna do campo principal é obrigatória.
- Se for atualizar registros existentes, inclua uma coluna com um campo único (ex.: placa, número de apólice) para o sistema saber qual registro atualizar.
- Limpe duplicados no arquivo antes de importar: linhas com valores repetidos em campos únicos são rejeitadas.
Onde encontrar
Menu lateral › (objeto, ex.: Imóveis) › Importar
Passo a passo
Importar o arquivo
- No menu lateral, abra o objeto onde você quer importar (ex.: Imóveis).
- No canto superior direito, clique em Importar.
- Selecione o objeto de destino e envie o arquivo CSV.
- Escolha o modo de importação:
- Criar: só cria registros novos (lista nova).
- Atualizar: só altera registros que já existem.
- Criar e atualizar: cria os novos e atualiza os existentes (arquivo misto).
- Se você mapeou mais de um campo único, escolha qual deles serve para identificar duplicados.
- Mapeie os campos: primeiro o campo principal e os obrigatórios, depois os outros (incluindo responsável e seguidores, se quiser).
- Se precisar que células vazias do CSV apaguem valores já salvos, ative Atualizar valores vazios (não vale para o campo principal nem para campos obrigatórios).
- Clique em Iniciar importação.
Acompanhar a importação
- Abra Contatos › Ações em massa e escolha a aba dos objetos personalizados.
- Veja o progresso; você pode pausar, retomar ou cancelar a importação.
- Clique na importação para ver as estatísticas e, nas abas Erros e Avisos, cada linha rejeitada com a indicação de como resolver.
Dicas
- Faça primeiro um teste com 5 a 10 linhas e confira os registros criados; só depois importe o arquivo completo.
- Datas e números: use um formato consistente na coluna inteira.
- Para ligar automaticamente cada registro importado ao contato certo (ex.: o dono do pet), crie antes um workflow do objeto com a ação Associar registros que procura o contato pelo e-mail incluído no CSV; publique o workflow antes de importar.
- Só dá para importar um objeto por arquivo.
Problemas comuns
- Linhas rejeitadas por "valor já existe" → Um campo único tem esse valor em outro registro. Corrija o arquivo e importe de novo só as linhas rejeitadas.
- Os registros ficaram duplicados → Você importou em modo Criar um arquivo com registros que já existiam. Use Atualizar ou Criar e atualizar com um campo único mapeado.
- Cancelei a importação mas alguns registros entraram → Cancelar impede o resto; as linhas já processadas ficam gravadas. Exclua pela lista do objeto (seleção em massa) se precisar.
- Campos vazios no CSV não apagaram os valores antigos → Por padrão, células vazias são ignoradas. Ative Atualizar valores vazios antes de iniciar.
- O campo que quero mapear não aparece → O campo ainda não existe no objeto. Crie em Configurações › Campos personalizados e repita a importação.
Perguntas frequentes
Posso importar associações no mesmo arquivo?
Não diretamente. Inclua no CSV uma coluna de identificação (e-mail ou telefone do contato) e use um workflow do objeto com a ação Associar registros para criar as ligações conforme os registros entram.
Onde vejo as importações antigas?
Em Contatos › Ações em massa, na aba dos objetos personalizados.
Isso foi útil?
Obrigado pela sua opinião.
