Documentação
Primeiros passos
O comcom analytics é um painel de análise gratuito que agrega automaticamente as mensagens, reações, atividade de voz e movimentação de membros do seu servidor Discord, tornando visíveis o crescimento e o engajamento da comunidade. A instalação é concluída em três passos.
- Acesse analytics.comcom.app e faça login com o Discord.
- Adicione o bot a um servidor em que você tenha a permissão “Gerenciar servidor”.
- A coleta começa automaticamente no momento da instalação e os dados aparecem no painel.
Personalização
Excluir dados de bots
Você pode excluir as mensagens de outros bots como ruído. Ao remover as mensagens de bots da agregação nas configurações, você vê apenas a atividade dos membros humanos.
Filtrar canais
Você pode escolher quais canais de texto/voz analisar. Exclua canais administrativos ou de log para obter números mais fiéis à realidade da sua comunidade.
Gerenciar visualizadores (viewers)
Você pode definir com quais membros compartilhar o painel. Também é possível conceder acesso somente leitura a membros da equipe que não são administradores.
Conhecendo o painel
Na navegação à esquerda você confere os vários aspectos da sua comunidade. Para uma explicação detalhada de cada página com capturas de tela, consulte /product.
| Página | Conteúdo |
|---|---|
| Resumo | Tendências gerais, resumo semanal por IA e composição de membros em um só lugar. |
| Canais | Ranking e evolução por canal de texto/voz. |
| Cargos | Número de membros e atividade por cargo. |
| Membros | Histórico de atividade individual e cartões de membro. |
| Comparação | Veja, por métricas relativas anônimas, a posição do seu servidor em número de membros e atividade dentro dos servidores da mesma categoria (requer configurar uma tag de categoria). |
| Entradas | Evolução de entradas e saídas de membros e ranking de origem por link de convite. |
| Estatísticas | Séries temporais de mensagens, reações e voz, além de um gráfico de dispersão por canal. |
| Logs de atividade | Pesquise e consulte logs individuais de reações e voz. |
Comandos do Discord
Todas as funcionalidades podem ser acessadas pelo comando /comcom (subcomandos) no Discord. Alguns subcomandos podem variar conforme o ambiente.
| Comando | Conteúdo |
|---|---|
| /comcom member <user> | Cartão de análise do membro. Alterna entre o HUD animado de LV/EXP ⇄ painel detalhado. |
| /comcom channels | Painel de visão geral do servidor ⇄ ranking de canais (por mensagens / por voz). |
| /comcom leaderboard | Placar de EXP do servidor + sua posição. |
| /comcom heatmap | Mapa de calor de atividade (dia da semana × hora, mensagens + voz). |
| /comcom room | GIF de “quarto” em pixel art + navegação por botões. |
| /comcom poll | Crie uma enquete para a comunidade (pergunta / opções / duração / múltipla escolha). |
| /comcom help | Exibe a lista de todos os comandos. |
| /comcom slot | Sorteia aleatoriamente um membro, com animação em GIF (sem prêmios). |
Como funcionam EXP / nível / rank
O EXP é um valor cumulativo calculado a partir da atividade registrada e só aumenta (nunca diminui).
dailyEXP = min(messages,100)·1 + max(0,messages-100)·0.25 // soft cap
+ min(voiceMinutes,240)·0.5 // 4h/day cap
+ reactionsGiven·0.5 + reactionsReceived·1 + mentionsReceived·1
EXP = Σ dailyEXP (all recorded days, only grows)
Level = floor( sqrt(EXP / 50) )Títulos por nível: Newcomer (0–4) → Regular (5–11) → Active (12–21) → Veteran (22–34) → Elite (35–49) → Legend (50+). O EXP, o nível e o rank de todo o período são atualizados por um processamento noturno.
Diretrizes
Dicas de operação
- A atividade de voz é acumulada a partir da instalação. O rank de todo o período aparece após a atualização noturna.
- Analisar mensagens, voz e reações em conjunto revela membros que contribuem mesmo falando pouco.
- Use o mapa de calor para identificar os horários mais ativos e otimizar o momento de eventos e anúncios.
Privacidade
O cartão de membro só pode ser executado pelo próprio membro, ao ver a si mesmo, ou por um administrador com a permissão “Gerenciar servidor”. As ações dos botões ficam restritas a quem executou o comando. Nenhum dado pessoal (PII), como endereços de e-mail, é exposto no painel nem via API/MCP.
Como interpretar os dados
Os números se baseiam em dados reais a partir da instalação. O EXP de todo o período, o rank e a voz de todo o período são atualizados por um cálculo noturno (precompute); logo após a instalação, alguns valores podem aparecer como “aguardando processamento”.
Perguntas frequentes
É gratuito?
Sim. O painel básico e os comandos são totalmente gratuitos. O plano pago (Pro), com preço conforme o tamanho do servidor, adiciona recursos como acesso à API/MCP.
É possível obter dados antigos?
Não. A coleta começa no momento da instalação do bot. Não é possível recuperar dados anteriores.
Os comandos não aparecem.
Comandos globais podem levar alguns minutos para propagar. Recarregue o Discord com Ctrl/Cmd+R para limpar o cache.
O que acontece com os dados se removermos o bot?
Ao remover o bot, o acesso ao painel é interrompido. Se ele for adicionado novamente, a coleta recomeça a partir desse momento — o período em que o bot esteve removido fica sem registro.
É possível comparar vários servidores ou fazer benchmark com outros?
Sim. Vários servidores que você administra podem ser exibidos juntos a partir do canto superior direito de páginas como Resumo (somente administradores, todos os servidores no Pro). A comparação com outros servidores fica disponível na página “Comparação” como métricas relativas anônimas, depois de configurar uma tag de categoria. Nomes de servidores e informações de membros nunca são revelados a outros administradores.
Solução de problemas
Os dados estão vazios ou escassos logo após a instalação
Como a coleta começa no momento da instalação do bot, é normal haver poucos dados no início. Os números se estabilizam após alguns dias a uma semana de atividade normal.
Os números de voz parecem atrasados em relação às outras métricas
Parte da agregação de voz é processada em lote durante a noite, por isso pode haver um atraso de até alguns dias em relação a mensagens e reações. Os valores se atualizam automaticamente com o tempo.
O cartão de membro não executa ou os botões não respondem
O cartão de membro só pode ser executado pelo próprio membro, ao ver o próprio cartão, ou por um administrador com a permissão “Gerenciar servidor”. Os botões também respondem apenas a quem executou o comando; se outros membros clicarem, nada acontece.
Aparece um erro de permissão insuficiente
Instalar o bot ou alterar configurações exige a permissão “Gerenciar servidor” no Discord. Se o erro persistir mesmo com as permissões corretas, recarregue o painel para atualizar as informações de permissão em cache.