Campanhas
O módulo de Campanhas permite enviar uma mensagem para centenas ou milhares de contatos de uma só vez, de forma programada. É ideal para promoções, avisos, confirmações de agendamento em lote e qualquer comunicação em massa.
Tela de campanhas
A tabela principal exibe todas as campanhas com as colunas:
| Coluna | O que mostra |
|---|---|
| Nome | Identificação interna da campanha. |
| Status | Estado atual da campanha (veja tabela de status abaixo). |
| Lista de Contatos | A lista ou tag usada como público alvo. |
| Conexão | O número de WhatsApp que enviará as mensagens. |
| Data Agendada | Quando o disparo está programado, ou "Sem agendamento" para disparo imediato. |
| Concluída em | Data e hora em que o envio foi concluído (somente campanhas finalizadas). |
| Ações | Botões de ação por linha (variam conforme o status). |
Filtros da tela
Cinco filtros combinados no topo da tabela:
| Filtro | O que faz |
|---|---|
| Nome da campanha | Busca por texto no nome da campanha. |
| Nome da lista | Filtra campanhas associadas a uma lista específica. |
| Data | Filtra por data de agendamento. |
| Conexão | Filtra por conexão WhatsApp usada no envio. |
| Status | Filtra pelo status da campanha. |
Clique em "Limpar" para remover todos os filtros de uma vez.
Criar uma campanha
- Nome — identificação interna (não aparece para o cliente).
- Lista de Contatos — selecione uma lista cadastrada em Listas de Contatos para definir o público. Deixe vazio se for usar segmentação por Tag.
- Tag — alternative à lista: segmenta o envio para todos os contatos que têm aquela tag (somente tags com ao menos 1 contato aparecem na lista). Defina Lista de Contatos OU Tag — pelo menos um é obrigatório.
- Conexão WhatsApp — número que irá enviar as mensagens.
- Data e hora — quando o disparo deve iniciar. Deixe vazio para iniciar imediatamente ao clicar em "Iniciar".
- Atendente (obrigatório) — busque pelo nome; o ticket aberto após o envio será atribuído a este atendente.
- Fila (obrigatório) — fila de destino do ticket.
- Status do ticket (obrigatório) — estado do ticket após o envio:
- Fechado — ticket encerrado automaticamente.
- Pendente — ticket aguardando resposta do cliente.
- Aberto — ticket em atendimento.
Para cada contato que receber a mensagem, um ticket é aberto automaticamente nesta fila e atribuído ao atendente selecionado.
Status das campanhas
| Status | Significado |
|---|---|
| Inativa | Criada mas ainda não foi iniciada. Ainda pode ser editada. |
| Programada | Agendada para disparar em uma data/hora futura (até 1 hora antes ainda pode ser editada). |
| Em Andamento | Enviando mensagens agora. |
| Cancelada | Pausada manualmente. Pode ser reiniciada. |
| Finalizada | Todos os envios foram processados. |
Ações por campanha
Os botões disponíveis em cada linha variam conforme o status:
| Botão | Quando aparece | O que faz |
|---|---|---|
| Pausar | Em Andamento | Cancela o envio. A campanha vai para status Cancelada. |
| Reiniciar | Cancelada | Retoma o envio a partir de onde parou. |
| Duplicar | Finalizada | Cria uma cópia da campanha com status Inativa para você editar e reutilizar. |
| Relatório | Sempre | Abre a página de relatório com estatísticas de envio. |
| Editar | Sempre | Abre o formulário de edição (somente editável quando Inativa ou Programada com mais de 1h de antecedência). |
| Excluir | Sempre | Remove a campanha permanentemente. |
Relatório de campanha
Clique no ícone de relatório (folha com linhas) em qualquer campanha para abrir o relatório. Ele atualiza em tempo real enquanto a campanha está em andamento.
O relatório exibe uma barra de progresso e cards com:
- Contatos Válidos — contatos da lista com número de WhatsApp validado.
- Entregues — mensagens enviadas com sucesso.
- Não enviados — contatos válidos que ainda não receberam a mensagem.
- Conexão — nome do número que enviou.
- Lista de Contatos — lista usada no envio.
- Agendamento — data/hora programada.
- Conclusão — data/hora de finalização.
Clique em "Baixar não enviados" (botão fixo no canto inferior direito) para exportar em CSV a lista de contatos que não receberam a mensagem. Útil para reprocessar em uma nova campanha.
Variáveis de personalização
Use variáveis nas mensagens para personalizar o texto com dados do contato ou do atendimento.
O formato usa chaves duplas: {{variavel}}.
| Variável | Substitui por |
|---|---|
{{firstName}} | Primeiro nome do contato |
{{name}} | Nome completo do contato |
{{ms}} | Saudação automática (Bom dia / Boa tarde / Boa noite) |
{{date}} | Data atual |
{{hour}} | Hora atual |
{{queue}} | Nome da fila / setor |
{{connection}} | Nome da conexão WhatsApp usada |
{{protocol}} | Número do protocolo do ticket |
{{CPF/CNPJ}} | CPF ou CNPJ do contato (se cadastrado) |
Exemplo: "Olá {{firstName}}, {{ms}}! Temos uma novidade para você."