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

# Campanhas ativas

> Envie uma lista de contatos e deixe um agente trabalhar nela — com janelas de chamada, novas tentativas e progresso em tempo real.

As campanhas ligam para uma lista de contatos em seu nome: escolha um agente, envie um
CSV, defina quando as chamadas são permitidas, e o ThunderPhone percorre a lista
— tentando novamente chamadas sem resposta e caixas postais conforme a programação escolhida. Encontre-as em **Engajamento → Campanhas** (`/dashboard/campaigns`).

Para chamadas programáticas pontuais, use a
[API de chamadas de saída](/pt/guides/place-outbound-calls).

## Pré-requisitos

* Um agente de voz implantado.
* Um **número de telefone VoIP** conectado à sua organização para fazer chamadas —
  números de demonstração são apenas para chamadas recebidas e não podem realizar chamadas de campanha. Consulte
  [Conectar um provedor VoIP](/pt/guides/voip-providers).
* Contatos em um arquivo CSV (ou JSON colado) com uma coluna `phone` ou
  `phone_number`. **Até 5.000 linhas por envio**, codificadas em UTF-8.
  Quaisquer colunas adicionais são mantidas como variáveis por contato nos
  registros de contatos da campanha.

## Criar uma campanha

<Steps>
  <Step title="Clique em Nova campanha">
    Dê um nome, escolha o **agente de voz** e selecione o **número de origem**
    (um dos seus números VoIP).
  </Step>

  <Step title="Envie o CSV de contatos">
    Linhas com um número de telefone inválido são rejeitadas individualmente e
    informadas com seus números de linha — as demais são importadas normalmente.
  </Step>

  <Step title="Defina a janela de chamadas">
    Escolha um **fuso horário** e uma janela diária de **início/término**; a campanha
    só liga dentro dela. As janelas podem atravessar a meia-noite (por exemplo, 22:00 → 02:00).
    Opcionalmente, defina um **início em** para agendar o lançamento e um
    **término em** após o qual a campanha é concluída automaticamente.
  </Step>

  <Step title="Ajuste o ritmo e as novas tentativas">
    * **Chamadas simultâneas** — quantas chamadas esta campanha executa ao mesmo tempo
      (1–10, padrão 3). Sua organização também tem um limite de **10
      chamadas de saída simultâneas** no total, portanto campanhas
      paralelas compartilham esse limite.
    * **Máximo de tentativas** — quantas vezes cada contato pode receber uma ligação
      (padrão 2).
    * **Intervalo antes de nova tentativa (minutos)** — a espera antes de uma nova tentativa (padrão 60).
    * **Tentar novamente em** — quais resultados acionam uma nova tentativa: **sem resposta**,
      **caixa postal**, **falha** (todos ativados por padrão).
  </Step>

  <Step title="Crie o rascunho e depois inicie">
    As campanhas são criadas como rascunhos — contatos só podem ser adicionados enquanto uma
    campanha estiver como rascunho. Iniciar uma campanha exige consentimento explícito
    com os custos das chamadas. Com um **início em** futuro, ela fica
    *agendada*; caso contrário, começa a ser *executada* imediatamente.
  </Step>
</Steps>

## Como funcionam os resultados e as novas tentativas

Após cada chamada, o contato recebe um resultado — chamadas bem-sucedidas são
marcadas como concluídas; uma chamada classificada como sem resposta, detectada como caixa postal ou
com falha é tentada novamente se esse resultado estiver na sua lista de **tentar novamente em** e o
contato ainda tiver tentativas disponíveis. Contatos que esgotam as tentativas são marcados como
*esgotados*; falhas que não permitem nova tentativa são marcadas como *com falha*.

<Note>
  As ligações são pausadas automaticamente enquanto o saldo da sua conta não estiver em situação
  regular e são retomadas assim que estiver. Mantenha a
  [recarga automática](/pt/guides/billing-and-topups) ativada para campanhas longas.
</Note>

## Monitorar e controlar

Cada cartão de campanha mostra seu status e progresso (por exemplo, "173 de 248
concluídos"). Abra uma campanha para ver a divisão por status, os resultados por contato
e as chamadas recentes — cada uma tem um link para a transcrição completa e a
gravação no histórico de chamadas.

* **Pausar / retomar** — pausar interrompe novas ligações; chamadas já em
  andamento terminam normalmente. Campanhas pausadas podem ser editadas e retomadas.
* **Cancelar** — interrompe permanentemente a campanha.
* Uma campanha é concluída automaticamente quando todos os contatos alcançam um estado
  final ou o horário de **término em** passa.

Status de campanha: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Status de contato: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

## Próximas etapas

<CardGroup cols={2}>
  <Card title="Acompanhar chamadas ao vivo" icon="tower-broadcast" href="/pt/guides/monitor-live-calls">
    Ouça chamadas de campanha em tempo real.
  </Card>

  <Card title="API de chamadas de saída" icon="phone-arrow-up-right" href="/pt/guides/place-outbound-calls">
    Faça chamadas individuais programaticamente.
  </Card>
</CardGroup>