Importar registros de um único objeto

Em Mais ações, Importar abre o seletor de arquivos do seu computador. Não há assistente nem passo de mapeamento: o arquivo é processado como chega, e leva o mapeamento dentro, na sua planilha datamap.

A interface anuncia que detecta o formato sozinha. Não é verdade para qualquer formato: só funciona o .xlsx que sai do modelo — um .csv não produz nenhum resultado, veja Formatar arquivos de importação.

O que faz com cada linha

Cada importação é um upsert por e-mail, sem seletor de modo: se o e-mail já existe, atualiza aquele contato; se não, cria um novo. A comparação ignora maiúsculas, mas não os espaços em branco — um espaço invisível no início do e-mail cria uma duplicata, veja Revisar e resolver erros de importação.

Por padrão o modelo traz um único objeto: o de Contatos cria ou atualiza contatos, não empresas nem negócios. Para carregar vários tipos de uma vez, adiciona-se uma planilha por objeto e uma linha ao mapa de dados, como explica Importar registros para vários objetos.

Um exemplo completo: Negócios

No menu lateral, selecione Negócios e, em Mais ações, escolha Baixar modelo. Cada objeto fornece seu próprio modelo, com as colunas esperadas.

1. Preencha dealName, o campo obrigatório de cada negócio.
2. Acrescente o que precisar: Atribuído a, Colaboradores, Etapa, etiquetas, prioridade e os campos personalizados da planilha Deal.
3. Salve o arquivo sem renomear os cabeçalhos.
4. Volte a Mais ações > Importar e selecione o arquivo.

O que significa cada grupo de colunas

A planilha Deal conserva os nomes técnicos das propriedades. Deixe vazias as que não precisar.

Colunas	O que representam	Quando preenchê-las
skip	Indica se a linha é ignorada.	Deixe como vem, salvo se precisar excluir uma linha.
refId, refUrl, _id, dealCode	Identificadores e referências internas.	Não os invente; servem para trabalhar com dados já existentes.
dealName	Nome do negócio.	É o campo obrigatório ao criar um negócio.
contact, adCampaign, group, contracts, proposalWizard	Relações com outros registros.	Preencha só se for vincular o negócio a esses registros.
assignee	Usuário principal responsável pelo negócio.	Use para atribuir o registro a uma pessoa.
collaborators	Usuários adicionais que participam do negócio.	Use para carregar vários colaboradores sem mudar assignee.
stage, priority, pipelineStages, stageMovedMethod	Estado e percurso comercial do negócio.	Preencha etapa e prioridade quando precisar do negócio já classificado; deixe as colunas de histórico como estão se não as usar.
tags, source, observations, meta	Classificação, procedência e notas.	Preencha quando esses dados estiverem no seu arquivo.
closeDate, denied.reason, denied.details	Data estimada de fechamento e motivo de recusa.	Use apenas para negócios que já tenham essa informação.
proposal.*, proposalVersions.*, thumbnail	Dados de propostas, versões e arquivos relacionados.	Deixe vazios, salvo se a importação incluir esses dados preparados.
customFields.*	Campos personalizados da sua conta, como customFields.departamento.	Preencha só se aquele campo existir no seu objeto e você tiver um valor válido.
workspace	Espaço de trabalho ao qual o negócio pertence.	Não mude sem confirmar o workspace de destino.

As colunas mudam de um módulo para outro, mas a lógica é a mesma em todos — o detalhe do que cada modelo traz está em Entender a ferramenta de importação.

Depois de enviar o arquivo

O painel Importar dados informa o andamento e o resultado, e guarda uma entrada por carga enquanto você continuar na página — veja Ver e analisar importações anteriores. Se algo entrou errado, Editar registros em massa corrige em bloco sem repetir a importação.