# 20. Importação de Dados



# 20.1 Importação de Leads

## Visão Geral

A funcionalidade **Importação de Dados** permite realizar a inclusão em massa de leads por meio do envio de arquivos de planilha. O processo automatiza a leitura das informações, o mapeamento das colunas, a validação dos dados e a aplicação das regras de importação antes da criação dos registros.

Essa funcionalidade é indicada para usuários que desejam importar listas de contatos provenientes de campanhas, eventos, feiras ou outras bases externas, reduzindo o trabalho de cadastro manual e agilizando a disponibilização dos leads para distribuição.

---

# Antes de Começar

Para utilizar a funcionalidade, é necessário:

- Possuir acesso ao menu **Configurações** do módulo **Prospecta**;
- Ter cadastradas previamente as opções de **Campanha**, **Origem** e **Mídia**, que poderão ser utilizadas durante o processo de importação.

---

# Como Acessar

1. Acesse o módulo **Prospecta**;
2. No menu lateral, clique em **Configurações**;
3. Selecione a opção **Importação de Dados**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/HFximage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/HFximage.png)

---

# Entendendo a Tela

A tela de **Importação de Dados** é organizada em quatro etapas, conduzindo o usuário durante todo o processo de importação.

## Modelo e Envio

Nesta etapa é possível:

- Baixar o modelo de planilha no formato CSV;
- Consultar os campos aceitos para importação;
- Enviar uma planilha preenchida;
- Utilizar uma planilha de exemplo para conhecer o fluxo da funcionalidade;  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/QyJimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/QyJimage.png)
- Consultar o histórico das importações realizadas.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/xz3image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/xz3image.png)

---

## De-para das Colunas

Após o envio da planilha, é exibido o mapeamento entre as colunas do arquivo e os campos do sistema.

Nesta etapa também é possível:

- Ajustar o mapeamento das colunas;
- Salvar perfis de mapeamento;
- Aplicar perfis previamente cadastrados;
- Prosseguir para a conferência dos dados.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/VwAimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/VwAimage.png)

---

## Conferência

Antes da importação definitiva, são apresentados:

- Quantidade de registros encontrados;
- Registros válidos;
- Registros duplicados;
- Registros com avisos;
- Registros com erro.

Também é possível:

- Definir a regra para tratamento de leads já existentes;
- Informar a Campanha padrão;
- Informar a Origem padrão;
- Informar a Mídia padrão;  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/kDFimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/kDFimage.png)
    
    <p class="callout info">Essas informações serão utilizadas caso haja colunas em branco na planilha</p>
- Se a **Campanha**, **Mídia**, **Origem** ou **Empreendimento** informados na planilha não forem localizados no sistema, será necessário realizar o mapeamento correspondente.  
    Caso os mesmos não sejam informados, será considerada as informações inseridas na configuração de 'Regras de Importação'  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/yvSimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/yvSimage.png)
- Caso esses campos não sejam informados na planilha, serão consideradas as informações previamente configuradas em **Regras de Importação**.
- Após concluir todas as configurações, clique em **Autorizar Importação** para iniciar o processamento dos leads da planilha.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/jyKimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/jyKimage.png)

---

# Desfazer a Importação em Lote

A opção **Desfazer a Importação em Lote** permite reverter uma importação de leads realizada de forma incorreta.

Ao utilizar essa opção, o sistema identifica os leads incluídos pela importação selecionada e **exclui aqueles que ainda não foram convertidos em oportunidade**.

> **Importante:** A utilização dessa opção depende de uma **configuração prévia realizada pelo time de Suporte/Implantação**.

### Como desfazer uma importação

1. Acesse a importação que deseja desfazer.
2. Selecione a opção **Desfazer a Importação em Lote**.  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/DNRimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/DNRimage.png)
3. O sistema identificará os leads provenientes daquela importação.
4. Serão excluídos somente os leads que **não foram convertidos em oportunidade**.  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/ftDimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/ftDimage.png)
5. Leads que já tenham se tornado oportunidades **não serão excluídos**.

> **Atenção:** Antes de realizar o procedimento, certifique-se de que a importação selecionada é realmente aquela que deseja desfazer. A exclusão dos leads elegíveis poderá ser irreversível.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/NgRimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/NgRimage.png)

---

## Resultado

Após a conclusão da importação, é apresentada uma visão consolidada contendo:

- Quantidade de leads criados;
- Registros ignorados;
- Registros com erro;
- Registros não enviados;
- Situação individual de cada linha processada.

Também é possível iniciar uma nova importação ou visualizar o botão **Desfazer este lote**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/6nrimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/6nrimage.png)

---

# Como Preencher as Informações

<div class="TyagGW_tableContainer" id="bkmrk-campo-descri%C3%A7%C3%A3o-nome"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="4737" data-start="3847"><thead data-end="3868" data-start="3847"><tr data-end="3868" data-start="3847"><th class="last:pe-10" data-col-size="sm" data-end="3855" data-start="3847">Campo</th><th class="last:pe-10" data-col-size="md" data-end="3868" data-start="3855">Descrição</th></tr></thead><tbody data-end="4737" data-start="3892"><tr data-end="3980" data-start="3892"><td data-col-size="sm" data-end="3907" data-start="3892">Nome do Lead</td><td data-col-size="md" data-end="3980" data-start="3907">Campo obrigatório. Caso não seja informado, o registro será ignorado.</td></tr><tr data-end="4074" data-start="3981"><td data-col-size="sm" data-end="3991" data-start="3981">Celular</td><td data-col-size="md" data-end="4074" data-start="3991">Obrigatório quando o e-mail não for informado. Deve conter DDD e número válido.</td></tr><tr data-end="4135" data-start="4075"><td data-col-size="sm" data-end="4084" data-start="4075">E-mail</td><td data-col-size="md" data-end="4135" data-start="4084">Obrigatório quando o celular não for informado.</td></tr><tr data-end="4223" data-start="4136"><td data-col-size="sm" data-end="4147" data-start="4136">CPF/CNPJ</td><td data-col-size="md" data-end="4223" data-start="4147">Campo opcional utilizado para auxiliar na identificação de duplicidades.</td></tr><tr data-end="4304" data-start="4224"><td data-col-size="sm" data-end="4241" data-start="4224">Empreendimento</td><td data-col-size="md" data-end="4304" data-start="4241">Campo opcional para associação do lead a um empreendimento.</td></tr><tr data-end="4370" data-start="4305"><td data-col-size="sm" data-end="4314" data-start="4305">Origem</td><td data-col-size="md" data-end="4370" data-start="4314">Campo opcional para identificação da origem do lead.</td></tr><tr data-end="4448" data-start="4371"><td data-col-size="sm" data-end="4379" data-start="4371">Mídia</td><td data-col-size="md" data-end="4448" data-start="4379">Campo opcional para identificação da mídia utilizada na captação.</td></tr><tr data-end="4535" data-start="4449"><td data-col-size="sm" data-end="4467" data-start="4449">Campanha Padrão</td><td data-col-size="md" data-end="4535" data-start="4467">Obrigatória quando a campanha não estiver informada na planilha.</td></tr><tr data-end="4618" data-start="4536"><td data-col-size="sm" data-end="4552" data-start="4536">Origem Padrão</td><td data-col-size="md" data-end="4618" data-start="4552">Obrigatória quando a origem não estiver informada na planilha.</td></tr><tr data-end="4737" data-start="4619"><td data-col-size="sm" data-end="4634" data-start="4619">Mídia Padrão</td><td data-col-size="md" data-end="4698" data-start="4634">Obrigatória quando a mídia não estiver informada na planilha.</td></tr></tbody></table>

</div></div>---

# Regras de Negócio

- Cada lead deve possuir obrigatoriamente um nome.
- É necessário informar pelo menos um meio de contato (celular ou e-mail).
- Durante a conferência, é obrigatório selecionar a Campanha, Origem e Mídia padrão quando essas informações não estiverem presentes no arquivo.
- Caso existam registros duplicados, o usuário poderá optar por ignorá-los, importar um novo cadastro ou atualizar o cadastro existente.
- Valores não mapeados devem ser associados manualmente antes da conclusão da importação.

---

# Resultado da Importação

Após a conclusão do processo:

- Os leads válidos são cadastrados no sistema.
- Os novos registros permanecem no status **Represados**, aguardando distribuição.
- A operação fica registrada no histórico de importações.
- O botão **Desfazer este lote** permanece visível, porém não está funcional na versão atual.

---

# Mensagens

Durante a importação podem ser apresentadas as seguintes mensagens:

<div class="TyagGW_tableContainer" id="bkmrk-mensagem-significado"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="6550" data-is-last-node="" data-is-only-node="" data-start="5775"><thead data-end="5817" data-start="5775"><tr data-end="5817" data-start="5775"><th class="last:pe-10" data-col-size="sm" data-end="5786" data-start="5775">Mensagem</th><th class="last:pe-10" data-col-size="md" data-end="5800" data-start="5786">Significado</th><th class="last:pe-10" data-col-size="md" data-end="5817" data-start="5800">Como proceder</th></tr></thead><tbody data-end="6550" data-is-last-node="" data-start="5861"><tr data-end="6002" data-start="5861"><td data-col-size="sm" data-end="5883" data-start="5861">Simulação concluída</td><td data-col-size="md" data-end="5947" data-start="5883">A planilha de exemplo foi utilizada e nenhum lead foi criado.</td><td data-col-size="md" data-end="6002" data-start="5947">Envie uma planilha real para realizar a importação.</td></tr><tr data-end="6189" data-start="6003"><td data-col-size="sm" data-end="6031" data-start="6003">Confirmação de Importação</td><td data-col-size="md" data-end="6101" data-start="6031">Informa a quantidade de leads que será criada antes da confirmação.</td><td data-col-size="md" data-end="6189" data-start="6101">Clique em **Autorizar importação** para prosseguir ou em **Cancelar** para retornar.</td></tr><tr data-end="6343" data-start="6190"><td data-col-size="sm" data-end="6209" data-start="6190">Contato repetido</td><td data-col-size="md" data-end="6280" data-start="6209">O registro foi ignorado conforme a regra de duplicidade selecionada.</td><td data-col-size="md" data-end="6343" data-start="6280">Nenhuma ação é necessária, caso essa seja a regra desejada.</td></tr><tr data-end="6550" data-is-last-node="" data-start="6344"><td data-col-size="sm" data-end="6358" data-start="6344">Não Mapeado</td><td data-col-size="md" data-end="6430" data-start="6358">O valor da planilha não possui correspondência automática no sistema.</td><td data-col-size="md" data-end="6509" data-start="6430">Selecione manualmente o valor correspondente antes de concluir a importação.</td></tr></tbody></table>

</div></div>