Um bot de análise de servidor no Discord transforma entradas de membros, aberturas de tickets e pagamentos de faturas em um relatório que você lê de uma vez, seja como embed do Discord, seja em um painel web. O Noxyr faz isso com dois comandos de barra, /status e /sales, uma página Overview no painel e uma Server API somente leitura que expõe os mesmos números no seu próprio site. Este guia explica o que cada um realmente mostra.
/status: estatísticas de membros, tickets e comunidade
/status é um comando exclusivo de administradores com cinco visões: all, invite, sales, tickets e community. Todas as visões aceitam a opção days (7, 14 ou 30; o padrão é 30) e retornam um embed com um gráfico de linhas anexado, então funcionam tanto como uma verificação rápida de números quanto como uma visão de tendência.
- /status invite: entradas e saídas de hoje, dos últimos 7 dias e do período escolhido, mostrados como variação líquida, com as contagens brutas de entradas e saídas logo abaixo.
- /status tickets: tickets abertos, tickets fechados e quantos estão abertos agora. É a análise de tickets que os administradores mais pedem: os tickets estão se acumulando, ou a equipe está acompanhando o ritmo?
- /status sales: quantidade de faturas e valor total. O total é uma soma simples, sem conversão de moeda, porque as faturas podem ser emitidas em mais de uma moeda, e converter exigiria adivinhar uma taxa de câmbio.
- /status community: quantidade de avaliações e volume de mensagens, para uma leitura da atividade geral, e não de suporte ou receita.
- /status all: todos os campos acima em um único embed, para um resumo de segunda-feira de manhã.
O gráfico é gerado no servidor e anexado como imagem. Se a renderização do gráfico falhar por qualquer motivo, o comando ainda responde com os números em texto, em vez de falhar por completo. As contagens de membros e mensagens só começam a contar a partir do dia em que o Noxyr entrou no servidor, então um bot adicionado no mês passado não mostrará anos de histórico.
/sales: receita, principais compradores e estilo do relatório
/sales cobre as estatísticas de vendas que um bot do Discord precisa além de um único total. Ele tem três subcomandos, todos exclusivos de administradores, todos com resposta privada ou publicados no canal com a opção post.
- /sales report: receita do período, quantidade de pedidos pagos, unidades vendidas, quantidade de faturas, uma divisão por status (Successful, Pending, Failed) e por método de pagamento, além dos principais produtos. As opções de período são os últimos 7 dias, os últimos 30 dias, os últimos 90 dias ou todo o período.
- /sales top: um ranking de compradores, ordenado pela quantidade de pedidos ou pelo valor gasto, filtrável por moeda, mostrando até 25 compradores.
- /sales style: define a cor do embed, as imagens de banner e miniatura, títulos personalizados para o relatório e o ranking, o texto do rodapé, o tamanho padrão do ranking, se os nomes dos compradores aparecem ao lado da menção, e quais status de fatura contam como receita. Desativar os três status é recusado, já que um relatório que nunca conta nada como receita não é útil para ninguém.
Os dois comandos verificam a permissão de Administrador ou um cargo de administrador configurado antes de executar, o mesmo controle de acesso que o painel usa.
O que a página Overview do painel mostra
A página Overview do painel não é o mesmo relatório do /status. É a primeira página que você vê ao abrir um servidor, e ela resume o lado da loja e do suporte: quantidade de categorias, produtos e vouchers ativos, total de faturas, total de avaliações, as cinco faturas mais recentes e as cinco avaliações mais recentes, além de uma lista de configuração para qualquer recurso que você tenha ativado mas ainda não terminou de configurar. Enquanto /status e /sales são relatórios pontuais que você puxa sob demanda no Discord, a Overview é o resumo sempre atualizado que você consulta no navegador, sem precisar estar com o teclado à mão no meio de uma conversa.
Lendo os mesmos números no seu próprio site: a Server API
Se você quer as estatísticas do servidor no Discord no seu próprio site, em uma página de status ou em uma planilha, a Server API é a ponte. Ela é somente leitura, limitada a um servidor, e retorna JSON com os mesmos dados que o /status e o painel já acompanham:
- GET /api/v1/server: nome, ícone, quantidade de membros, quantidade online, boosts.
- GET /api/v1/tickets: totais, quantidade de abertos e fechados, volume de 7 e 30 dias, avaliação média.
- GET /api/v1/activity?days=30: mensagens diárias, entradas e saídas, até 90 dias para trás.
- GET /api/v1/invoices: quantidade de faturas e receita por moeda e status.
- GET /api/v1/reviews: avaliação média, distribuição por estrelas e as avaliações públicas mais recentes.
- GET /api/v1/giveaways: quantidade de sorteios ativos e encerrados, e total de participações.
Gere uma chave na página de API do servidor no painel, envie-a como Bearer token, e cada endpoint é controlado pelo seu próprio escopo, então você pode compartilhar uma chave que só lê tickets, por exemplo, sem expor os dados de faturas. As chaves são limitadas a 60 requisições por minuto, o que basta, já que os totais de tickets e vendas não precisam ser consultados com frequência maior do que uma vez por minuto.
Perguntas frequentes
Preciso da API para ver as análises? Não. O /status e o /sales funcionam sem nenhuma configuração, e a página Overview do painel precisa apenas de login. A API serve para levar os números para algo fora do Discord.
O /status tem algum custo? Não. O Noxyr não tem plano premium, então todas as visões do /status e do /sales estão disponíveis para todos os servidores.
Os membros podem ver essas estatísticas? Os dois comandos exigem Administrador ou um cargo de administrador configurado, então membros comuns não podem executá-los.
Por que o total de vendas não converte moedas? As faturas podem ser emitidas em USD, INR, EUR ou GBP, e o relatório soma as moedas em que você realmente vendeu, em vez de inventar uma taxa de câmbio.
Veja a lista completa de comandos em /commands, ou compare executar coisas pelo Discord com usar o painel em Painel vs. comandos. Adicione o Noxyr gratuitamente para ter análises, tickets e uma loja rodando em um único bot.