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

# Visão Geral das Campanhas

> Aprenda a criar e gerenciar campanhas de chamadas automatizadas para alcançar vários leads de forma eficiente. 

As **campanhas** permitem automatizar chamadas para vários leads usando o seu **assistente de IA**.\
Configure o **agendamento**, a **lógica de retentativa** e o **gerenciamento de leads** para executar operações de chamadas **de saída com eficiência**.

## O que é uma Campanha?

Uma **campanha** é um sistema automatizado que realiza chamadas para vários leads em seu nome, utilizando um **assistente de IA configurado**.\
Cada campanha inclui:

<CardGroup cols={2}>
  <Card title="Gerenciamento de Leads" icon="users">
    * **Contatos primários e secundários** para um alcance mais completo
    * **Importação de leads** via arquivo CSV, integrações ou adição manual
  </Card>

  <Card title="Controle de Agendamentos" icon="calendar">
    * **Restrições de horário e dia** para respeitar as preferências dos clientes
    * Defina os **horários permitidos** e os **dias da semana** para as chamadas
  </Card>

  <Card title="Lógica de Retentativa" icon="repeat">
    Sistema inteligente de **retentativa** para chamadas não atendidas

    Configure o número de **tentativas**, os **intervalos** e as **condições** de retentativa
  </Card>

  <Card title="Acompanhamento de Metas" icon="bullseye">
    Medição de sucesso com **variáveis de conclusão**

    Acompanhe os **objetivos da campanha** e a **conversão de leads**
  </Card>
</CardGroup>

## Status da Campanha

<AccordionGroup>
  <Accordion title="Rascunho" icon="file">
    A campanha está sendo configurada, mas ainda **não está ativa**.\
    Adicione **leads** e **configure as definições** antes de iniciar.
  </Accordion>

  <Accordion title="Em Progresso" icon="play">
    A campanha está **realizando chamadas ativamente** de acordo com o seu **agendamento** e as **configurações de retentativa**.
  </Accordion>

  <Accordion title="Pausa" icon="pause">
    A campanha está **temporariamente pausada**.\
    Pode ser **retomada** sem perda de progresso.
  </Accordion>

  <Accordion title="Concluída" icon="check">
    Todos os **leads foram contatados com sucesso** ou **marcados como concluídos**.
  </Accordion>
</AccordionGroup>

## Principais Recursos

#### Agendamento e Tempo

* **Horários permitidos para chamadas:** defina horários de início e término (ex.: 9h00 – 18h00)
* **Dias permitidos:** escolha dias específicos da semana para as chamadas
* **Suporte a fuso horário:** utiliza o fuso configurado do assistente
* **Validação da janela de chamadas:** o sistema respeita automaticamente as restrições de horário

***

#### Sistema de Retentativa

* **Máximo de tentativas:** 1 a 5 tentativas para chamadas não atendidas (padrão: 3)
* **Intervalo entre tentativas:** 10 a 4320 minutos entre as tentativas (padrão: 60 minutos)
* **Retentativa ao cair na caixa postal:** continua ligando até que uma pessoa atenda
* **Retentativa baseada em objetivo:** continua ligando até que o objetivo seja atingido (requer variáveis pós-chamada do tipo booleano)

***

#### Tipos de Leads

* **Leads primários:** contatos principais importados ou adicionados à campanha
* **Contatos secundários:** contatos adicionais vinculados aos leads primários
* **Acompanhamento de status dos leads:** monitore o progresso das chamadas e seus resultados

***

### Requisitos

Antes de iniciar uma campanha:

<Warning>
  **Número de Telefone Obrigatório:** Seu assistente deve ter um número de telefone configurado para chamadas de saída.
</Warning>

* **Assistente de IA configurado** com capacidade de chamadas de saída
* **Saldo suficiente** na conta para cobrir os custos das chamadas
* **Leads adicionados** à campanha (manualmente, via importação ou integração)
* **Números de telefone válidos** para todos os leads

***

### Início Rápido

* **Criar Campanha:** Escolha um nome e selecione seu assistente de IA
* **Definir Agendamento:** Configure os horários e dias permitidos para as chamadas
* **Configurar Retentativas:** Defina o número de tentativas e os intervalos entre elas
* **Adicionar Leads:** Importe via arquivo CSV ou adicione manualmente
* **Iniciar Campanha:** Clique em **Iniciar** quando estiver pronto para começar as chamadas

<Note>
  For detailed setup instructions, see [Creating a Campaign](/campaigns/creating-campaigns).
</Note>

## Monitoramento da Campanha

#### Acompanhamento do Status dos Leads

Monitore o progresso individual de cada lead durante a campanha:

* **Criado:** pronto para ser chamado
* **Agendado:** na fila para a próxima tentativa de chamada
* **Em processamento:** atualmente sendo chamado
* **Concluído:** contatado com sucesso ou objetivo alcançado
* **Reagendado:** programado para nova tentativa
* **Máx. de retentativas:** atingiu o número máximo de tentativas

**Gerenciamento manual de leads:** você pode alterar o status de um lead na tabela de leads:

* Definir como **“Criado”**: reinicia o lead para ser chamado novamente
* Definir como **“Concluído”**: marca o lead como finalizado para interromper as chamadas

***

### Resultados das Chamadas

Resultados individuais das chamadas com status detalhado:

* **Iniciada:** chamada foi iniciada
* **Tocando:** telefone está chamando
* **Em andamento:** chamada conectada e ativa
* **Concluída:** chamada finalizada com sucesso
* **Ocupado:** linha estava ocupada
* **Não atendida:** ninguém atendeu
* **Falha:** problema técnico impediu a chamada

***

### Solução de Problemas

**A campanha não inicia:**

* Verifique se o assistente tem um **número de telefone configurado**
* Confirme se há **saldo suficiente** na conta
* Certifique-se de que os **leads foram adicionados** à campanha

**Nenhuma chamada está sendo feita:**

* Aguarde **10 a 15 minutos** após iniciar — as campanhas levam um tempo para inicializar
* Verifique se o **horário atual está dentro do período permitido**
* Confirme se os **dias permitidos** incluem o dia atual
* Certifique-se de que os **números de telefone dos leads são válidos**

**Muitas/poucas retentativas:**

* Ajuste a configuração de **máximo de tentativas** (1 a 5)
* Modifique o **intervalo entre tentativas** (10 a 4320 minutos)
* Revise as **condições de retentativa** (caixa postal, conclusão de objetivo)

<Tip>
  **Boa Prática:** Comece com **configurações de retentativa conservadoras** e ajuste conforme o **desempenho da campanha** e o **feedback dos clientes**.
</Tip>

<Note>
  Para obter orientações detalhadas de solução de problemas, consulte **Resolução de Problemas de Campanhas**.
</Note>
