# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-05-28T23:41:39.532Z

## Página

- Título: Importar leads por CSV
- URL humana: https://agilize.app/docs/configuracao/crm-dados/importar-leads-csv
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como importar oportunidades em lote na Agilize, enviando um CSV, mapeando colunas, escolhendo funil, etapa, origem, tags, distribuição e acompanhando o resultado do processamento.

## Seções

- Quando usar
- Onde acessar
- Antes de começar
- Enviar o CSV
- Mapear as colunas
- Usar identificadores com cuidado
- Configurar a oportunidade gerada
- Processar a importação

## Conteúdo da página

# Importar leads por CSV

A importação por CSV permite criar oportunidades em lote e, quando necessário, relacionar contatos e empresas ao mesmo processo. Use esse recurso para migrar bases, carregar listas qualificadas, iniciar campanhas comerciais ou organizar registros vindos de outras ferramentas.

Como a importação altera a base do CRM, trate o processo como uma atividade de configuração e governança de dados. Um arquivo bem preparado reduz duplicidades, melhora a distribuição do time e evita oportunidades sem contexto comercial.

Importante: importar contatos, empresas ou oportunidades por CSV não executa automações de CRM automaticamente. A importação prepara a base; se um processo precisa iniciar automação depois disso, valide os registros e execute uma ação operacional, fluxo do bot, webhook de entrada ou chamada de API que seja gatilho válido para a regra.

## Quando usar

Use este guia quando você precisa:

- importar uma lista de oportunidades para o CRM;
- criar leads com nome, telefone, e-mail, empresa, valor e observação;
- relacionar oportunidades a contatos e empresas;
- definir funil e etapa inicial para os registros importados;
- aplicar origem, tags e distribuição para o time;
- acompanhar quantos registros foram criados, alterados ou ignorados;
- revisar duplicidades antes de colocar a base em operação.

## Onde acessar

Acesse [https://my.agilize.app/file/import/create](https://my.agilize.app/file/import/create).

Acesso pela tela: barra superior **Cadastrar** > **Importação em Lote**. Pelo CRM, você também pode abrir **Oportunidades**, acessar o menu de opções do quadro e escolher **Importar CSV**.

## Antes de começar

Prepare o CSV antes de enviar. A primeira linha deve trazer nomes claros para as colunas, porque esses nomes aparecem na etapa de mapeamento.

Exemplo de estrutura recomendada:

| Coluna no CSV | Exemplo | Uso recomendado |
| --- | --- | --- |
| `nome` | Marina Costa | Nome da oportunidade ou do lead. |
| `email` | marina.costa@exemplo.com | E-mail principal para relacionamento e deduplicação. |
| `telefone` | +5511987654301 | Telefone com DDI, preferencialmente começando com `+`. |
| `empresa` | Costa Consultoria | Empresa relacionada à oportunidade. |
| `valor` | 9800 | Valor estimado da oportunidade. |
| `observacao` | Interesse em WhatsApp e CRM | Contexto para o time comercial. |

Recomendações importantes:

- importe primeiro uma amostra pequena para validar o mapeamento;
- use telefones com DDI para evitar duplicidade;
- evite colunas com dados misturados, como telefone e observação no mesmo campo;
- preencha origem e tags quando a lista vier de campanha, evento, mídia paga ou prospecção;
- confirme o funil e a etapa antes de processar;
- não importe linhas vazias ou registros sem dados mínimos de contato.

## Enviar o CSV

Na tela de importação, selecione ou arraste o arquivo CSV e escolha o separador das colunas. Você pode deixar o separador como **Automático** ou selecionar **Ponto e vírgula (;)** ou **Vírgula (,)** quando souber o formato do arquivo.

![Tela de importação em lote com CSV selecionado e separador automático](/docs/screenshots/importacao-leads-upload-csv.png)

Depois de revisar o arquivo selecionado, clique em **Cadastrar**. A Agilize prepara as primeiras linhas e abre a etapa de mapeamento.

## Mapear as colunas

No mapeamento, cada coluna do CSV precisa ser associada a um campo da plataforma. A coluna **Visualização** mostra um exemplo real da planilha para ajudar a escolher o campo correto.

![Mapeamento de colunas do CSV para campos de lead, empresa e oportunidade](/docs/screenshots/importacao-leads-mapeamento-campos.png)

Um mapeamento comum para importação de leads é:

| Coluna no CSV | Campo na plataforma |
| --- | --- |
| `nome` | **Nome (Lead / Negócio)** |
| `email` | **E-mail (Lead / Negócio)** |
| `telefone` | **Telefone (Lead / Negócio)** |
| `empresa` | **Nome (Empresa)** |
| `valor` | **Valor Oportunidade (Lead / Negócio)** |
| `observacao` | **Observação (Lead / Negócio)** |

Ao mapear qualquer campo de **Lead / Negócio**, a importação passa a gerar oportunidades. Se você também mapear campos de **Contato** ou **Empresa**, a Agilize pode criar esses cadastros relacionados ao lead.

## Usar identificadores com cuidado

A coluna **Identificador** ajuda a reconhecer quando linhas repetidas pertencem ao mesmo cadastro. Use essa opção em dados estáveis, como nome, telefone ou e-mail.

Boas escolhas de identificador:

- telefone do contato;
- e-mail do contato;
- nome da empresa, quando a planilha representa empresas;
- nome do contato, quando não há telefone ou e-mail confiável.

Evite marcar como identificador:

- observação;
- valor da oportunidade;
- etapa;
- origem;
- campos que podem variar entre uma linha e outra.

Quando uma coluna identificadora se repete, a importação tenta reaproveitar o cadastro em vez de criar registros fragmentados. Isso reduz duplicidades, mas depende da qualidade dos dados enviados.

## Configurar a oportunidade gerada

Antes de processar, revise as configurações adicionais:

| Configuração | Impacto |
| --- | --- |
| **O arquivo CSV tem cabeçalho?** | Mantém a primeira linha como nome das colunas. Deixe ativo quando a planilha tiver cabeçalho. |
| **Gerar oportunidade associada** | Cria uma oportunidade quando há campos de lead mapeados ou quando a opção é ativada manualmente. |
| **Funil** | Define em qual funil as oportunidades serão criadas. |
| **Etapa** | Define a etapa inicial dos leads importados. |
| **Distribuir para usuários** | Alterna a atribuição entre os usuários escolhidos. |
| **Em caso de duplicidade atribuir usuário no cadastro existente** | Atualiza o responsável quando a importação encontrar um cadastro já existente. |
| **Setar origem do lead** | Aplica uma origem comum aos leads importados. |
| **Adicionar tags** | Marca leads, contatos ou empresas para segmentação, filtros e relatórios. |
| **Em caso de duplicidade adicionar tags no cadastro existente** | Mantém a classificação mesmo quando o registro não é criado de novo. |

Para listas comerciais, normalmente faz sentido definir **Funil**, **Etapa**, **Origem** e **Tags**. Isso permite medir a performance da lista em relatórios e encontrar rapidamente os registros importados.

## Processar a importação

Depois de mapear os campos e revisar as configurações, clique em **Processar Importação**. A tela de resultado mostra o andamento e, ao finalizar, exibe os totais processados.

![Resultado da importação com totais de linhas, processados, criados, alterados e ignorados](/docs/screenshots/importacao-leads-resultado-processamento.png)

Os principais indicadores são:

| Indicador | O que significa |
| --- | --- |
| **Linhas no CSV** | Total de linhas consideradas no arquivo, descontando o cabeçalho quando configurado. |
| **Processados** | Quantidade de linhas já tratadas pela importação. |
| **Criados** | Novos leads, contatos ou empresas criados a partir do CSV. |
| **Alterados** | Registros existentes que foram atualizados por regra de duplicidade. |
| **Ignorados** | Linhas sem dados suficientes, duplicadas na planilha ou não aproveitadas. |
| **Adicionados em Lista** | Registros adicionados a uma lista de transmissão, quando essa opção foi configurada. |

Se houver registros ignorados, a tela exibe uma seção com o motivo e os valores mapeados. O detalhamento fica disponível por tempo limitado, então revise os erros logo após a importação.

## O que conferir depois

Após concluir a importação:

1. Abra o quadro de oportunidades em [https://my.agilize.app/crm/board/](https://my.agilize.app/crm/board/).
   Acesso pela tela: sidebar lateral > módulo **CRM/Hub** > **Oportunidades**.
2. Selecione o funil usado na importação.
3. Confira se os cards entraram na etapa correta.
4. Filtre por tag, origem ou responsável para validar o lote.
5. Abra alguns leads e revise telefone, e-mail, empresa, valor e observação.
6. Se a lista foi distribuída, confirme se os responsáveis ficaram equilibrados.
7. Acompanhe conversão e produtividade em [Relatórios e BI](/docs/usuarios/relatorios-bi).

## Excluir uma importação

Quando a importação estiver concluída, a tela pode exibir a opção **Excluir importação**. Essa ação remove os registros criados por aquela importação e é irreversível.

Regras práticas:

- a exclusão só fica disponível para o usuário que realizou a importação;
- a importação só pode ser excluída dentro do prazo permitido pela plataforma;
- a opção pode remover também tarefas e linha do tempo criadas depois, quando selecionada;
- antes de excluir, confirme se os registros não foram usados em atendimento, automação, campanha ou relatório.

Use a exclusão para corrigir importações de teste ou lotes enviados com mapeamento errado. Para ajustes pequenos, pode ser melhor corrigir os registros manualmente.

## Problemas comuns

| Situação | Causa provável | Como resolver |
| --- | --- | --- |
| As colunas aparecem quebradas | Separador incorreto. | Volte ao upload e selecione o separador correto: vírgula ou ponto e vírgula. |
| O lead foi criado sem telefone | Coluna não mapeada ou telefone em formato inconsistente. | Confira o campo **Telefone (Lead / Negócio)** e use DDI no CSV. |
| A importação exige funil e etapa | O arquivo está gerando oportunidades. | Selecione o funil e a etapa inicial antes de processar. |
| Muitos registros foram ignorados | Linhas vazias, duplicadas ou sem campos mapeados. | Revise os registros ignorados e corrija o CSV. |
| Registros ficaram sem origem | Origem não foi definida na configuração adicional. | Use **Setar origem do lead** para listas de campanha ou prospecção. |
| O gestor não vê todos os leads importados | Escopo de dados, responsável ou equipe organizacional limitando a visualização. | Revise permissões, equipe organizacional, supervisores e a flag **Registros próprios**. |

## Próximo passo

Depois de importar, revise [Qualidade de dados e prevenção de duplicidade](/docs/configuracao/crm-dados/qualidade-dados-prevencao-duplicidade) e acompanhe os resultados em [Relatórios e indicadores](/docs/usuarios/relatorios-bi/relatorios-e-indicadores).