#Como importo uma planilha de imóveis (ou de outro objeto) para o CRM?

Abra o objeto no menu Contatos & Comercial (ex.: Imóveis) e clique em Importar. O assistente lê o CSV, sugere o campo de cada coluna e roda a importação em segundo plano — cada linha vira um registro, ou atualiza um que já existe.

Antes de começar

• O objeto precisa existir e não pode estar arquivado. Veja Como criar um objeto próprio no CRM.
• Importar pede a permissão Objetos personalizados → Importar. Quem tem a permissão só para os próprios registros importa registros sob a própria responsabilidade e só atualiza os registros em que já é o Responsável.
• Criar um campo novo durante a importação pede Objetos personalizados → Gerenciar.
• O arquivo é um CSV separado por vírgula, ponto e vírgula ou tabulação, com o cabeçalho na primeira linha.

#Importar

1. Clique em Importar e arraste o CSV (ou clique para escolher).
2. Confira a Pré-visualização: as primeiras linhas e as colunas detectadas.
3. Em Mapeamento, escolha o campo de cada coluna em Nosso campo. A IA já preenche o que reconhece; colunas que ela não reconheceu ficam em — Ignorar —, e o botão de estrela ao lado sugere campos para aquela coluna.
   • A coluna do campo-título (marcado com *, ex.: Endereço) é obrigatória.
   • Cada campo recebe uma coluna só.
   • Faltou um campo? No seletor, clique em Criar campo: o nome vem da coluna e o tipo, das amostras. O campo novo já fica selecionado.
4. Em Existentes, escolha se a planilha atualiza registros que já existem (veja abaixo) e quem fica como Responsável pelos registros criados. Sem escolher, eles ficam com você.
5. Em Confirmar, revise e clique em Iniciar importação.

A importação aparece no painel de tarefas, no canto da tela. Ao terminar, a listagem recarrega e Ver detalhes mostra quantos registros foram criados e atualizados, quantas linhas foram ignoradas e o motivo de cada falha.

#Atualizar registros que já existem

Para a planilha atualizar em vez de duplicar, escolha em Existentes um campo que identifica cada registro — um código, por exemplo. Só aparecem campos de texto ou número que estejam no mapeamento. Se o objeto tem um campo de valor único mapeado, ele já vem escolhido.

A linha cujo valor já existe num registro atualiza aquele registro, conforme a opção:

• Mesclar inteligente: preenche só os campos vazios do registro.
• Sobrescrever: grava os valores da planilha.
• Manter existente: não mexe no registro.

Célula vazia nunca apaga um valor. A comparação ignora maiúsculas e espaços nas pontas (NS-10235 = ns-10235). Se duas linhas do arquivo têm o mesmo valor, vale a primeira.

Com Não, sempre criar, toda linha vira um registro novo.

#Como os valores são lidos

• Números e moeda aceitam o formato brasileiro: R$ 1.980.000,00, 12,5%, 480.000.
• Datas: 08/10/2026 (dia primeiro) ou 2026-10-08.
• Sim/não: Sim, Não, S, N, 1, 0, true, false.
• Seleção: o nome da opção (Apartamento) ou a chave dela, sem diferença de maiúsculas e acentos. Em seleção múltipla, separe as opções com ;, , ou |.
• Foto: link http ou https da imagem (vários links separados por espaço ou ;).

Uma célula fora do formato é ignorada — o registro entra sem aquele valor — e o relatório mostra quantas células de cada campo ficaram de fora.

#Por que uma linha não entrou?

• Linha sem o título do registro: a coluna do título estava vazia numa linha que criaria um registro novo.
• Valor de campo único já usado em outro registro: um campo marcado como valor único repetiu um valor que já está em outro registro (ou numa linha anterior do mesmo arquivo).

Corrija as linhas na planilha e importe de novo — com um campo-chave escolhido, as linhas que já entraram são atualizadas em vez de duplicadas.