Visão Geral
A página de Campanhas é o centro de controle para gerenciar todos os disparos de mensagens, com interface intuitiva e recursos avançados.A interface se adapta automaticamente ao tema claro/escuro e é totalmente responsiva para diferentes dispositivos.
Interface Principal
Cabeçalho
A página apresenta:- Título e Descrição: “Campanhas - Gerencie suas campanhas de mensagens”
- Botão Atualizar: Recarrega a lista de campanhas
- Botão Nova Campanha: Abre o modal de criação
Filtros da Lista
Logo abaixo do cabeçalho, há filtros para refinar a listagem.
- Status: dropdown com os estados (Rascunho, Agendada, Em Execução, Pausada, Concluída, Cancelada, Erro)
- Tipo: WhatsApp, E-mail ou Todos
Lista de Campanhas
Colunas da Tabela
- Desktop
- Mobile
A tabela exibe todas as colunas lado a lado:
- Campanha - Nome e instância Evolution
- Status - Badge colorido com estado atual
- Progresso - Barra visual e números (enviados/total)
- Agendamento - Data/hora programada (se aplicável)
- Ações - Botões de ação contextuais
Status e Cores
Cada status possui uma cor e estilo específico:| Status | Cor | Significado |
|---|---|---|
| Rascunho | Cinza | Campanha criada mas não iniciada |
| Agendada | Roxo | Programada para execução futura |
| Em Execução | Verde | Ativamente enviando mensagens |
| Pausada | Amarelo | Temporariamente interrompida |
| Concluída | Azul | Finalizada com sucesso |
| Cancelada | Vermelho | Interrompida permanentemente |
| Erro | Vermelho | Falha na execução |
Barra de Progresso
A barra de progresso mostra:- Números:
enviados/total(ex: 150/500) - Percentual: Calculado automaticamente
- Visual: Barra azul preenchida proporcionalmente
- Animação: Transição suave ao atualizar
Ações Disponíveis
Por Status da Campanha
Em Execução
- Ver Detalhes 👁️
- Pausar ⏸️
- Cancelar ❌
- Duplicar 📄
Pausada
- Ver Detalhes 👁️
- Retomar ▶️
- Cancelar ❌
- Duplicar 📄
Agendada
- Ver Detalhes 👁️
- Cancelar ❌
- Duplicar 📄
Finalizada
- Ver Detalhes 👁️
- Duplicar 📄
Descrição das Ações
- Ver Detalhes 👁️ - Abre modal com informações completas (WhatsApp e E-mail)
- Pausar ⏸️ - Interrompe temporariamente o envio
- Retomar ▶️ - Continua do ponto onde parou
- Cancelar ❌ - Interrompe permanentemente
- Duplicar 📄 - Cria uma cópia em rascunho da campanha
Modal de Nova Campanha
Seções do Formulário
- Dados Básicos
- Filtros
- Mensagem
- Configurações
- Nome da Campanha - Identificação única
- Fonte de Dados - Banco do sistema ou Meus Bancos (do usuário)
- Instância WhatsApp - Evolution para envio (se WhatsApp)
Variáveis de Personalização
Use variáveis para personalizar mensagens:{PrimeiroNome}- Primeiro nome do contato{NomeCompleto}- Nome completo do contato- Campos customizados do banco de dados
Filtros e Operadores
Guia completo de filtros
Prévia de Contatos
Como revisar e selecionar
Meus Bancos
Bases próprias do usuário
Validações
O sistema valida automaticamente:- ✅ Remove contatos bloqueados
- ✅ Valida formato de números
- ✅ Verifica duplicatas
- ✅ Confirma conexão Evolution API
Modal de Detalhes
Informações Exibidas
O modal de detalhes é atualizado em tempo real durante a execução da campanha.
Cabeçalho
- Nome da campanha
- Badge de status colorido
- Botão de atualização manual
Estatísticas
- Total de Contatos - Quantidade final após filtros/bloqueios
- Enviados - Mensagens entregues com sucesso
- Falhas - Erros no envio
- Progresso - Percentual e barra visual
Configurações
- Mensagem - Conteúdo enviado
- Mídia - Link se houver anexo
- Intervalos - Configuração de tempo
- Evolution - Instância utilizada
Timestamps
- Criado em - Data de criação
- Agendado para - Se programada
- Iniciado em - Início real
- Concluído em - Término
Estados e Fluxo
Funcionalidades Especiais
Atualização em Tempo Real
- Lista atualiza automaticamente ao criar/modificar campanhas
- Progresso atualizado dinamicamente
- Notificações toast para feedback de ações
Responsividade
A interface se adapta perfeitamente:- Desktop: Tabela completa com todas as colunas
- Tablet: Layout adaptado mantendo funcionalidades
- Mobile: Cards otimizados para toque
Dark Mode
Suporte completo a tema escuro:- Cores ajustadas para contraste ideal
- Badges e botões adaptados
- Transições suaves entre temas
Mensagens de Feedback
Sucesso
- ✅ “Campanha criada com sucesso”
- ✅ “Campanha pausada”
- ✅ “Campanha retomada”
- ✅ “Campanha cancelada”
- ✅ “Campanha excluída com sucesso”
Erro
- ❌ “Erro ao criar campanha”
- ❌ “Erro ao pausar campanha”
- ❌ “Erro ao retomar campanha”
- ❌ “Erro ao cancelar campanha”
- ❌ “Erro ao excluir campanha”
Confirmações
Excluir Campanha
Ao excluir, um diálogo de confirmação aparece:- Título: “Excluir Campanha”
- Mensagem: “Tem certeza que deseja excluir esta campanha? Esta ação não pode ser desfeita.”
- Botões: Excluir (vermelho) / Cancelar
Integração com API
Endpoints Utilizados
Dicas de Uso
Organização
Use nomes descritivos e inclua datas para facilitar identificação
Testes
Sempre teste com poucos contatos antes de campanhas grandes
Intervalo Fixo
O envio usa intervalo aleatório entre 5–12s (não configurável)
Monitoramento
Acompanhe o progresso para identificar problemas rapidamente
Limitações Conhecidas
- Exclusão de campanhas ainda não está implementada no backend e não está disponível na interface
- O limite de contatos por campanha depende da configuração do servidor
- Campanhas em execução não podem ser editadas
- Intervalo de envio não é configurável pelo usuário
Próximas Funcionalidades
Recursos planejados para futuras versões:
- Exportação de relatórios
- Templates de mensagens
- Análise de performance
- Campanhas recorrentes