> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.leavo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar leads em massa

> Adicione vários leads de uma só vez a partir de um arquivo CSV.

A importação em massa permite adicionar vários leads de uma só vez a partir de um arquivo CSV. Clique em **+ Novo Lead** no canto superior direito e selecione **Importar Leads em Massa**.

🎥 **Prefere assistir?** Veja o tutorial em vídeo:

<iframe className="w-full aspect-video rounded-xl border border-gray-200 dark:border-gray-800" src="https://www.tella.tv/video/aprenda-a-importar-leads-em-massa-na-plataforma-leavo-6rs7/embed" allowFullScreen />

***

## Como importar

### 1. Prepare o arquivo CSV

O arquivo deve conter as seguintes colunas:

| Coluna | Descrição |
| - | - |
| nome | Primeiro nome do lead |
| sobrenome | Sobrenome do lead |
| telefone | Número de telefone |
| email | E-mail do lead |
| empresa | Nome da empresa |
| tags | Etiquetas do lead — separe múltiplas tags com `\|` (ex: `Cliente\|Comprou`) |

<Tip>
  Clique em **Baixar modelo** dentro do modal para baixar uma planilha CSV já com todas as colunas corretas e prontas para preencher.
</Tip>

<img src="https://mintcdn.com/leavo/5YcW-d8CgnvG8x9T/images/image-169.png?fit=max&auto=format&n=5YcW-d8CgnvG8x9T&q=85&s=605ae742cbd3b96651ac7bbe4f63a699" alt="Image" title="Image" style={{ width:"90%" }} width="1133" height="153" data-path="images/image-169.png" />

### 2. Faça o upload

Arraste o arquivo CSV para a área indicada ou clique em **clique para selecionar** e escolha o arquivo. O tamanho máximo é de **10 MB** e somente arquivos `.csv` são aceitos.

<img src="https://mintcdn.com/leavo/5YcW-d8CgnvG8x9T/images/image-170.png?fit=max&auto=format&n=5YcW-d8CgnvG8x9T&q=85&s=75ae6d5c51635ca8eab40ac314b9e9bd" alt="Image" title="Image" style={{ width:"90%" }} width="597" height="425" data-path="images/image-170.png" />

### 3. Mapeie as colunas

Após clicar em **Próximo**, a tela **Mapear Colunas do CSV** é exibida. Aqui você configura como os dados do seu arquivo serão interpretados:

**País para DDI** Selecione o código do país (padrão: Brasil +55). Ele será aplicado automaticamente aos telefones importados que não tiverem DDI.

**Departamento** Selecione o departamento que será atribuído a todos os leads importados. Ele é vinculado ao canal quando o lead receber a primeira mensagem.

**Preview dos dados** A plataforma exibe uma prévia com as primeiras 3 linhas do seu CSV para que você possa conferir se os dados estão corretos antes de continuar.

**Mapeamento de campos** Para cada campo da Leavo (Nome, Sobrenome, Telefone, E-mail, Empresa, Tags), há dois dropdowns:

1. **Tipo de origem** — escolha como o dado virá do CSV:
   * **Não mapear** — o campo não será preenchido (ou receberá `-` por padrão).
   * **Campo padrão** — vincula a um campo padrão do CSV. Ao selecionar esta opção, um segundo dropdown **Escolha o campo** é exibido com as opções: Nome, Sobrenome, Telefone, E-mail, Empresa.
   * **Tags** — mapeia a coluna do CSV para as tags do lead.
   * **Campo personalizado** — vincula a um campo personalizado configurado na conta.
2. **Escolha o campo** — aparece somente quando "Campo padrão" é selecionado. Selecione qual coluna do seu CSV corresponde ao campo da Leavo.

**Avisos de validação** exibidos na parte inferior da tela:

* Se o campo **Nome** não for mapeado → será preenchido com `-` por padrão.
* Se nenhum campo de contato (**Telefone** ou **E-mail**) for mapeado → a importação é bloqueada, pois ao menos um é obrigatório.
* Linhas do CSV sem telefone ou e-mail válido serão ignoradas na importação.

<img src="https://mintcdn.com/leavo/5YcW-d8CgnvG8x9T/images/image-171.png?fit=max&auto=format&n=5YcW-d8CgnvG8x9T&q=85&s=8531593832132049fa83d383ee0da6f1" alt="Image" title="Image" style={{ width:"90%" }} width="645" height="828" data-path="images/image-171.png" />

### 4. Conclua a importação

Clique em **Importar Leads** para finalizar. Os leads aparecerão na lista com o status padrão da conta.

<img src="https://mintcdn.com/leavo/5YcW-d8CgnvG8x9T/images/image-172.png?fit=max&auto=format&n=5YcW-d8CgnvG8x9T&q=85&s=e60989df4b14890f1b66045f55da93cc" alt="Image" title="Image" style={{ width:"90%" }} width="643" height="826" data-path="images/image-172.png" />

## Dicas

* Certifique-se de que os números de telefone estão com o código do país (ex: `+5511999990000`).
* Use o botão **Baixar modelo** no primeiro passo para garantir que as colunas do seu CSV já estejam no formato correto.
* Após a importação, os leads aparecerão na lista com o status padrão da conta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.