Você percebe uma diferença entre a contagem de membros exibida pelo seu bot de estatísticas e o número mostrado no Server Insights do Discord. Essa discrepância pode causar confusão ao acompanhar o crescimento do servidor ou verificar a atividade dos membros. A causa raiz está em como cada ferramenta define e conta um membro, especialmente em relação a membros pendentes, bots e usuários offline. Este artigo explica os motivos técnicos por trás da diferença e mostra como reconciliar os dois números.
Principais Conclusões: Discrepância na Contagem de Membros entre Bots e Insights do Discord
- Configurações do Servidor > Lista de Membros: Mostra todos os membros que aceitaram um convite, incluindo membros pendentes que ainda não passaram pela verificação de ingresso.
- Server Insights > Guia Crescimento de Membros: Acompanha membros que completaram a verificação de ingresso e entraram no servidor, excluindo membros pendentes.
- Endpoint da API do bot de estatísticas (GET /guild/{id}/members): Retorna todos os membros que o bot pode ver, incluindo bots e usuários offline, o que pode exceder o número informado pelo Insights.
Por que Bots de Estatísticas e o Insights do Discord Mostram Contagens de Membros Diferentes
O Server Insights do Discord é um recurso de análise disponível para servidores com a Comunidade ativada. Ele calcula as contagens de membros com base em uma definição restrita: um membro deve ter concluído o processo de verificação de ingresso e entrado ativamente no servidor. Esse número exclui convites pendentes, contas não verificadas e bots.
Bots de estatísticas do servidor, como MEE6, Dyno ou Statbot, usam a API do Discord para obter a lista de membros. O endpoint da API GET /guild/{id}/members retorna todos os objetos de membro que o bot tem permissão para ver. Isso inclui:
- Todos os membros humanos que aceitaram um convite, mesmo que não tenham passado pela verificação de ingresso (membros pendentes).
- Todos os bots presentes no servidor.
- Membros que estão atualmente offline ou ausentes.
Como a API não filtra pelo status de verificação, a contagem do bot é quase sempre maior que a do Insights. A diferença pode ser de apenas alguns bots ou de dezenas de membros pendentes que nunca concluíram a verificação.
Membros Pendentes e Verificação de Ingresso
Quando você ativa a verificação de ingresso em Configurações do Servidor > Configuração de Segurança, novos membros devem concordar com as regras antes de entrar completamente. Até que o façam, eles aparecem na lista de membros como pendentes. O Insights exclui esses membros pendentes do seu total. Um bot de estatísticas, no entanto, os inclui porque a API ainda os lista como membros do servidor com a flag pending definida como true.
Contagem de Bots e Visibilidade da API
O Server Insights do Discord não conta bots em seu total de membros. O painel do Insights foi projetado para análises de membros humanos. Bots de estatísticas, por outro lado, contam todos os membros, incluindo bots. Se seu servidor tem 10 bots, a contagem do bot será pelo menos 10 maior que a do Insights.
Membros Offline vs Online
O Insights acompanha apenas membros que estiveram ativos no servidor dentro de um determinado período, geralmente nos últimos 7 ou 30 dias. Um bot de estatísticas conta todos os membros, independentemente da última atividade. Isso significa que um membro que entrou há um ano e nunca mais voltou é contado pelo bot, mas pode não aparecer nas métricas de usuários ativos do Insights.
Passos para Reconciliar as Contagens de Membros entre um Bot e o Insights
Você pode verificar manualmente a diferença conferindo a lista de membros pendentes e a contagem de bots. As etapas abaixo pressupõem que você tenha permissão Gerenciar Servidor.
- Abra Configurações do Servidor > Membros
No Discord para desktop ou web, clique com o botão direito no nome do servidor e selecione Configurações do Servidor. Em seguida, clique em Membros na barra lateral esquerda. Esta lista mostra todos os membros que aceitaram um convite, incluindo membros pendentes. - Verifique o filtro de pendentes
No topo da lista de Membros, clique no menu suspenso de filtro e selecione Pendentes. Isso mostra apenas membros que não concluíram a verificação de ingresso. Conte esses usuários. Este é o número que o Insights exclui, mas o bot inclui. - Conte os bots no seu servidor
Na lista de Membros, clique no menu suspenso de filtro e selecione Bot. Conte todos os bots listados. O Insights exclui bots, enquanto o bot os inclui em seu total. - Compare com o Server Insights
Vá para Configurações do Servidor > Server Insights > Crescimento de Membros. Observe o número de Membros Totais mostrado lá. Esse número exclui membros pendentes e bots. - Calcule a contagem esperada do bot
Adicione a contagem de membros pendentes e a contagem de bots ao total do Insights. O resultado deve corresponder aproximadamente à contagem de membros do seu bot de estatísticas. Se a diferença for maior que 5, o bot pode estar contando membros de dados em cache ou usando um endpoint de API diferente.
Se o seu bot de estatísticas suportar configuração, verifique suas configurações para um filtro de membros pendentes. Alguns bots, como o Statbot, permitem excluir membros pendentes da contagem exibida. Isso aproxima o número do bot do Insights.
Se as Contagens de Membros Ainda Não Corresponderem
Bot Usa Cache Desatualizado
Alguns bots de estatísticas armazenam em cache a lista de membros para reduzir chamadas de API. Os dados em cache podem estar desatualizados por minutos ou horas. Durante esse período, novos membros podem ter entrado ou saído, causando uma diferença. Force uma atualização usando o comando de atualização do bot, geralmente !refresh ou /refresh. Verifique a documentação do bot para o comando exato.
Bot Não Tem Permissões Suficientes
Um bot de estatísticas deve ter a intenção Server Members ativada no Portal do Desenvolvedor do Discord. Sem essa intenção, o bot só pode ver membros que estão atualmente online. Isso faz com que a contagem do bot seja menor que a do Insights. Verifique se o desenvolvedor do bot ativou a Server Members Intent. Se você for o proprietário do bot, vá ao Portal do Desenvolvedor do Discord, selecione seu aplicativo de bot, clique em Bot e ative Server Members Intent em Intenções de Gateway Privilegiadas.
Atraso nos Dados do Insights
O Server Insights é atualizado com um atraso, às vezes de até 15 minutos. Se um membro entrou recentemente, o Insights pode ainda não refletir a mudança. Aguarde 30 minutos e verifique novamente. A contagem do bot é atualizada em tempo real, então uma diferença temporária é normal.
Server Insights do Discord vs Contagem de Membros do Bot de Estatísticas: Principais Diferenças
| Item | Server Insights | Bot de Estatísticas (API) |
|---|---|---|
| Membros pendentes | Excluídos | Incluídos |
| Bots | Excluídos | Incluídos |
| Membros offline | Excluídos das métricas ativas | Incluídos na contagem total |
| Frequência de atualização | Atraso de até 15 minutos | Quase em tempo real |
| Fonte de dados | Mecanismo interno de análise do Discord | API REST do Discord (GET /guild/{id}/members) |
O Server Insights do Discord e os bots de estatísticas servem a propósitos diferentes. O Insights oferece uma visão filtrada do crescimento e atividade de membros humanos. Bots de estatísticas fornecem uma contagem bruta e sem filtros de todos no servidor. Para obter um número consistente, use o filtro de membros pendentes em Configurações do Servidor > Membros e subtraia os bots do total do bot. Para um acompanhamento preciso do crescimento, confie no Insights e configure seu bot de estatísticas para excluir membros pendentes, se a opção estiver disponível.