> ## 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 Campanhas

> Resolva problemas comuns de campanhas e otimize o desempenho 

Soluções rápidas para problemas comuns de campanhas e dicas de otimização de desempenho

## Campanha Não Inicia

**Número de Telefone Não Configurado**\
**Erro:** “Your agent does not have a phone number setup”

**Solução:**

* Vá até as **Configurações do Assistente**
* Configure um número de telefone (número da plataforma, SIP ou Caller ID)
* Salve as configurações do assistente
* Tente iniciar a campanha novamente

***

**Saldo Insuficiente**\
**Erro:** “Insufficient balance to start the campaign”

**Solução:**

* Verifique o saldo da conta na seção de **Faturamento**
* Adicione créditos à conta
* Retorne à campanha e clique em **Iniciar**

***

**Sem Leads para Ligar**\
**Erro:** “No leads to call”

**Solução:**

* Adicione leads manualmente ou importe via arquivo CSV
* Verifique se os leads possuem números de telefone válidos
* Confirme se os leads não estão todos marcados como concluídos
* Certifique-se de que a configuração “Marcar como concluída quando não houver leads” esteja de acordo com sua necessidade

***

### Nenhuma Chamada Sendo Realizada

**Fora do Horário Permitido**\
**Problema:** A campanha aparece como em execução, mas nenhuma chamada ocorre

**Verifique:**

* Se o horário atual está dentro do período permitido para chamadas
* Se o dia atual é um dia permitido
* Se o fuso horário do assistente corresponde ao cronograma esperado

**Solução:** Ajuste os horários permitidos ou aguarde a próxima janela de tempo válida

***

**Todos os Leads Já Foram Contatados**\
**Problema:** A campanha parece ociosa

**Verifique:**

* Se todos os leads principais já foram tentados o número máximo de vezes
* Se os contatos secundários foram tentados
* O status de conclusão do objetivo, se estiver usando repetição baseada em meta

**Solução:** Adicione mais leads ou revise as configurações de repetição

***

### Problemas de Qualidade de Chamada

**Alta Taxa de Falhas**\
**Sintomas:** Muitas chamadas marcadas como “Failed”

**Causas Comuns:**

* Números de telefone inválidos na lista de leads
* Problemas de conectividade de rede
* Restrições de operadoras

**Soluções:**

* Limpe os dados dos leads, removendo números inválidos
* Teste chamadas individuais manualmente
* Verifique o formato dos números (+5511999999999)
* Contate o suporte se o problema persistir

***

**Baixa Taxa de Respostas**\
**Sintomas:** A maioria das chamadas cai na caixa postal ou não é atendida

**Otimização:**

* Ajuste os horários de chamada (teste diferentes janelas)
* Revise o intervalo entre tentativas (aumente o espaçamento)
* Verifique a qualidade dos leads (números atualizados)
* Configure um **Caller ID** profissional

***

### Problemas na Lógica de Repetição

**Muitas Repetições**\
**Problema:** Leads reclamando de excesso de ligações

**Soluções:**

* Reduza o número máximo de tentativas (ex: de 5 para 2 ou 3)
* Aumente o intervalo entre tentativas (2–4 horas)
* Desative a repetição para caixa postal
* Revise as variáveis de meta para garantir rastreamento correto

***

**Poucas Repetições**\
**Problema:** Leads potenciais não sendo contatados o suficiente

**Soluções:**

* Aumente o número máximo de tentativas (até 5)
* Ative a repetição para caixa postal
* Ajuste os intervalos entre tentativas
* Use a repetição baseada em meta para leads de alto valor

***

### Problemas de Conclusão de Meta

**Variável de Meta Não Funciona**\
**Problema:** A repetição até atingir a meta não está funcionando

**Requisitos:**

* As variáveis pós-chamada devem estar configuradas no assistente
* A variável booleana deve existir no esquema pós-chamada
* O nome da variável deve corresponder exatamente ao das configurações da campanha
* A extração da IA deve estar funcionando corretamente

**Solução:** Teste a extração da variável pós-chamada do assistente com chamadas manuais

***

**Conclusão de Meta Incorreta**\
**Problema:** Leads marcados como concluídos incorretamente

**Depuração:**

* Revise as transcrições das chamadas para identificar erros de extração da IA
* Teste as definições das variáveis com chamadas de amostra
* Ajuste o prompt da IA para critérios de meta mais claros
* Refine as descrições das variáveis nas configurações do assistente

***

### Otimização de Desempenho

**Progresso Lento da Campanha**\
**Causas:**

* Intervalos de repetição muito longos
* Horários de chamada restritos
* Alta taxa de falhas reduzindo os leads disponíveis

**Soluções:**

* Use **processamento paralelo** com várias campanhas menores
* Otimize o horário de chamadas (horas de maior resposta)
* Limpe os dados removendo números problemáticos
* Amplie a janela de chamadas permitidas

***

**Problemas de Recursos do Sistema**\
**Sintomas:** Chamadas atrasadas ou gargalos de processamento

**Soluções:**

* Reduza o número de campanhas simultâneas
* Inicie campanhas em horários diferentes para evitar sobrecarga
* Contate o suporte para problemas de desempenho na plataforma

***

### Problemas de Gerenciamento de Leads

**Contatos Duplicados**\
**Problema:** Mesma pessoa recebendo várias ligações de leads diferentes

**Prevenção:**

* Faça limpeza de dados antes de importar
* Valide formatos de telefone
* Use ferramentas de deduplicação de leads

***

**Confusão em Contatos Secundários**\
**Problema:** Dificuldade para identificar qual contato foi atendido

**Solução:**

* Use nomes descritivos para contatos secundários
* Revise as transcrições das chamadas para identificar quem atendeu
* Organize os leads agrupando contatos relacionados

***

### Mensagens de Erro Comuns

* **“Campaign is already in progress”** → A campanha já está em execução. Pause antes de fazer alterações.
* **“Campaign is not running”** → A campanha está pausada ou parada. Inicie para retomar as chamadas.
* **“Assistant timezone not set”** → Configure o fuso horário nas configurações do assistente antes de criar a campanha.

***

### Obtendo Ajuda

**Antes de Contatar o Suporte:**

* Verifique as mensagens de erro exibidas
* Revise as configurações da campanha
* Teste com um lead individual para isolar o problema
* Confira o status da conta e do faturamento

**Informações Úteis para o Suporte:**

* ID e nome da campanha
* Mensagens de erro recebidas
* Etapas realizadas antes do problema
* Diferença entre o comportamento esperado e o observado
* Configuração do assistente e do número de telefone

<Warning>
  Atrasos em Campanhas: aguarde de **10 a 15 minutos** após iniciar antes de esperar que as chamadas comecem.\
  O sistema precisa de tempo para **inicializar e enfileirar os leads**.
</Warning>

<Note>
  Para obter ajuda adicional com a otimização de campanhas, consulte **Melhores Práticas de Campanha**.
</Note>
