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.

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:

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.

Ampliar

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.

Ampliar

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

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:

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.

Ampliar

Os principais indicadores são:

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/. 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.

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

Próximo passo

Depois de importar, revise Qualidade de dados e prevenção de duplicidade e acompanhe os resultados em Relatórios e indicadores.