Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kiraa.com.br/llms.txt

Use this file to discover all available pages before exploring further.

As Campanhas do Tropicall são omnichannel: você escolhe o canal certo para a sua ação e a plataforma envia em lote para uma lista de clientes do CRM — sempre com acompanhamento de status por destinatário. Acesse em Operação > Campanhas.

Canais suportados

Voz (Ligação)

Ligações automatizadas com um agente de IA usando um número conectado.

E-mail

Envio em massa via Gmail conectado em Plugins, usando um template de e-mail.

SMS

Disparo em massa via Twilio, usando um template de SMS com campos dinâmicos.

WhatsApp

Disparo em massa via WhatsApp (API não oficial), usando um template de WhatsApp.

Pré-requisitos por canal

CanalPré-requisitos
VozUm número ativo e um agente configurado
E-mailConexão Gmail ativa em Plugins e um template de e-mail
SMSConexão Twilio SMS ativa em Plugins e um template de SMS
WhatsAppPelo menos uma conexão WhatsApp em Plugins e um template de WhatsApp
Na escolha do canal, canais sem conexão aparecem desabilitados com a mensagem “Conecte o Gmail em Conexões”, “Conecte o Twilio em Conexões” ou “Conecte o WhatsApp em Conexões”.

Criando uma campanha

1

Clique em Nova Campanha

Na página Campanhas, clique no botão Nova Campanha.
2

Escolha o canal

Selecione Voz, E-mail, SMS ou WhatsApp no diálogo Nova Campanha.
3

Configure os detalhes

Siga o wizard específico do canal (veja abaixo).
4

Acompanhe o andamento

Ao concluir, você vai direto para a página de detalhes da campanha com estatísticas, filtros e ações.

Wizards por canal

Voz (Ligação)

Etapas: Configuração → Contatos → Agendamento
  1. Configuração — Nome, descrição, Número de Origem (da lista de números registrados) e Agente (ou Usar agente do número, quando o próprio número já tem um agente configurado).
  2. Contatos — busque clientes do CRM e marque quais telefones usar para cada cliente (checkboxes). A campanha tenta os telefones selecionados em ordem. Você pode criar um Novo Cliente direto daqui.
  3. Agendamento — defina janela de disparos, horários permitidos, duração máxima da chamada e regras de retry.

E-mail, SMS e WhatsApp (mensagens)

Etapas: Configuração → Template → Destinatários → Agendamento
  1. Configuração
    • Nome e descrição.
    • E-mail: confirma que o Gmail está conectado.
    • SMS: confirma que o Twilio está conectado.
    • WhatsApp: selecione a Integração WhatsApp (se você tiver mais de uma conectada).
  2. Template — escolha um template ativo do canal correspondente.
    • Se não houver, abra Templates e crie um primeiro.
    • A prévia aparece ao selecionar: assunto + corpo HTML (E-mail) ou texto/mídia (SMS e WhatsApp).
    • Se o template tiver variáveis, a lista de Variáveis necessárias aparece como {{chave}}.
  3. Destinatários — busque clientes do CRM e escolha os destinos:
    • E-mail: os e-mails cadastrados no cliente.
    • SMS e WhatsApp: os telefones cadastrados no cliente.
    • Todos os destinos são pré-marcados; expanda a linha para desmarcar destinos específicos.
    • Se faltar dado para preencher alguma variável, a plataforma avisa que esses clientes serão pulados (com contagem de variáveis faltantes).
  4. Agendamento — defina quando iniciar o envio e opções de ritmo/limite.
Templates com variáveis dependem de campos do cliente (ex: {{cliente_nome}}, {{cliente_cpf}}). Certifique-se de que as fichas estão preenchidas para evitar pulos. Veja o catálogo completo em Campos dinâmicos.

Página de detalhes

A página de uma campanha mostra, em todos os canais:
  • Badge de canal (Voz, E-mail, SMS ou WhatsApp) junto ao nome.
  • Progresso (Progresso: X de Y contatos) e barra de porcentagem.
  • Cards de estatísticas — Total, Na Fila, Enviadas/Concluídas, Finalizadas, Taxa de Sucesso (labels variam por canal).
  • Ações geraisPausar, Iniciar/Retomar, e Mais Ações (cancelar, excluir).

Diferenças por canal

TópicoVozMensagens (E-mail/SMS/WhatsApp)
Tabela principalContatosDestinatários
Coluna de destinoTelefoneE-mail (E-mail) ou Telefone (SMS/WhatsApp)
CabeçalhoMostra Agente e Número da campanhaFoca em estatísticas de envio
Mais AçõesInclui Adicionar Contatos e Exportar ResultadosSomente ações gerais (cancelar/excluir)

Status possíveis

Voz: Pendente, Na Fila, Em Chamada, Concluído, Não Atendeu, Ocupado, Caixa Postal, Falhou. Mensagens: Pendente, Na Fila, Enviando, Enviado, Entregue, Falhou, Limite Tentativas, Cancelado e Pulado (variáveis) — quando faltaram dados para preencher o template. Você pode filtrar por status, buscar por cliente, e acionar ações por linha:
  • Voz — tentar novamente, remover contato.
  • MensagensReenviar (quando permitido) e Remover destinatário.

Lista de campanhas

Na página principal Campanhas você tem:
  • Busca por nome, descrição ou agente (voz).
  • Filtro de status — Rascunho, Ativa, Pausada, Concluída, Cancelada.
  • Filtro de canal — Todos, Voz, E-mail, SMS, WhatsApp.
  • Badge de canal em cada linha.

Boas Práticas

Escolha o canal certo

Voz para decisões em tempo real; E-mail para conteúdo formal e rastreável; SMS para alertas curtos; WhatsApp para conversas casuais e confirmações.

Templates bem testados

Envie para si mesmo primeiro via ações no cliente antes de disparar em lote.

Fichas completas

Mantenha telefones, e-mails e campos customizados preenchidos para evitar destinatários pulados por variáveis.

Ritmo adequado

Em SMS e WhatsApp, velocidades muito altas aumentam risco de bloqueio. Use janelas de horário comercial e ritmo moderado.

Resolução de Problemas

ProblemaSolução
Canal aparece desabilitado no pickerConecte o provedor correspondente em Integrações > Plugins
Muitos destinatários “Pulados (variáveis)“Complete os campos do cliente que alimentam as variáveis do template
Ligações “Não Atendeu” em excessoAjuste janela de horários e tentativas na etapa Agendamento
WhatsApp falha em sequênciaVerifique se a conexão está Ativa em Plugins e reduza o ritmo de envio

Próximos Passos

Templates

Crie templates de e-mail, SMS, WhatsApp e documentos com campos dinâmicos

Plugins

Conecte Gmail, Twilio e WhatsApp para habilitar todos os canais

Clientes

Enriqueça a base para evitar destinatários pulados

Atividade

Acompanhe todos os envios da organização em um único painel