Configurando o Telm

Este guia orienta você a adicionar o Telm a um grupo do Telegram, observá-lo funcionar em um modo seguro, apenas de observação, ajustar as suas regras e, por fim, ativar a aplicação ativa das regras.

Passo 1: Adicione o bot ao seu grupo

Abra o seu grupo no Telegram, vá em Gerenciar grupo > Administradores > Adicionar administrador e adicione @TelmBot. O Telm precisa das seguintes permissões de administrador para moderar com eficácia:

• Excluir mensagens — remover spam e conteúdo que viola as regras
• Banir usuários — remover e bloquear spammers conhecidos
• Restringir membros — silenciar usuários que ultrapassam um limite de taxa ou filtro

O Telm nunca precisa de "Alterar informações do grupo" nem de "Adicionar novos administradores"; então deixe essas opções desativadas. Depois de adicionado, o bot se apresenta no grupo e vincula o grupo ao seu painel.

Passo 2: Observe-o no Modo de Monitoramento

Todo grupo novo começa no Modo de Monitoramento — o bot observa e reporta, mas nunca toca em uma mensagem. Essa é a forma mais segura de ver exatamente o que o Telm *faria* antes de ele agir.

No painel, você verá um feed ao vivo das ações-sombra:

[MONITOR] would DELETE  message from @user4823  reason: CAS blocklist match
[MONITOR] would MUTE    message from @promo_acct reason: rate limit (12 msgs / 5s)
[MONITOR] would BAN     message from @spammer01  reason: AI spam score 0.97

Deixe rodar por alguns dias em um grupo movimentado. Analise o feed e confirme que as ações correspondem ao que você esperaria. É aqui que você identifica os falsos positivos *antes* que membros reais sejam afetados.

Passo 3: Configure as suas regras

O Telm usa três camadas de detecção — regras codificadas, um classificador local rápido e verificações profundas de IA para casos incertos — além da lista global de bloqueio antispam CAS. Em cima disso, você pode adicionar as suas próprias regras de moderação personalizadas pelo painel:

• Listas de bloqueio — bloqueie palavras, frases ou padrões de regex
• Limites de taxa — limite quantas mensagens um usuário pode enviar em uma janela de tempo
• Filtros de link — bloqueie ou crie uma lista de permissões de domínios específicos
• Filtros de conteúdo — restrinja encaminhamentos, mídia ou postagens de contas novas

rules:
  - type: rate_limit
    max_messages: 5
    window_seconds: 10
    action: mute
  - type: link_filter
    mode: allowlist
    domains: ["keepflow.ai", "telm.com"]
    action: delete

Ajuste os limites com base no que você observou no Modo de Monitoramento. Mais rígido nem sempre é melhor — o feed mostra onde está o ruído de verdade.

Passo 4: Ative a aplicação das regras

Quando o feed-sombra estiver do jeito certo, mude o grupo do Modo de Monitoramento para Ativo no painel. A partir desse ponto, o Telm aplica exatamente as ações que você estava visualizando — excluindo spam, silenciando infratores de limite de taxa e banindo em tempo real contas listadas na CAS e contas de spam de alta confiança.

A aplicação entra em vigor imediatamente e não exige reinicialização. Se algo parecer errado, volte para o Modo de Monitoramento a qualquer momento; as suas regras são preservadas.

Passo 5: Use o painel

O painel é a sua central de controle ao vivo, via WebSockets:

• Atividade — estatísticas diárias de mensagens e membros e mapas de calor de atividade
• Rankings — principais membros por mensagens, XP e reputação
• Registro de moderação — cada ação executada, com o motivo que a acionou
• Multigrupo — gerencie todos os seus grupos em um só lugar e ative o Modo de Suporte para comunidades de help desk

Revise o registro de moderação semanalmente e refine as suas regras à medida que a sua comunidade cresce.