Bot de análise do Telegram para moderação de grupos

Um bot de análise do Telegram informa o que os seus sistemas de moderação detectam: quantas violações um grupo recebeu, quais os tipos, como esses números evoluem ao longo de uma semana ou de um mês e quão arriscado parece ser um membro específico. O Telegram Bot App é esse tipo de bot. As suas análises descrevem segurança e aplicação de regras, não crescimento. Aqui, você não encontrará gráficos de contagem de inscritos nem métricas de vaidade sobre volume de mensagens. Você encontrará estatísticas de violações por grupo, relatórios de risco de spam de usuários individuais, um feed ao vivo de ações de moderação e uma API pública para consultar a classificação de spam de qualquer usuário pelo ID do Telegram.

Este guia explica o que as análises abrangem, onde consultá-las e quais são os seus limites, para que você saiba exatamente que tipo de bot de análise do Telegram é este antes de adicioná-lo.

Análises de moderação, não análises de crescimento

A maioria das ferramentas que se apresentam como um bot de análise do Telegram conta mensagens, acompanha horários de maior atividade e cria gráficos de entradas e saídas de membros. O Telegram Bot App não faz isso. Cada número que ele mostra vem da moderação: uma mensagem precisa ter sido verificada, classificada e receber uma ação para aparecer nos dados.

Assim, as métricas respondem a perguntas diferentes. Em vez de "quantas pessoas publicaram hoje", o painel responde "quantas dessas publicações violaram uma regra, qual regra e qual foi a confiança da detecção". Isso torna os dados úteis para uma finalidade: análises de grupos do Telegram para decisões de segurança e políticas. É a ferramenta certa se você quer saber se o seu limite de spam está permissivo demais, qual tipo de violação predomina no seu grupo ou se vale a pena banir uma conta específica. É a ferramenta errada se você quer relatórios de engajamento para um canal de marketing.

Ser claro sobre isso é importante porque a detecção subjacente funciona quer você consulte o painel ou não. As análises são uma janela para o trabalho que o bot já realiza em cada mensagem.

Estatísticas e tendências de violações por grupo

Abra um grupo no painel e você terá uma visão agregada de como a moderação se desenrolou naquela comunidade.

A visão geral cobre o status do grupo, a contagem de membros, a contagem de admins e verificações de configuração (foto de perfil e link de convite presentes). As métricas de atividade mostram o total de mensagens vistas, o total de violações detectadas e o tempo total de punição aplicado. A partir disso, o painel calcula uma taxa de punição por 1.000 mensagens e uma duração média de punição, para que um grupo pequeno e um grande possam ser comparados na mesma escala.

A divisão por violações é o centro das análises de moderação do Telegram. Cada violação detectada é classificada por tipo com uma contagem exata: conteúdo pornográfico, conteúdo sexual, linguagem tóxica, spam, violações de idioma, palavrões, insultos, ameaças, palavras proibidas personalizadas, mensagens encaminhadas, mídia proibida, links de convite e bots não autorizados. Isso mostra com o que o seu grupo realmente tem problemas, em vez do que você presume. Um grupo cuja divisão é 80% spam de links de convite precisa de configurações diferentes de outro dominado por toxicidade.

A análise temporal adiciona a dimensão do tempo. O painel mostra a atividade dos últimos 7 dias e dos últimos 30 dias, para que você veja se as violações estão subindo ou caindo. As linhas de tendência facilitam a leitura de um pico após uma menção pública ou de uma queda constante depois que você ajustou um limite. A divisão completa desses painéis está no guia Gerenciando seu bot pelo painel.

Relatórios de risco de spam de usuários individuais

Os totais do grupo dizem algo sobre a sala. Os relatórios de inteligência de usuários dizem algo sobre uma pessoa.

Pesquise qualquer membro por nome, handle ou ID do Telegram e o bot retorna um perfil construído a partir do histórico de moderação desse usuário. O número principal é uma pontuação de risco de spam de 0,0 a 1,0, calculada pelo mesmo modelo AI Spam Intelligence que o bot usa para expulsar automaticamente contas com 0,75 ou mais. A pontuação reflete a taxa de infrações, a confiança de detecções anteriores, características do perfil e padrões de comportamento, não apenas uma única mensagem problemática.

Abaixo da pontuação, o relatório detalha estatísticas de confiança (média, mediana, 95º percentil), a taxa de violações de alta confiança e os tipos e motivos de violação mais comuns desse usuário. Em seguida, lista todo o histórico de violações em ordem cronológica: cada infração com o seu carimbo de data/hora, tipo, nível de confiança e o motivo que a acionou.

Esse nível de detalhe é justamente o ponto. Você consegue ver não apenas que uma conta violou regras, mas também com que confiança cada decisão foi tomada, o que permite separar um infrator reincidente genuíno de um membro que acionou um filtro uma única vez. O artigo Inteligência de usuários e análises de grupos explica em detalhes como ler esses relatórios.

O feed de punições ao vivo

O painel também inclui um fluxo em tempo real de ações de aplicação de regras. O feed de punições ao vivo usa uma assinatura WebSocket para mostrar ações de moderação conforme acontecem, exibindo as 20 punições mais recentes em todo o sistema — todos os grupos que o bot protege, não apenas os seus.

Cada entrada mostra o usuário punido, o tipo de violação, o motivo detalhado, a pontuação de confiança e o carimbo de data/hora. É o mais próximo de assistir ao bot trabalhar. Para um novo admin que está decidindo se a detecção é agressiva demais ou permissiva demais, alguns minutos do feed dizem mais do que uma página de configurações. O feed reflete a mesma lógica de aplicação documentada no guia Sistema de punição automatizado.

A API pública de classificação de spam

As análises não ficam presas dentro do painel web. O Telegram Bot App disponibiliza uma API pública que retorna a classificação de spam de um usuário pelo ID do Telegram. Você consulta um ID e recebe de volta a avaliação de risco daquela conta — a mesma pontuação que o bot usa internamente.

Isso existe para que outras ferramentas possam reutilizar a classificação. Um segundo bot, um formulário de cadastro ou um script externo de moderação pode verificar um usuário que está chegando na base de dados de spam antes de deixá-lo entrar, em vez de esperar que ele se comporte mal primeiro. A classificação se baseia em bases de dados externas de spam cruzadas, além do próprio histórico da conta, por isso traz sinais úteis até para um usuário que nunca publicou no seu grupo.

O que as análises não incluem

Dados honestos significam nomear as lacunas. Este bot de análise do Telegram não oferece:

• Painéis de volume de mensagens, horários ativos ou engajamento. As contagens aqui são contagens de violações, não contagens de atividade por si só.
• Gráficos de crescimento, retenção ou funil de entrada/saída de membros. O bot bloqueia spam de links de convite; ele não adiciona nem convida membros, e não gera gráficos de crescimento de membros.
• Análises de texto ou OCR. A verificação de imagens classifica imagens (pontuações de confiança porn/racy/strict) sem extrair nenhum texto delas.
• Respostas conversacionais ou de chat com AI. O bot modera; ele não conversa.
• Relatórios de sentimento sobre o "clima da sala" como métrica de crescimento. A detecção de sentimento e toxicidade alimenta a divisão por violações, não um gráfico de clima da comunidade.

Se você precisa disso, este não é o bot certo, e fingir o contrário desperdiçaria o seu tempo.

De onde vêm os números

Cada análise remonta a um sistema de detecção, todos executados no plano gratuito para moderação essencial:

• AI Spam Intelligence (risco bayesiano de 0,0–1,0, expulsão automática em 0,75) e Spamfinder (um classificador de conteúdo por ML com limite de 0–100%) produzem as contagens de spam e alimentam a pontuação de risco por usuário.
• A verificação de imagens NSFW em fotos, GIFs, stickers e fotos de perfil produz as contagens de conteúdo pornográfico, sexual e mídia proibida.
• A detecção de sentimento e toxicidade (toxicidade, palavrões, insultos, ameaças) e palavras proibidas personalizadas produzem essas categorias de violação. A aplicação de regras de idioma em cerca de 33–43 idiomas produz violações de idioma.
• O tratamento de links (bloqueio de links de convite t.me/ e sinalização de URLs maliciosas via Google Safe Browsing) produz as contagens de links e links de convite.

O plano gratuito inclui 500 verificações de imagem e 1.000 análises de sentimento por mês, além de toda a moderação essencial. Os planos pagos (Gold $4.99/mo, Platinum $9.99/mo, Ultimate $49.99/mo, cerca de 20% de desconto anual) aumentam essas cotas; eles não adicionam uma classe diferente de análises. A pilha anti-spam completa por trás dos números de spam é abordada no guia Proteção anti-spam.

Perguntas frequentes

Este é um bot de análise de crescimento para Telegram?

Não. É um bot de análise de moderação. As suas análises de grupos do Telegram medem violações, aplicação de regras e risco de spam por usuário. Ele não informa volume de mensagens, horários ativos, crescimento de membros ou engajamento. Se você quer painéis de inscritos e atividade, este bot não foi criado para isso.

O que os relatórios de usuários individuais realmente podem me dizer?

Cada relatório fornece uma pontuação de risco de spam (0,0–1,0), estatísticas de confiança das detecções anteriores desse usuário, os tipos e motivos de violação mais comuns e um histórico com carimbo de data/hora de cada infração, com o seu nível de confiança. Isso é suficiente para avaliar se uma conta é reincidente ou se foi um falso positivo isolado antes de você agir.

Quão em tempo real é o feed de punições?

Ele transmite por WebSocket e mostra as 20 ações de moderação mais recentes em todos os grupos que o bot protege, com usuário, tipo de violação, motivo, confiança e carimbo de data/hora em cada uma. Novas punições aparecem assim que acontecem.

Para que serve a API pública de classificação de spam?

Ela retorna a classificação de spam de qualquer usuário pelo ID do Telegram para que ferramentas externas possam reutilizar a avaliação. Por exemplo, você pode filtrar novos participantes comparando-os com a base de dados de spam a partir do seu próprio bot ou formulário. Ela se baseia no histórico da conta e em bases de dados externas de spam cruzadas.

Preciso de um plano pago para ver as análises?

Não. A moderação essencial e as suas análises funcionam no plano gratuito, que inclui 500 verificações de imagem e 1.000 análises de sentimento por mês. Os planos pagos (Gold, Platinum, Ultimate; cerca de 20% de desconto anual) aumentam as cotas de verificação em vez de bloquear um produto de análises separado.

O bot conta mensagens ou acompanha quem é mais ativo?

Não. O único número de mensagens é um total usado para escalar taxas de violação (punições por 1.000 mensagens). Não há ranking de atividade por membro, gráfico de horários ativos nem pontuação de engajamento como recurso.

Comece

Se análises de moderação são o que você procura (tendências de violações, relatórios de risco de spam, um feed de aplicação de regras ao vivo e uma classificação de spam consultável), primeiro adicione o bot a um grupo. O painel fica disponível assim que ele estiver presente e você for admin. O guia Como adicionar o bot ao seu grupo mostra o passo a passo, ou comece pela página inicial do Telegram Bot App.