---
title: "Campanhas de saída"
description: "Envie uma lista de contatos e deixe um agente trabalhar nela — com janelas de chamada, tentativas e progresso em tempo real."
---
As campanhas discam 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 correios de voz na programação que você escolher. 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 habilitado para chamadas de saída. Os números VoIP do cliente continuam compatíveis com
campanhas. Os números do ThunderPhone começam somente para chamadas recebidas; um administrador da organização pode
solicitar chamadas de saída na página Números de telefone. O ThunderPhone analisa
cada solicitação manualmente, e números aprovados podem executar campanhas. Consulte
[Conecte um provedor de VoIP](/pt/guides/voip-providers).
- Contatos como um arquivo CSV (ou JSON colado) com uma coluna `phone` ou
`phone_number`. **Até 5.000 linhas por envio**, codificado em UTF-8.
Novos envios de JSON devem ser planos: valores extras podem ser strings, números,
booleanos ou `null`. Linhas que contêm arrays ou objetos aninhados são rejeitadas
individualmente com uma mensagem de validação; linhas válidas ainda são importadas. As células CSV
são strings. Colunas extras aceitas são mantidas como variáveis por contato nos
registros de contato da campanha e fornecidas automaticamente a cada discagem. O ThunderPhone também
classifica o prompt salvo do agente antes de cada chamada de saída para decidir se
o agente deve navegar por um menu telefônico. Cabeçalhos como `name` e `account_id`
correspondem a `{{name}}` e `{{account_id}}` no prompt salvo do agente. O mapeamento de nome também pode combinar colunas em `name`. Consulte
[variáveis por chamada](/pt/guides/call-variables) para ver valores padrão, regras de nomenclatura,
o limite de objeto de 32 KB e valores retornados em webhooks de conclusão.
Registros de contato mais antigos podem conter metadados aninhados de envios de JSON anteriores.
Esses metadados permanecem no contato armazenado. Cada discagem omite valores não escalares de
sua carga de variáveis e registra os nomes das chaves ignoradas para essa tentativa, sem
registrar valores. As novas tentativas usam a mesma filtragem.
## Criar uma campanha
Dê um nome, escolha o **agente de voz** e selecione o **número de origem**
(um dos seus números habilitados para chamadas de saída).
Linhas com um número de telefone inválido ou variáveis inválidas são rejeitadas individualmente e
informadas com seus números de linha — as demais são importadas normalmente.
Escolha um **fuso horário** e uma janela de **início/fim diário**; a campanha
só disca dentro dela. O fuso horário começa com base na zona do seu número de origem
(seu código de área nos EUA e no Canadá, seu país em outros locais) ou, para
números que abrangem várias zonas, como números gratuitos, no fuso do seu
navegador. A dica abaixo do campo informa qual deles é usado. Por padrão, a janela
é das 9h às 17h. Uma janela que começa antes das 8h ou termina após as 21h exibe um
aviso: chamadas fora desses horários podem violar regras de horário de chamadas, como
as da TCPA. Um fim anterior ao início atravessa a meia-noite: 22:00 →
02:00 disca das 22h até as 2h do dia seguinte, com um aviso. A
janela segue o fuso horário da campanha, não o de cada contato; portanto, separe os
contatos por fuso horário quando estiverem distribuídos.
Opcionalmente, defina um **início em** para agendar o lançamento e um
**fim em**, após o qual a campanha será concluída automaticamente.
- **Chamadas simultâneas** — quantas chamadas esta campanha executa ao mesmo tempo
(1–10, padrão 3). As campanhas não iniciam novas chamadas enquanto sua
organização tiver 10 chamadas de saída em andamento, portanto campanhas
paralelas compartilham esse limite. Cada chamada também conta para o
[limite de chamadas simultâneas](/api-reference/introduction#call-limits) da sua organização
(20 por padrão, entre chamadas de entrada, saída, web e teste).
Quando esse limite é atingido, ou quando o mesmo número foi chamado nos
últimos 10 segundos, o contato simplesmente aguarda uma tentativa posterior; suas
tentativas não são consumidas.
- **Máximo de tentativas** — quantas vezes cada contato pode ser chamado
(1–10, padrão 2).
- **Intervalo de nova tentativa (minutos)** — a espera antes de uma nova tentativa (pelo menos 30,
padrão 60).
- **Tentar novamente em** — quais resultados acionam uma nova tentativa: **sem resposta**,
**caixa postal**, **falha** (todos ativados por padrão).
Precisa de mais tentativas ou intervalos menores? Entre em contato com o suporte: a equipe pode
aumentar os dois limites para sua organização.
As campanhas são criadas como rascunhos — os contatos só podem ser adicionados enquanto uma
campanha estiver como rascunho. Iniciar uma campanha exige consentimento explícito
para as cobranças das chamadas. Com um **início em** futuro, ela fica
*agendada*; caso contrário, começa a *ser executada* imediatamente.
Campanhas salvas antes desses limites continuam sendo executadas exatamente como configuradas.
Suas tentativas e intervalos permanecem como foram salvos mesmo após outras edições.
## Como funcionam os resultados e as 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. Os contatos que esgotam as tentativas são marcados como
*esgotados*; falhas que não podem ser tentadas novamente são marcadas como
*com falha*.
A discagem é pausada automaticamente enquanto o saldo da sua conta não estiver em situação regular
e é retomada assim que estiver. Mantenha a
[recarga automática](/pt/guides/billing-and-topups) ativada em campanhas longas.
## 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 de status, os resultados por contato
e as chamadas recentes — cada uma leva à transcrição completa e à
gravação no histórico de chamadas.
- **Pausar / retomar** — pausar interrompe novas discagens; chamadas que já estão em
andamento terminam naturalmente. Campanhas pausadas podem ser editadas e retomadas.
- **Cancelar** — interrompe permanentemente a campanha.
- Uma campanha é concluída automaticamente quando todos os contatos chegam a um estado
final ou quando o horário de **terminar em** passa.
Status de campanha: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Status de contato: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Próximas etapas
Ouça as chamadas da campanha enquanto acontecem.
Faça chamadas individuais programaticamente.