> ## 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.
# Problemas com Leads
> Resolva problemas comuns de gerenciamento e importação de leads
Soluções rápidas para problemas comuns de gerenciamento e importação de leads
## Problemas de Importação de Leads
**Falha Completa na Importação**\
**Erro:** “Import failed” ou “File format not supported”
**Soluções:**
* Verifique o **formato do arquivo:** use apenas arquivos CSV ou Excel
* Confirme a **seleção da campanha:** certifique-se de que uma campanha foi escolhida para a importação
* **Limite de tamanho:** mantenha os arquivos abaixo de **10MB** para melhor desempenho
* **Codificação:** salve o arquivo CSV com codificação **UTF-8**
***
**Nenhum Lead Importado**\
**Problema:** A importação é concluída, mas nenhum lead aparece
**Soluções:**
* **Cabeçalhos das colunas:** verifique se os cabeçalhos correspondem ao formato exigido (phone, name etc.)
* **Validação de dados:** confirme que os números de telefone estão no formato correto
* **Linhas vazias:** remova linhas vazias do arquivo
* **Campos obrigatórios:** garanta que a coluna de telefone contenha dados válidos
***
**Importação Parcial**\
**Problema:** Alguns leads foram importados, outros falharam
**Soluções:**
* **Baixe o relatório de erros:** verifique as linhas com falhas
* **Formato do número:** use o formato internacional (+5511999999999)
* **Detecção de duplicados:** remova números de telefone repetidos
* **Dados inválidos:** corrija números malformados ou campos obrigatórios ausentes
***
**Demora no Processamento**\
**Problema:** A importação fica em “processando” por muito tempo
**Explicação:**
* Arquivos grandes são processados em segundo plano
* O tempo aumenta conforme o tamanho do arquivo
* O sistema pode enfileirar várias importações
**Soluções:**
* Aguarde a conclusão e verifique as notificações
* Divida arquivos grandes em lotes menores (500–1000 leads)
* Contate 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:**
* O **status do lead** (deve ser “Created” ou “Scheduled”)
* Filtros e configurações de pesquisa da campanha
* Se o lead foi marcado como concluído por engano
**Soluções:**
* Redefina o status do lead para **“Created”**
* Verifique se o lead está atribuído à campanha correta
* Atualize a página da campanha
***
**Números de Telefone Inválidos**\
**Problema:** Números rejeitados durante a importação
**Formatos comuns:**
* **Correto:** +1234567890 (formato internacional)
* **Incorretos:** (123) 456-7890, 123-456-7890, 1234567890
**Soluções:**
* Padronize para o formato **+1234567890**
* Remova espaços, parênteses e traços
* Adicione o **código do país**
* Utilize ferramentas de validação antes da importação
***
**Leads Duplicados**\
**Problema:** Mesma pessoa aparece várias vezes
**Prevenção:**
* Faça **limpeza de dados** antes da importação
* Valide variações de formato de telefone
* Combine nome + telefone para identificar duplicidades
* Use ferramentas de **deduplicação de leads**
***
**Contatos Secundários Não Funcionam**\
**Problema:** Contatos secundários não estão sendo chamados
**Requisitos:**
* O contato secundário deve ter número válido
* O contato principal precisa atingir o limite máximo de tentativas
* A campanha deve estar configurada para chamar contatos secundários
**Soluções:**
* Verifique a configuração de contato secundário
* Confirme que o contato principal já foi tentado
* Certifique-se de que a campanha tem a função ativada
***
### Problemas de Variáveis e Dados
**Erro de Mapeamento de Variáveis**\
**Problema:** Variáveis personalizadas não estão sendo importadas corretamente
**Soluções:**
* Os cabeçalhos devem corresponder exatamente à configuração do assistente
* Verifique se os **tipos de dados** são compatíveis
* Inclua todas as variáveis obrigatórias definidas no assistente
* Verifique se os **valores padrão** estão sendo aplicados
***
**Informações de Leads Ausentes**\
**Problema:** Leads sem nome, e-mail ou dados personalizados
**Soluções:**
* Confirme o mapeamento correto de todas as colunas
* Inclua campos opcionais, se aplicável
* Verifique a integridade dos dados na origem
* Reimporte os dados após corrigir as informações ausentes
***
### Problemas de Integração com Campanhas
**Problemas de Status dos Leads**\
**Problema:** Leads presos no status incorreto
**Significado dos status:**
* **Created:** pronto para ser chamado
* **Scheduled:** na fila para próxima tentativa
* **Processing:** em chamada no momento
* **Completed:** finalizado ou objetivo alcançado
* **Max Retries:** limite de tentativas atingido
**Soluções:**
* Altere manualmente o status na tabela de leads
* Pause e reinicie a campanha, se necessário
* Ajuste o número máximo de tentativas ou intervalos
***
**Problemas de Herança de Variáveis**\
**Problema:** Variáveis dos leads não estão funcionando nas chamadas
**Soluções:**
* Verifique se as variáveis estão definidas nas configurações do assistente
* Confirme que os nomes correspondem exatamente entre os dados do lead e as variáveis do assistente
* Verifique se os dados seguem o formato esperado
* Faça **chamadas de teste** para validar a transmissão das variáveis
***
### Problemas de Formato de Arquivo
**Problemas com CSV**\
**Problemas Comuns:**
* Delimitador incorreto (use vírgula, não ponto e vírgula)
* Falta de cabeçalhos na primeira linha
* Campos com aspas não escapadas
* Codificação mista (use UTF-8)
**Soluções:**
* Use o formato **CSV separado por vírgulas**
* Inclua cabeçalhos na primeira linha
* Utilize **aspas duplas** para campos de texto
* Salve o arquivo com codificação **UTF-8**
***
**Problemas com Excel**\
**Problemas Comuns:**
* Múltiplas planilhas (somente a primeira é importada)
* Células mescladas desalinhando os dados
* Fórmulas em vez de valores
* Caracteres ocultos ou formatação especial
**Soluções:**
* Use apenas a **primeira planilha**
* **Desfaça células mescladas**
* Converta fórmulas em valores
* Limpe formatações e caracteres especiais
***
### Obtendo Ajuda
**Antes de Contatar o Suporte:**
* Baixe o **relatório de erros** e revise as mensagens específicas
* Verifique o formato do arquivo (CSV/Excel)
* Teste uma importação pequena (5–10 leads)
* Consulte a documentação de requisitos de importação
**Informações Úteis para o Suporte:**
* Mensagens de erro recebidas
* Amostra do arquivo de importação (sem dados sensíveis)
* Configurações e requisitos da campanha
* Comportamento esperado vs. comportamento observado
* Configuração das variáveis do assistente
Privacidade de Dados: Remova informações sensíveis dos arquivos de amostra antes de compartilhá-los com o suporte.
Para as melhores práticas de gerenciamento de leads, consulte **Gerenciamento de Leads** e **Configuração de Campanhas**.