> ## Documentation Index > Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Campanhas > Acompanhar o andamento de uma campanha, entender suas métricas e agir sobre ela Uma **campanha** é um envio: um arquivo de casos que o bot vai trabalhar, dentro de um horário e com uma configuração determinada. Esta tela é onde você acompanha esse envio enquanto ele acontece. ## Onde encontrá-las Há dois caminhos para chegar a uma campanha, conforme o que você precise: * **Monitoramento de campanhas** mostra em uma única tabela as campanhas de todos os seus bots. É a visão indicada quando você quer saber como está o dia. * **Bots → um bot → Campanhas** mostra apenas as campanhas daquele bot. As duas tabelas trazem a mesma informação, e a partir de qualquer uma delas você abre o detalhe de uma campanha. Detalhe de uma campanha: parâmetros, casos, métricas, telefones e progresso O detalhe de uma campanha reúne, na parte de cima, os parâmetros com os quais ela foi criada e os números de como está indo; embaixo, a lista dos seus casos. A tabela não se atualiza sozinha em tempo real: ela é atualizada a cada 60 segundos, e você também pode forçar isso com o botão de atualizar. *** ## Status de uma campanha | Status | O que significa | | ---------------- | ---------------------------------------------------- | | **Agendada** | Criada, com data de início futura. Ainda não discou. | | **Em andamento** | Está trabalhando os casos dentro do seu horário. | | **Pausada** | Parou de gerar novas chamadas. Pode ser retomada. | | **Encerrada** | Terminou. Não é reaberta. | ### Iniciar, pausar e finalizar No menu de ações de cada campanha você muda o status sem abrir o detalhe: | Ação | Disponível quando está… | O que faz | | ------------- | --------------------------------- | --------------------------------------- | | **Iniciar** | Pausada ou Agendada | Coloca em andamento. | | **Pausar** | Em andamento | Interrompe a geração de novas chamadas. | | **Finalizar** | Em andamento, Pausada ou Agendada | Encerra a campanha definitivamente. | **Pausar e finalizar não cancelam as chamadas que já estão em curso ou na fila.** Elas interrompem a geração de chamadas novas, então por alguns minutos você ainda vai ver atividade depois de pausar. Uma campanha encerrada **não pode ser reaberta**. Se precisar retomar o envio, é preciso criar uma campanha nova com os casos pendentes. Uma campanha também se encerra sozinha, sem que ninguém a finalize, quando chega a 100% de conclusão. Se você vir uma campanha Encerrada que ninguém encerrou, é por isso. *** ## As métricas de uma campanha O detalhe agrupa seus números em dois blocos: **Métricas**, com contatabilidade e taxa de sucesso, e **Progresso**, com as duas barras de andamento. Bloco de métricas com taxas de sucesso e contatabilidade ### Contatabilidade A porcentagem de casos da campanha com os quais o bot **conseguiu falar**. Um caso soma à contatabilidade quando houve conversa; um telefone que tocou sem ninguém atender, não. Em campanhas em andamento o valor é atualizado continuamente, com até um minuto de atraso. Em campanhas encerradas o valor final fica fixo. ### Taxa de sucesso A porcentagem de casos da campanha que terminaram em **promessa de pagamento**. É a métrica de resultado de negócio: não mede quantas chamadas deram certo, e sim quantos casos se comprometeram a pagar. Contatabilidade e taxa de sucesso respondem perguntas diferentes e não são comparáveis entre si: uma mede alcance — com quantos você falou — e a outra, resultado. É normal que uma seja alta e a outra baixa. ### As duas barras de andamento Em **Progresso** há duas barras que medem duas coisas diferentes do mesmo envio: | Barra | O que mede | | ------------------------------------ | -------------------------------------------------------------- | | **Casos com pelo menos uma chamada** | Casos que já receberam pelo menos uma tentativa de contato. | | **Casos concluídos** | Casos cujo tratamento terminou e não serão tentados novamente. | As duas barras de andamento de uma campanha em andamento Um caso entra na primeira barra assim que é chamado pela primeira vez. Só entra na segunda quando seu tratamento termina: porque deu um resultado final, porque esgotou suas retentativas, ou porque entrou em descanso. Por isso **a barra de chamadas fica sempre igual ou à frente** da de concluídos, e a distância entre as duas é a quantidade de casos em tratamento neste momento: já foram tentados, mas ainda podem receber outra chamada. Conforme a campanha avança, essa distância se abre e depois se fecha: primeiro todos são discados, e só então começam a ser concluídos. **Quando a campanha termina de tratar tudo, as duas barras marcam 100% e ficam iguais** — é o sinal de que não há nada pendente. Se a de chamadas chegar a 100% e a de concluídos ficar para trás por um tempo, é normal: não há mais casos sem tentar, mas alguns ainda admitem outra retentativa antes de encerrar. *** ## Os parâmetros da campanha Bloco de parâmetros de uma campanha ### Retentativas **O que é:** quantas vezes cada telefone é chamado antes de ser considerado esgotado. O limite é **por telefone, não por caso**. Com retentativas em `4`, cada número do caso pode receber até quatro chamadas — não o caso inteiro. Quantos números entram é definido por [Prioridade](#modo-de-discagem-e-prioridade). ### Modo de discagem e Prioridade Os dois andam juntos: o modo define **como** a campanha percorre os telefones de cada caso, e a prioridade define **quais**. Cada caso pode trazer vários telefones. A ordem não é casual: são as colunas que você definiu no [arquivo de entrada de campanha](/pt-BR/construccion/archivo-entrada-campana), e essa ordem é a de prioridade — o primeiro é o principal. A campanha percorre **vários telefones por caso**. A prioridade indica até qual: com `3`, usa os três primeiros e deixa o resto de fora. A campanha trabalha sobre **um único telefone**. A prioridade indica qual: com `2`, liga apenas para o segundo telefone de cada caso. No modo horizontal, o bot não liga para os telefones simultaneamente nem alterna entre eles: insiste no primeiro até esgotar suas retentativas, só então passa ao segundo, e assim por diante. O caso é considerado esgotado quando todos os telefones habilitados chegaram ao seu limite. No modo horizontal, prioridade e retentativas se multiplicam. Com **prioridade 3** e **retentativas 4**, um caso pode receber até **12 chamadas**: quatro para cada um dos três telefones. Antes de aumentar qualquer um dos dois valores, vale olhar o outro. Prioridade não é uma prioridade da campanha em relação a outras: não define qual é atendida primeiro se você tiver várias rodando, e sim quais telefones de cada caso entram em jogo. O modo vertical serve para envios cirúrgicos sobre um número específico — por exemplo, uma segunda rodada que ligue só para o telefone comercial. O horizontal é o usual quando você quer esgotar as vias de contato de cada caso. ### Início e horário A data de **início** define quando ela começa, e o **horário**, entre que horas do dia ela pode ligar, no fuso horário do bot. *** ## Os casos da campanha O bloco **Casos** informa o que aconteceu com os casos do arquivo: | | | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | **Totais** | Casos que entraram a partir do arquivo. | | **Filtrados** | Casos descartados ao processar o arquivo, por não cumprirem as validações que você configurou. | | **Descartado por descanso** | Casos que não foram tratados por terem um descanso vigente de uma campanha anterior. Veja [Regras de descanso](/pt-BR/operacion/reglas-descanso). | | **A tratar** | Os que efetivamente ficaram em jogo: totais menos filtrados e menos descartados por descanso. | Se uma campanha ligou para muito menos casos do que você carregou, a explicação está aqui: a diferença vai para filtrados e descartados por descanso. O ícone de download ao lado de **Descartado por descanso** baixa a lista desses casos, com uma linha por caso: o identificador, seus telefones, os códigos de dívida, o **motivo do descanso** —a etiqueta que o originou— e a **data de ativação**, ou seja, a partir de quando ele volta a ficar disponível para tratamento. Esse arquivo responde à pergunta caso a caso: por que este contato não foi chamado, e quando poderá ser. ## Os telefones da campanha O bloco **Telefones** faz o mesmo um nível abaixo, já que um caso pode trazer vários números: | | | | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Filtrado (Enacom)** | Telefones descartados pelo filtro do órgão regulador. São comparados com o cadastro oficial de atribuições de numeração, então caem os números que não existem ou cuja faixa não está atribuída a nenhuma operadora. | | **A tratar** | Os telefones que ficaram disponíveis para ligar. | O ícone de download ao lado dos filtrados permite baixar a lista dos telefones descartados, para conferi-los com a sua base de origem. Esse filtro só se aplica onde há um órgão regulador com cadastro público — na Argentina, a Enacom. Evita gastar tentativas em números que nunca iriam atender. *** ## Pela API Todos esses números estão disponíveis sem entrar na plataforma, em [Detalhe de uma campanha](/pt-BR/api-reference/campaigns/detail). Você também pode [mudar o status](/pt-BR/api-reference/campaigns/status) de uma campanha — iniciar, pausar ou finalizar — a partir do seu sistema.