O módulo Grupos ganhou um sistema de reputação da comunidade: quem participa acumula pontos, sobe de nível e aparece no ranking — e os próprios membros premiam (ou punem) uns aos outros com um simples +1 ou −1.
Dois placares separados: XP e Reputação
O bot guarda dois números diferentes, de propósito — eles medem coisas diferentes:
| Vem de | Muda como | Serve para | |
|---|---|---|---|
| XP | Atividade no grupo e bônus por compartilhar oferta | Só sobe | Define o nível |
| Reputação | Votos +1/-1 dos membros e ajuste do admin |
Sobe e desce | Mostra o reconhecimento dos colegas |
Por que separar: presença rende muito mais que voto (1 XP a cada 10 min dá ~84 por semana, contra uns poucos votos). Se os dois somassem no mesmo placar, quem só ficasse online passaria na frente de quem é respeitado — e o voto viraria enfeite. Separando, cada um mede o que deve.
O ranking (e o Top da semana) é ordenado pelo conjunto: interação (XP) + reputação — quem participa todo dia sobe, e os votos dos colegas somam por cima. Cada linha mostra o nível, o XP e os pontos de reputação.
Como funciona no grupo
- Interagiu, ganhou XP — cada mensagem no grupo vale XP (valor e intervalo configuráveis; o padrão é 1 XP a cada 10 minutos por pessoa). XP não vira reputação.
- Votar em alguém — responda a mensagem da pessoa com
+1(dar pontos) ou-1(tirar). O bot confirma na hora com o total e o nível novo.- Membro comum: 1 voto por semana (você escolhe o intervalo em dias; 0 = sem limite).
- Admin do grupo: vota sem limite — dá e tira pontos quantas vezes quiser.
- Não dá para votar em si mesmo nem em bots.
- Níveis — calculados pelo XP; as faixas e os nomes são seus (padrão: Iniciante → Membro → Ativo → Veterano → Lenda). Quando alguém sobe de nível, o bot anuncia no grupo (dá para desligar).
/reputacao— mostra os seus pontos e nível (ou os da pessoa respondida)./reputacao topmostra o ranking dos 10 melhores./repfunciona como atalho.
Extras que trabalham sozinhos
- Top da semana automático — todo domingo à tarde o bot posta o Top 10 nos grupos (ligue no painel). Template
reputation.weekly_toppersonalizável. - Bônus por compartilhar oferta — membro postou um link e o bot converteu no grupo? Ele ganha pontos extras (valor e intervalo configuráveis).
/perfil— o bot responde com um card visual (imagem) com nome, nível, pontos e a barra de progresso até o próximo nível. Também funciona respondendo a mensagem de alguém.- Decaimento mensal (opcional) — todo dia 1 os pontos derretem X%, mantendo o ranking vivo e disputável.
- Alerta anti-brigada — se alguém receber muitos votos negativos em 24h, o painel mostra um aviso para você conferir o histórico e, se for abuso, devolver os pontos.
O que o admin controla no painel
Tudo, na aba Operação → Reputação:
- Ligar/desligar o sistema e o anúncio de subida de nível;
- Pontos por atividade e o intervalo entre ganhos;
- Peso do voto (+1/−1 podem valer 5 pontos, por exemplo) e o intervalo entre votos de cada membro;
- O editor de níveis (adicionar, renomear, reordenar faixas de pontos);
- O ranking completo, com ajuste manual: some ou tire pontos de qualquer membro direto pela tabela (ou pelo ID do Telegram) — sem limite.
Os textos das respostas do bot (voto confirmado, limite semanal, subida de nível etc.) são personalizáveis na aba Mensagens — templates reputation.*.
A reputação faz parte do módulo Grupos. O sistema vem desligado por padrão — ative na aba Reputação quando quiser estrear com a sua comunidade.