Campanhas de saída

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.

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

1. Clique em Nova 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).

2. Envie o CSV de contatos

   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.

3. Defina a janela de chamadas

   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.

4. Ajuste o ritmo e as tentativas
   • 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 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.

5. Crie o rascunho e inicie

   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.

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.

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#