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

# Problemas de Leads

> Resolva problemas comuns de gerenciamento de leads e problemas de importação

Soluções rápidas para problemas comuns de gerenciamento de leads e questões de importação.

## Problemas de Importação de Leads

### Importação Falha Completamente

**Erro:** "Importação falhou" ou "Formato de arquivo não suportado"

**Soluções:**

1. **Verifique o formato do arquivo:** Use apenas arquivos CSV ou Excel
2. **Verifique a seleção da campanha:** Garanta que uma campanha esteja selecionada para importação
3. **Limites de tamanho de arquivo:** Mantenha arquivos abaixo de 10MB para desempenho ideal
4. **Problemas de codificação:** Salve CSV com codificação UTF-8

### Nenhum Lead Importado

**Problema:** Importação completa mas nenhum lead aparece

**Soluções:**

1. **Cabeçalhos de colunas:** Verifique se os cabeçalhos correspondem ao formato exigido (phone, name, etc.)
2. **Validação de dados:** Verifique se os números de telefone estão no formato correto
3. **Linhas vazias:** Remova linhas vazias do arquivo
4. **Campos obrigatórios:** Garanta que a coluna de número de telefone contenha dados válidos

### Sucesso de Importação Parcial

**Problema:** Alguns leads importados, outros falharam

**Soluções:**

1. **Baixe o relatório de erros:** Verifique as linhas com falha para problemas específicos
2. **Formato de número de telefone:** Garanta formato internacional (+1234567890)
3. **Detecção de duplicatas:** Remova números de telefone duplicados
4. **Dados inválidos:** Corrija números de telefone malformados ou dados obrigatórios ausentes

### Atrasos de Processamento

**Problema:** Importação aparece como processando por tempo prolongado

**Explicação:**

* Arquivos grandes são processados em segundo plano
* Tempo de processamento aumenta com o tamanho do arquivo
* Sistema enfileira múltiplas importações

**Soluções:**

1. **Aguarde a conclusão:** Verifique notificações para atualizações
2. **Divida arquivos grandes:** Separe em lotes menores (500-1000 leads)
3. **Entre em contato com o suporte:** Se o processamento exceder 30 minutos

## Problemas de Gerenciamento de Leads

### Lead Não Aparece na Campanha

**Problema:** Lead importado não aparece na campanha

**Verifique:**

* Status do lead (deve ser "Criado" ou "Agendado")
* Filtros da campanha ou configurações de pesquisa
* Lead marcado como concluído acidentalmente

**Soluções:**

1. **Redefina o status do lead:** Altere o status para "Criado" para recolocar na fila
2. **Verifique a atribuição da campanha:** Verifique se o lead está atribuído à campanha correta
3. **Atualize a interface:** Recarregue a página da campanha

### Números de Telefone Inválidos

**Problema:** Números de telefone rejeitados durante a importação

**Formatos comuns:**

* **Correto:** +1234567890 (formato internacional)
* **Incorreto:** (123) 456-7890, 123-456-7890, 1234567890

**Soluções:**

1. **Padronize o formato:** Converta todos os números para o formato +1234567890
2. **Remova formatação:** Remova espaços, parênteses, traços
3. **Códigos de país:** Adicione o prefixo de código de país apropriado
4. **Ferramentas de validação:** Use validação de telefone antes da importação

### Leads Duplicados

**Problema:** Mesma pessoa aparece várias vezes

**Prevenção:**

1. **Limpeza de dados:** Remova duplicatas antes da importação
2. **Validação de telefone:** Verifique variações de formato do mesmo número
3. **Correspondência de nomes:** Identifique duplicatas potenciais por nome + telefone
4. **Deduplicação de leads:** Use ferramentas para identificar entradas similares

### Contatos Secundários Não Funcionam

**Problema:** Contatos secundários não estão sendo chamados

**Requisitos:**

* Contato secundário deve ter número de telefone válido
* Contato primário deve atingir tentativas máximas primeiro
* Campanha deve estar configurada para contatos secundários

**Soluções:**

1. **Verifique a configuração:** Verifique configuração de contato secundário
2. **Status do lead:** Garanta que o contato primário foi tentado
3. **Configurações da campanha:** Confirme que a chamada de contato secundário está habilitada

## Problemas de Variáveis e Dados

### Erros de Mapeamento de Variáveis

**Problema:** Variáveis personalizadas não importando corretamente

**Soluções:**

1. **Cabeçalhos de colunas:** Corresponda exatamente com [configuração do assistente](/ai-assistants/settings/prompt-and-tools#call-variables)
2. **Tipos de dados:** Garanta que os dados correspondam aos tipos de variáveis esperados
3. **Variáveis obrigatórias:** Inclua todas as variáveis definidas no assistente
4. **Valores padrão:** Verifique se valores padrão estão sendo aplicados

### Informações de Lead Ausentes

**Problema:** Leads sem nomes, emails ou dados personalizados

**Soluções:**

1. **Mapeamento de colunas:** Verifique se todas as colunas estão mapeadas corretamente
2. **Campos opcionais:** Confirme que campos opcionais estão incluídos na importação
3. **Validação de dados:** Verifique a completude dos dados de origem
4. **Re-importar:** Adicione dados ausentes e re-importe se necessário

## Problemas de Integração de Campanha

### Problemas de Status de Lead

**Problema:** Leads presos no status errado

**Significados de status:**

* **Criado:** Pronto para ser chamado
* **Agendado:** Na fila para próxima tentativa
* **Processando:** Sendo chamado atualmente
* **Concluído:** Finalizado ou meta alcançada
* **Tentativas Máximas:** Atingiu limite de tentativas

**Soluções:**

1. **Alteração manual de status:** Atualize o status na tabela de leads
2. **Reinício da campanha:** Pause e reinicie a campanha se necessário
3. **Configurações de tentativa:** Ajuste tentativas máximas ou intervalos

### Problemas de Herança de Variáveis

**Problema:** Variáveis de lead não funcionando nas chamadas

**Soluções:**

1. **Configuração do assistente:** Verifique variáveis definidas nas [configurações do assistente](/ai-assistants/settings/prompt-and-tools#call-variables)
2. **Nomes de variáveis:** Garanta correspondência exata entre dados de lead e variáveis do assistente
3. **Formato de dados:** Verifique se os dados da variável estão no formato esperado
4. **Chamadas de teste:** Use chamadas de teste manuais para verificar passagem de variáveis

## Problemas de Formato de Arquivo

### Problemas de CSV

**Problemas comuns:**

* Delimitador errado (use vírgula, não ponto e vírgula)
* Cabeçalhos ausentes na primeira linha
* Campos entre aspas com aspas não escapadas
* Codificação mista (use UTF-8)

**Soluções:**

1. **Formato padrão:** Use valores separados por vírgula
2. **Cabeçalhos obrigatórios:** Primeira linha deve conter nomes de colunas
3. **Qualificação de texto:** Use aspas duplas para campos de texto
4. **Codificação:** Salve como CSV codificado em UTF-8

### Problemas de Excel

**Problemas comuns:**

* Múltiplas planilhas (apenas primeira planilha importada)
* Células mescladas causando desalinhamento de dados
* Fórmulas em vez de valores
* Caracteres ocultos ou formatação

**Soluções:**

1. **Planilha única:** Use apenas a primeira planilha
2. **Desmesclar células:** Separe células mescladas
3. **Apenas valores:** Converta fórmulas em valores
4. **Formato limpo:** Remova formatação especial

## Obtendo Ajuda

### Antes de Entrar em Contato com o Suporte

1. **Baixe o relatório de erros:** Revise mensagens de erro específicas
2. **Verifique o formato do arquivo:** Verifique conformidade com formato CSV/Excel
3. **Teste lote pequeno:** Tente importar 5-10 leads primeiro
4. **Revise a documentação:** Verifique requisitos de importação

### Informações a Fornecer

* Mensagens de erro recebidas
* Amostra do arquivo de importação (com dados sensíveis removidos)
* Configurações e requisitos da campanha
* Comportamento esperado vs. real
* Configuração de variáveis do assistente

<Warning>
  **Privacidade de dados:** Remova informações sensíveis de arquivos de amostra antes de compartilhar com o suporte.
</Warning>

<Note>
  Para melhores práticas de gerenciamento de leads, veja [Gerenciando Leads](/leads/managing-leads) e [Configuração de Campanha](/campaigns/creating-campaigns).
</Note>