Relatorio de Campanha
O relatorio permite acompanhar em detalhes o desempenho de cada campanha: quantas mensagens foram entregues, quantas estao pendentes, falhas e o status de follow-up para campanhas com API Oficial.
Acessar o relatorio
Na tabela de campanhas, clique no icone de relatorio (documento) ao lado da campanha desejada. Voce e redirecionado para a tela /campaign/{id}/report.
Cards de metricas
O topo do relatorio exibe cartoes com os indicadores principais:
| Cartao | O que mostra |
|---|---|
| Status (grafico de rosca) | Proporcao visual de entregues / pendentes / falhas |
| Mensagens Enviadas | Total de mensagens que saiu da fila |
| Destinatarios Unicos | Quantos numeros diferentes foram processados |
| Mensagens Entregues | Mensagens confirmadas como entregues pelo WhatsApp |
| Aguardando Resposta* | Contatos aguardando retorno ao template (API Oficial) |
| Responderam ao Template* | Contatos que responderam (API Oficial) |
*Os dois ultimos cartoes aparecem somente em campanhas com API Oficial e follow-up configurado.
Barra de progresso
Abaixo dos cartoes, uma barra de progresso mostra Entregues / Total em percentual. Em campanhas em andamento, a barra e atualizada automaticamente via socket (sem precisar recarregar a pagina).
Informacoes da campanha
Tres cartoes adicionais exibem:
- Conexao WhatsApp usada (nome da conexao).
- Lista de Contatos ou Tag utilizada.
- Data de Agendamento (quando foi programada para disparar).
- Data de Conclusao (quando terminou, se ja finalizada).
Tabela de destinatarios
A parte inferior da tela lista cada mensagem enviada com as seguintes colunas:
| Coluna | Descricao |
|---|---|
| ID | Identificador interno do envio (Job ID) |
| Destinatario | Numero de telefone formatado |
| Mensagem | Primeiros 50 caracteres da mensagem enviada (passe o mouse para ver completo) |
| Enviado em | Data e hora em que a mensagem foi enfileirada |
| Entregue em | Data e hora da confirmacao de entrega (vazio = ainda pendente) |
| Status | Chip colorido: Entregue (verde), Pendente (amarelo) ou Falha (vermelho) |
| Follow-up (API Oficial) | Status do follow-up: Aguardando / Enviado / Expirado (so aparece para API Oficial) |
Paginacao da tabela
A tabela suporta paginacao. Escolha quantos registros exibir por pagina: 10, 25, 50 ou 100. Os dados sao carregados sob demanda do servidor, portanto mesmo campanhas com milhares de contatos nao travam a tela.
Exportar para Excel
Clique no botao verde Exportar Excel (canto superior direito da secao de mensagens). O sistema:
- Busca todos os dados de envio em lotes de 1.000 registros.
- Exibe o progresso com toasts de "Carregando X registros...".
- Gera um arquivo
.xlsxcom:- Cabecalho com nome da campanha e data de geracao.
- Colunas: ID, Destinatario, Mensagem, Enviado em, Entregue em, Status.
- Faz o download automatico no seu computador.
O nome do arquivo segue o padrao: relatorio_campanha_{nome}_{data}.xlsx.
Atualizacao em tempo real
Enquanto a campanha esta Em Andamento, o relatorio escuta eventos via socket. Quando uma mensagem e entregue ou o status da campanha muda (ex.: de EM_ANDAMENTO para FINALIZADA), os numeros sao atualizados automaticamente sem precisar recarregar a pagina.
Apos a campanha atingir o status FINALIZADA, o sistema aguarda 5 segundos e faz uma ultima busca para garantir que todos os dados foram contabilizados.
Problemas comuns
A barra de progresso nao avanca. Verifique se o WhatsApp da conexao esta conectado (ponto verde em Conexoes). Mensagens nao sao entregues com a conexao offline.
A coluna "Follow-up" nao aparece na tabela. Esta coluna so e exibida para campanhas que usam API Oficial com follow-up ativo. Para campanhas Baileys, a coluna nao e renderizada.
O relatorio mostra 0 mensagens entregues mesmo apos a campanha terminar. Pode ter ocorrido um erro de comunicacao ao buscar as estatisticas. Recarregue a pagina. Se o problema persistir, o suporte pode consultar os logs do servidor para identificar falhas no processamento da fila.
A exportacao para Excel esta demorando muito. Para campanhas com muitos contatos (milhares), a exportacao faz multiplas requisicoes ao servidor. Aguarde — cada requisicao processa ate 1.000 registros. Nao feche a aba durante a exportacao.