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

# Importando Leads

> Importe leads de arquivos CSV e Excel com validação e tratamento de erros Import leads from CSV and Excel files with validation and error handling

Importe grandes quantidades de leads de arquivos CSV ou Excel com **validação automática**, **processamento em segundo plano** e **relatórios de erros completos**.

## Visão Geral do Processo de Importação

O sistema de importação de leads oferece suporte a:

* Arquivos **CSV** e **Excel** (.csv, .xlsx, .xls)
* **Processamento em segundo plano** para arquivos grandes
* **Validação automática** com relatórios de erros
* **Contatos secundários** no mesmo arquivo de importação
* **Mapeamento de variáveis** com base na configuração do assistente

## Preparando Seu Arquivo de Importação

## Colunas Obrigatórias

Seu arquivo de importação deve incluir:

* **phone\_number:** número de telefone principal do contato (**obrigatório**)
* **Variáveis:** colunas correspondentes às variáveis configuradas no seu assistente

## Colunas Opcionais

* **Contatos secundários:** números de telefone adicionais
* **Substituições de variáveis:** valores personalizados para leads específicos

## Exemplo de Formato de Arquivo

```csv theme={null}
phone_number,customer_name,company,budget_range,secondary_phone_1,secondary_phone_2
+14155551234,John Smith,ABC Corp,10k-50k,+14155551235,+14155551236
+14155557890,Jane Doe,XYZ Inc,50k-100k,+14155557891,
+14155554567,Bob Johnson,Tech Start,5k-10k,,
```

## Seleção de Campanha

### Escolher Campanha de Destino

* Selecione a campanha no menu suspenso durante a importação
* As variáveis do assistente determinam automaticamente as colunas esperadas
* A **herança de variáveis** aplica os valores padrão do assistente a todos os leads importados

### Mapeamento de Variáveis

* As variáveis do assistente se tornam os **nomes das colunas** no arquivo de exemplo
* Utiliza os **valores padrão** da configuração do assistente
* Permite **substituir valores** com informações personalizadas por lead

<Note>
  **Baixar arquivo de exemplo:** a janela de importação fornece um **arquivo CSV de exemplo** com os cabeçalhos corretos, baseados nas variáveis do assistente da campanha selecionada.
</Note>

## **Etapas de Importação**

### 1. Iniciar o Processo de Importação

1. Acesse a seção **Leads** ou a aba **Leads da Campanha**
2. Clique em **"Import Leads"**
3. Selecione a campanha para atribuição dos leads
4. Baixe o **arquivo de exemplo** para verificar o formato esperado

### 2. Enviar o Arquivo

1. **Escolher arquivo:** selecione seu arquivo **CSV** ou **Excel**
2. **Opção “Ignorar erros”:** ative para pular linhas inválidas
3. **Revisar configurações:** confirme a campanha e as opções
4. **Iniciar importação:** clique em **"Import now"** para começar

### **3. Processamento em Segundo Plano**

* **Fila de processamento:** arquivos grandes são processados em segundo plano
* **Acompanhamento de progresso:** o status da importação é atualizado automaticamente
* **Notificação:** você receberá um e-mail quando a importação for concluída
* **Relatório de erros:** baixe o relatório com as linhas que falharam

***

### Regras de Validação

### Validação de Número de Telefone

* **Verificação de formato:** formato internacional preferido (**+1234567890**)
* **Detecção de duplicados:** impede números de telefone repetidos
* **Números inválidos:** sinalizados automaticamente e ignorados

### Validação de Variáveis

* **Campos obrigatórios:** variáveis marcadas como obrigatórias devem conter valores
* **Tipos de dados:** validação de texto, número e booleano, quando aplicável
* **Limite de comprimento:** limites máximos de caracteres são aplicados

### Validação de Contatos Secundários

* **Formato do telefone:** mesma validação dos números principais
* **Números únicos:** contatos secundários devem ser diferentes do principal
* **Consistência de variáveis:** variáveis de contatos secundários são validadas separadamente

***

### Tratamento de Erros

### Ignorar Linhas Inválidas

Quando a opção **“Ignore errors”** estiver ativada:

* **Linhas válidas importadas:** leads validados com sucesso são adicionados
* **Linhas inválidas ignoradas:** registros com erros são excluídos da importação
* **Relatório de erros gerado:** permite baixar um relatório detalhado das linhas com falha
* **Sucesso parcial:** a importação é concluída com o subconjunto válido

### Erros Comuns de Validação

* **Números de telefone inválidos:** formato incorreto ou números impossíveis
* **Campos obrigatórios ausentes:** valores vazios em variáveis obrigatórias
* **Números duplicados:** número já existente no sistema
* **Problemas de formato de arquivo:** arquivo corrompido ou formato não suportado

### Download do Relatório de Erros

Após a conclusão da importação:

* Um **link de download** será fornecido na notificação
* Inclui **descrições detalhadas dos erros** de cada linha com falha
* Fornece **orientações para correção** dos problemas
* Permite **nova importação** com os dados corrigidos

***

### Importação de Contatos Secundários

### Múltiplos Números por Lead

Inclua colunas adicionais para **contatos secundários**:

```csv theme={null}
phone_number,customer_name,secondary_phone_1,secondary_phone_2,secondary_phone_3
+14155551234,John Smith,+14155551235,+14155551236,+14155551237
```

### **Variáveis de Contato Secundário**

Adicione variáveis específicas para **contatos secundários**:

```csv theme={null}
phone_number,customer_name,secondary_phone_1,secondary_1_name,secondary_1_role
+14155551234,John Smith,+14155551235,Jane Smith,Decision Maker
```

### **Ordem de Contatos**

* **Contato principal:** sempre é chamado primeiro
* **Ordem secundária:** chamadas seguem a ordem das colunas (**secondary\_phone\_1**, depois **secondary\_phone\_2**, etc.)
* **Coordenação de campanha:** respeita as configurações de repetição (*retry settings*) entre os contatos

### **Manipulação de Arquivos Grandes**

### **Processamento em Segundo Plano**

* **Fila automática:** arquivos com mais de **1000 linhas** são processados em segundo plano
* **Eficiência de memória:** o processamento em fluxo (*streaming*) evita travamentos e *timeouts*
* **Acompanhamento de progresso:** o status da importação é atualizado em tempo real
* **Desempenho do sistema:** a importação não impacta o desempenho geral da plataforma

### **Sistema de Notificações**

* **Notificações por e-mail:** enviadas quando a importação é concluída
* **Resumo de sucesso:** quantidade de leads importados com êxito
* **Resumo de erros:** contagem e detalhes das linhas com falha
* **Links de download:** acesso aos relatórios de erros e dados importados

### **Tempo de Processamento**

* **Arquivos pequenos (\< 100 linhas):** geralmente concluídos em até **1 minuto**
* **Arquivos médios (100–1000 linhas):** levam de **2 a 5 minutos**, em média
* **Arquivos grandes (1000+ linhas):** de **10 a 30 minutos**, dependendo da complexidade
* **Arquivos muito grandes (10k+ linhas):** podem levar **várias horas**

### **Boas Práticas**

* **Use o arquivo de exemplo:** baixe o modelo fornecido para garantir o formato correto
* **Formato do telefone:** utilize o formato internacional sem separadores (**+1234567890**)
* **Limpeza de dados:** remova linhas vazias e valide o conteúdo antes de importar
* **Teste primeiro:** comece com um lote pequeno para verificar se o formato está correto
* **Correspondência de variáveis:** garanta que as colunas estejam alinhadas com as variáveis do assistente

<Note>
  Para obter **detalhes de solução de problemas** e **erros comuns de importação**, consulte **Leads Troubleshooting**.
</Note>

<Note>
  Para obter informações sobre como **gerenciar leads importados**, consulte **Managing Leads**.
</Note>