> ## Documentation Index
> Fetch the complete documentation index at: https://doc.omnitechsolucoes.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Importação de Leads

> Importe leads para a OmniTech a partir de arquivos CSV ou Excel com validação automática, mapeamento de colunas e tratamento de erros e duplicidades.

Importe grandes volumes de leads usando arquivos CSV ou Excel, com **validação automática**, **processamento em segundo plano** e **relatórios detalhados de erro**.

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

O sistema de importação suporta:

* **Arquivos CSV e Excel** (.csv, .xlsx, .xls)
* **Processamento em background** para arquivos grandes
* **Validação automática** com relatórios de erro
* **Contatos secundários** no mesmo arquivo
* **Mapeamento de variáveis** conforme o assistente configurado

## Preparando o Arquivo de Importação

### Colunas Obrigatórias

Seu arquivo deve conter:

* **phone\_number:** Número de telefone principal (obrigatório)
* **Variáveis:** Colunas que correspondem às [variáveis configuradas do assistente](/ai-assistants/settings/prompt-and-tools#call-variables)

### Colunas Opcionais

* **Contatos secundários:** Números adicionais
* **Sobrescrita de variáveis:** Valores personalizados por lead

### Exemplo de Formato do 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 da Campanha
Escolher a Campanha de Destino
Selecione a campanha no momento da importação

Variáveis do assistente definem automaticamente as colunas esperadas

Herança de variáveis: Valores padrão do assistente aplicados a todos os leads

Mapeamento de Variáveis
As variáveis do assistente viram os cabeçalhos do arquivo

Valores padrão podem ser sobrescritos por lead

Flexibilidade para personalização individual

<Note> **Baixar arquivo de exemplo:** O modal de importação disponibiliza um CSV modelo com os cabeçalhos corretos conforme a campanha selecionada. </Note>
Etapas da Importação

1. Iniciar a Importação
   Acesse a seção Leads ou a aba de leads da campanha

Clique em "Importar Leads"

Selecione a campanha

Baixe o arquivo modelo para validar o formato

2. Enviar o Arquivo
   Escolha o arquivo: CSV ou Excel

Ignorar erros (opcional): Pular linhas inválidas

Revisar configurações

Clique em "Importar agora"

3. Processamento em Segundo Plano
   Fila automática para arquivos grandes

Acompanhamento de progresso

Notificação por e-mail ao concluir

Relatório de erros disponível para download

Regras de Validação
Validação de Número de Telefone
Formato: Internacional recomendado (+1234567890)

Detecção de duplicados

Números inválidos são sinalizados e ignorados

Validação de Variáveis
Campos obrigatórios: Devem conter valor

Tipos de dados: Texto, número, booleano

Limites de tamanho respeitados

Validação de Contatos Secundários
Mesmo padrão de validação do número principal

Números únicos (não podem repetir o principal)

Variáveis avaliadas de forma independente

Tratamento de Erros
Ignorar Linhas Inválidas
Quando habilitado:

Linhas válidas são importadas

Linhas inválidas são descartadas

Relatório detalhado é gerado

Importação parcial é concluída com sucesso

Erros Comuns
Número de telefone inválido

Campos obrigatórios ausentes

Número duplicado

Arquivo corrompido ou formato não suportado

Relatório de Erros
Link de download ao final da importação

Descrição detalhada por linha

Orientações de correção

Possibilidade de reimportar os dados corrigidos

Importação de Contatos Secundários
Múltiplos Números por Lead
phone\_number,customer\_name,secondary\_phone\_1,secondary\_phone\_2,secondary\_phone\_3
+14155551234,John Smith,+14155551235,+14155551236,+14155551237
Variáveis para Contatos Secundários
phone\_number,customer\_name,secondary\_phone\_1,secondary\_1\_name,secondary\_1\_role
+14155551234,John Smith,+14155551235,Jane Smith,Decision Maker
Ordem de Contato
Contato principal: sempre chamado primeiro

Secundários: na ordem das colunas

Coordenação da campanha: respeita as regras de retry

Arquivos Grandes
Processamento em Background
Arquivos acima de 1000 linhas entram em fila

Processamento eficiente (streaming)

Sem impacto na performance da plataforma

Notificações
E-mail ao finalizar

Resumo de sucesso e erros

Links para relatórios

Tempo Estimado
\< 100 linhas: até 1 minuto

100–1000 linhas: 2–5 minutos

1000+ linhas: 10–30 minutos

10k+ linhas: pode levar horas

Boas Práticas
Use o arquivo modelo

Padronize números no formato internacional

Limpe dados antes da importação

Teste com pequenos lotes

Garanta alinhamento das variáveis com o assistente

<Note> Para problemas comuns, veja [Solução de Problemas de Leads](/troubleshooting/leads). </Note> <Note> Para gerenciar leads importados, consulte [Gerenciamento de Leads](/leads/managing-leads). </Note> \`\`\`