Gerenciando seu bot pelo painel

Introdução

O Painel de Gerenciamento do Telegram Bot App oferece uma interface web completa para configurar ajustes de moderação, monitorar a atividade dos grupos, analisar o comportamento dos usuários e gerenciar assinaturas — tudo a partir de um painel de controle centralizado, acessível de qualquer dispositivo com navegador. Essa poderosa interface administrativa transforma configurações complexas do bot em operações intuitivas de apontar e clicar, ao mesmo tempo em que oferece análises aprofundadas e recursos de monitoramento em tempo real que seriam impossíveis pela interface nativa do Telegram.

O painel é onde você gerencia todas as suas atividades de moderação, desde alternâncias simples para ativar sistemas de detecção até análises que mostram tendências de violações, relatórios de inteligência de usuários com pontuações de risco comportamental e feeds de punições em tempo real exibindo ações de moderação à medida que acontecem. Seja para administrar uma única comunidade pequena ou a moderação de dezenas de grupos grandes, a mesma interface se aplica.

Visão geral do Dashboard

Acessando o painel

Para acessar o dashboard de gerenciamento:

1. Visite o site do Telegram Bot App
2. Clique em "Entrar com Telegram" ou "Acessar painel"
3. Conclua a autenticação do Telegram (você será redirecionado para o Telegram para autorizar)
4. Retorne ao dashboard — você verá todos os grupos em que é administrador e nos quais o bot está presente

Importante: Você deve adicionar o bot a pelo menos um grupo antes de conseguir acessar o painel. O sistema de autenticação verifica sua relação de administrador com os grupos monitorados pelo bot — sem essa verificação, o login não funcionará.

Navegação principal

O dashboard usa uma interface limpa e moderna, com a navegação principal no cabeçalho:

• Início: Página inicial com estatísticas rápidas e atividade recente
• Painel: Interface principal de gerenciamento de grupos (seu espaço de trabalho principal)
• Inteligência de Usuários: Ferramentas de análise comportamental e detecção de spam
• Preços: Planos de assinatura e comparação de recursos
• Recursos: Lista completa de recursos e funcionalidades
• Centro de Aprendizado: Documentação e tutoriais (você está lendo um agora!)
• Suporte: Informações de contato e recursos de ajuda

A seção Painel reúne a maioria das atividades administrativas do dia a dia, enquanto a Inteligência de Usuários oferece análises aprofundadas para investigar usuários específicos ou monitorar a atividade de moderação em todo o sistema.

Visualização do dashboard do painel

A página Painel exibe todos os grupos em que você é administrador e nos quais o bot está ativo. Cada grupo aparece como um cartão que mostra:

• Nome do grupo e avatar
• Handle do grupo (@groupname)
• Número de membros
• Selo de status da assinatura (Free, Gold, Platinum, Ultimate)
• Indicador de status (se o grupo está "permitido" — ativado para moderação)
• Botões de ação rápida para gerenciar o grupo

Use a barra de pesquisa na parte superior para filtrar grupos por nome ou handle — especialmente útil se você administra muitas comunidades. Os grupos são exibidos em uma lista virtualizada que lida com eficiência até mesmo com números muito grandes de grupos (20+) sem perda de desempenho.

Interface de gerenciamento de grupos

Ao clicar em um grupo específico, você abre a interface completa de gerenciamento, organizada em três abas principais:

Aba Informações:

• Status da assinatura e opções de upgrade
• Lista de administradores do grupo (clique em qualquer administrador para ver o relatório de inteligência dele)
• Metadados do grupo (handle do Telegram, link de convite, última atividade)
• Links rápidos para abrir o grupo no Telegram

Aba Estatísticas:

• Estatísticas do grupo: métricas gerais, estatísticas de atividade, eficiência da moderação, detalhamento de violações
• Estatísticas de usuários: 50 membros mais ativos, pesquisáveis por nome/handle/ID/bio

Aba Configurações:

• Proteção básica: CAPTCHA, restrições de mídia, gerenciamento de usuários
• Moderação com AI: detecção de NSFW, análise de sentimento, detecção de spam, imposição de idioma
• Configurações de idioma: seleção de idioma e opções de imposição
• Mensagens e saudações: mensagens de boas-vindas, regras do grupo, comportamento do bot
• Configurações avançadas: filtro de palavras proibidas, controles de status do grupo

Essa organização em três abas separa a visualização de informações (Informações e Estatísticas) da configuração (Configurações), reduzindo a poluição visual e facilitando a localização das tarefas mais comuns.

Configurando as definições de moderação

Aba de proteção básica

As definições de Proteção básica oferecem controles fundamentais de gerenciamento de grupo, disponíveis para todos os níveis de assinatura:

Gerenciamento de usuários:

• Ativar CAPTCHA para novos membros (com tempo limite configurável e opções de expulsar em caso de falha)
• Banir outros bots automaticamente
• Limitar usuários anônimos

Restrições de conteúdo:

• Bloquear vídeos, GIFs, áudios, arquivos, mensagens de texto (opções individuais)
• Bloquear encaminhamentos
• Bloquear links de convite

Cada opção inclui um rótulo descritivo explicando o que ela faz. As alterações são salvas automaticamente — basta alternar o botão e a configuração passa a valer imediatamente para todas as novas mensagens.

Aba de moderação por AI

As definições de moderação por AI controlam sistemas avançados de detecção, com alguns recursos restritos aos planos premium:

Detecção de conteúdo NSFW (Premium - usa a cota de análise de imagens):

• Detectar conteúdo pornográfico
• Detectar conteúdo sensual/sugestivo
• Detectar conteúdo falsificado
• Modo rigoroso (combina pornográfico + sensual)
• Controle deslizante de limite de detecção de imagem (0-100%)

Análise de mídia (Premium em alguns casos):

• Analisar imagens (Premium)
• Analisar GIFs (Premium)
• Analisar stickers (Premium)
• Analisar fotos de perfil dos usuários (Grátis)
• Analisar texto do perfil dos usuários (Grátis)

Detecção de spam (Grátis):

• Ativar detector de spam (baseado em padrões)
• Controle deslizante de limite de detecção de spam (0-100%)
• Ativar detecção de spam por AI (análise comportamental, expulsão automática em 0,75)

Análise de toxicidade e sentimento (Premium):

• Bloquear palavrões (punição de 1 min)
• Bloquear insultos (punição de 1 min)
• Bloquear ameaças (punição de 5 min)
• Controle deslizante de limite de detecção de sentimento (0-100%)

Recursos exclusivos dos planos Premium exibem um selo indicando o requisito de assinatura e oferecem botões de upgrade para usuários do plano Grátis.

Controles deslizantes de limite

Três controles deslizantes essenciais de limite definem a sensibilidade da detecção:

Limite de detecção de imagem:

• Intervalo: 0-100% (0,0-1,0 internamente)
• Padrão: 70%
• Menor = mais sensível (captura conteúdo no limite, mais falsos positivos)
• Maior = menos sensível (captura apenas violações evidentes, menos falsos positivos)

Limite de detecção de sentimento:

• Intervalo: 0-100%
• Padrão: 70%
• Controla a sensibilidade da detecção de toxicidade, palavrões, insultos e ameaças

Limite de detecção de spam:

• Intervalo: 0-100%
• Padrão: 75%
• Controla a sensibilidade da detecção de padrões de spam

Ajustar esses controles deslizantes afeta imediatamente a análise de mensagens futuras — não há atraso nem necessidade de clicar em um botão de salvar. Experimente diferentes valores e monitore as estatísticas de violações para encontrar as configurações ideais para sua comunidade.

Aba de configurações de idioma

Configure a aplicação de idioma com controle preciso:

• Opção Ativar proteção de idioma
• Modo somente excluir (remove sem punição)
• Menu suspenso do seletor de idioma com 43 idiomas compatíveis, do árabe ao vietnamita

O seletor de idioma usa menus suspensos para facilitar a escolha. Escolha o idioma usado principalmente pela sua comunidade, ative a proteção de idioma, e mensagens em outros idiomas serão removidas automaticamente (e os usuários serão punidos, a menos que o modo somente excluir esteja ativado).

Aba de mensagens e saudações

Personalize os recursos de interação do grupo:

Mensagem de boas-vindas:

• Ativar saudação
• Texto de saudação personalizado (área de texto com suporte a formatação)

Regras do grupo:

• Ativar regras do grupo
• Gerar regras automaticamente com base nas configurações (caixa de seleção)
• Texto de regras personalizado (área de texto)

Comportamento do bot:

• Silenciar bot (impedir todas as mensagens do bot)
• Excluir mensagens do sistema (remover notificações de entrada/saída)
• Ativar comando /link

Essas configurações controlam recursos visíveis aos usuários que afetam a experiência dos membros no seu grupo.

Aba de configurações avançadas

Configure recursos especializados:

Filtro de palavras proibidas:

• Ativar filtro de palavras proibidas
• Aplicar punição vs. apenas excluir
• Adicionar palavras proibidas personalizadas (campo de entrada + botão de adicionar)
• Ver e remover palavras proibidas existentes (lista com botões de exclusão)

Status do grupo:

• Grupo permitido (se a moderação está ativa)
• Ocultar das estatísticas

A interface de palavras proibidas oferece gerenciamento por cliques — digite uma palavra, clique em Adicionar, e ela é incluída imediatamente na sua lista de filtros. Clique no X ao lado de qualquer palavra para removê-la.

Monitoramento e análises

Painel de estatísticas do grupo

Acesse métricas abrangentes em Estatísticas > Estatísticas do grupo:

Visão geral:

• Status (permitido/não permitido)
• Total de membros
• Total de administradores
• Verificação da presença do bot
• Status da foto de perfil e do link de convite

Métricas de atividade:

• Total de mensagens desde sempre
• Total de violações detectadas
• Tempo total de punição aplicado (minutos)
• Relação entre mensagens e moderação

Eficiência da moderação:

• Taxa de punição por 1.000 mensagens
• Duração média das punições
• Média de mensagens por membro (indicador de engajamento)

Atividade recente:

• Punições nos últimos 7 dias
• Punições nos últimos 30 dias
• Análise de tendências

Detalhamento das principais violações:

• Violações por tipo (pornografia, linguagem tóxica, spam etc.)
• Contagens exatas para cada categoria
• Representação visual das regras violadas com mais frequência

Essas estatísticas são atualizadas em tempo real conforme novos dados chegam, garantindo que você sempre veja métricas atuais.

Estatísticas dos usuários

Veja e analise a atividade dos membros em Estatísticas > Estatísticas dos usuários:

• Barra de busca para filtrar por nome, handle, ID ou conteúdo da bio
• Top 50 usuários mais ativos por contagem de mensagens
• Cada cartão de usuário exibe:
  • Avatar
  • Nome e handle
  • Total de mensagens neste grupo
  • Data e hora da última visualização
• Clique em qualquer usuário para ver o relatório completo de inteligência dele

Use este recurso para identificar os membros mais engajados da sua comunidade, detectar padrões de atividade incomuns (contagens de mensagens extremamente altas podem indicar bots de spam) ou investigar usuários específicos denunciados pelos membros.

Gerenciamento da assinatura

Monitore e gerencie sua assinatura por várias interfaces:

Página de status da assinatura (acessível pela aba de informações do grupo):

• Detalhes do plano atual (nome, preço, recursos)
• Período de cobrança (data de início, data de término)
• Cotas de recursos (análises de imagens, análises de sentimento etc.)
• Medidores de uso com atualizações em tempo real (com WebSocket)
• Alternância de excedente (ativar/desativar pagamento conforme o uso)
• Grupos cobertos por esta assinatura
• Indicador de status da conexão

Página de histórico de cobrança:

• Resumo do período de cobrança atual
• 12 períodos de fatura mais recentes
• Cada fatura mostrando: número do período, datas, cobranças por excedente, status do pagamento
• Gerenciamento do método de pagamento (redireciona para o portal da Stripe)

Os medidores de uso fornecem atualizações ao vivo conforme a cota é consumida, com barras de progresso visuais mostrando a porcentagem usada e contagens exatas (por exemplo, "450 / 500 análises de imagens usadas"). Essa visibilidade em tempo real ajuda você a entender se o plano atual atende às suas necessidades ou se um upgrade seria benéfico.

Recursos de inteligência de usuários

Relatórios de inteligência individuais

Acesse análises comportamentais aprofundadas de qualquer usuário:

1. Acesse User Intelligence no menu principal
2. Pesquise por nome, handle ou ID do Telegram
3. Veja um relatório completo incluindo:
   • Classificação de spam (0.0-1.0 com indicador de nível de risco)
   • Estatísticas de violações (média de confiança, mediana, percentil 95, taxa de alta confiança)
   • Atividade em grupos (mensagens enviadas, grupos em que entrou)
   • Histórico completo de violações (lista cronológica com timestamps, tipos, confiança e motivos)

A classificação de spam é a mesma pontuação usada pela inteligência de spam com AI para determinar expulsões automáticas — pontuações de 0,75 ou mais acionam a remoção quando a detecção de spam por AI está ativada. Use os relatórios de inteligência para investigar usuários suspeitos, verificar decisões de aplicação de regras ou avaliar se usuários em casos limítrofes merecem uma segunda chance.

Feed de punições ao vivo

Monitore em tempo real a atividade de moderação em todo o sistema:

1. Acesse User Intelligence > guia Live Punishments
2. Acompanhe o fluxo de violações recentes em todos os grupos monitorados
3. Cada entrada mostra:
   • Avatar e nome do usuário
   • Tipo de violação e motivo detalhado
   • Pontuação de confiança
   • Timestamp relativo
   • Status da conexão (integridade do WebSocket)
4. Clique em qualquer punição para ver o relatório completo de inteligência do infrator

O feed ao vivo é atualizado em tempo real à medida que as violações ocorrem nos seus grupos, para que você possa ver quais violações estão acontecendo agora. Observe padrões como várias violações semelhantes de usuários diferentes (campanhas coordenadas de spam) ou tipos incomuns de violação que possam indicar novas táticas de spam.

Documentação da API pública

Acesse dados de inteligência por programação:

1. Acesse User Intelligence > guia API Documentation
2. Revise o endpoint e o formato da API REST
3. Copie exemplos de código no seu idioma preferido:
   • cURL (linha de comando)
   • JavaScript (fetch API)
   • Python (biblioteca requests)
4. Substitua o ID de usuário de exemplo pelo ID que você deseja consultar
5. Execute a solicitação para receber JSON com a classificação de spam e o nível de risco

A API pública permite integração com ferramentas externas, possibilitando fluxos de trabalho sofisticados além da interface web.

Padrões de uso no mundo real

Rotina diária de moderação

Um fluxo de trabalho diário típico de moderação usando o painel:

1. Verificação matinal (5 minutos):

   • Abrir o painel e revisar o status de todos os cartões de grupo
   • Verificar os medidores de uso da assinatura para acompanhar o consumo da cota
   • Procurar grupos com indicadores de violação elevados

2. Análise aprofundada semanal (30 minutos):

   • Revisar as estatísticas de grupo de cada grupo principal
   • Examinar a divisão das principais violações para identificar tendências
   • Verificar as estatísticas de usuários para encontrar novos membros altamente ativos
   • Revisar a inteligência de usuários para usuários com classificações de spam elevadas (0,50+)

3. Revisão estratégica mensal (60 minutos):

   • Comparar as estatísticas mês a mês
   • Ajustar os limites com base nos padrões de violação
   • Revisar o uso da assinatura para determinar se é necessário mudar de plano
   • Atualizar mensagens de boas-vindas ou regras com base na evolução da comunidade

Esse ritmo equilibra monitoramento proativo com eficiência administrativa.

Gerenciamento de vários grupos

Para administradores que gerenciam muitas comunidades:

1. Organização do painel:

   • Use a busca para localizar rapidamente grupos específicos
   • Marque como favorito ou salve nos favoritos do navegador os grupos acessados com frequência
   • Organize as abas do navegador, uma para cada grupo principal

2. Estratégia de configurações compartilhadas:

   • Desenvolva "perfis" para tipos de grupo semelhantes (por exemplo, "perfil de moderação rigorosa" para grupos profissionais, "perfil flexível" para grupos sociais)
   • Aplique configurações de limite consistentes em grupos do mesmo tipo
   • Use notas para documentar por que configurações específicas foram escolhidas

3. Inteligência centralizada:

   • Use a inteligência de usuários para identificar usuários que causam problemas em vários grupos
   • Cruze padrões de violação entre comunidades
   • Coordene ações de aplicação das regras para usuários em vários grupos relacionados

O design do painel permite escalar do gerenciamento de um único grupo à coordenação da moderação em dezenas de comunidades.

Experimentação com configurações

Ao calibrar as configurações de moderação:

1. Estabeleça uma linha de base:

   • Anote as estatísticas atuais (taxa de punição, divisão das violações)
   • Documente as configurações de limite atuais

2. Faça uma única alteração:

   • Ajuste apenas um limite por vez
   • Documente o que mudou e quando

3. Monitore o impacto (3 a 7 dias):

   • Acompanhe as estatísticas de grupo para observar mudanças nos padrões de violação
   • Revise violações específicas para verificar a qualidade

4. Avalie e itere:

   • Se houver melhora, mantenha a alteração
   • Se houver impacto negativo, reverta e tente um ajuste diferente
   • Se não estiver claro, espere mais tempo antes de avaliar

Essa abordagem metódica evita confusão sobre quais mudanças causaram quais efeitos.

Melhores práticas

Salve visualizações importantes

Embora o painel não tenha favoritos integrados, você pode adicionar páginas específicas aos favoritos do seu navegador:

• Adicione a visualização principal do Panel aos favoritos para acesso rápido
• Adicione aos favoritos páginas específicas de gerenciamento de grupos para comunidades que você verifica com frequência
• Adicione o Feed de Punições ao Vivo aos favoritos se você o monitora regularmente

Os favoritos do navegador oferecem acesso rápido sem precisar navegar por vários menus.

Use a busca de forma eficaz

As funções de busca (grupos, usuários) aceitam correspondências parciais e não diferenciam maiúsculas de minúsculas:

• Busque grupos por parte do nome: "cryp" encontra "Cryptocurrency Discussion"
• Busque usuários pelo identificador sem @: "john" encontra "@johnsmith"
• Busque usuários por palavras-chave na bio para encontrar contas relacionadas

Usar a busca de forma eficaz acelera drasticamente a navegação em instalações grandes.

Revise a experiência em dispositivos móveis

O painel é totalmente responsivo e funciona em dispositivos móveis, mas alguns recursos (especialmente estatísticas com tabelas) são mais confortáveis em telas maiores. Considere:

• Use o celular para verificações rápidas e alterações de opções
• Use desktop/tablet para análise aprofundada de estatísticas e calibração de limites
• Use o Feed de Punições ao Vivo no celular para monitorar em movimento

Diferentes tipos de dispositivo se destacam em diferentes tarefas administrativas.

Mantenha as configurações documentadas

Mantenha um documento simples (planilha, arquivo de notas) para acompanhar:

• Configurações atuais de limite para cada grupo
• Justificativa por trás de configurações específicas
• Quando as configurações foram alteradas pela última vez
• Resultados de experimentos com limites

Essa documentação cria conhecimento institucional que persiste mesmo que a composição da equipe de moderação mude.

Solução de problemas

"Não consigo ver meu grupo no painel"

Causas: Bot não adicionado ao grupo, você não é administrador, a autenticação ainda não foi atualizada

Solução: Verifique se o bot está de fato no grupo como membro. Verifique se você tem direitos de administrador nas configurações do grupo no Telegram. Tente sair e entrar novamente para atualizar a autenticação.

"As alterações não estão sendo salvas"

Causas: Problema de rede, cache do navegador, alterações simultâneas

Solução: Atualize a página para verificar se a alteração foi realmente salva. Caso contrário, tente alternar a configuração novamente. Limpe o cache do navegador se os problemas persistirem. Garanta uma conexão estável com a internet.

"Os medidores de uso mostram 'desconectado'"

Causas: Conexão WebSocket perdida, aba do navegador inativa por muito tempo

Solução: O painel deve se reconectar automaticamente em até 30 segundos. Se continuar desconectado, atualize a página. Verifique se o navegador não está com extensões que bloqueiam WebSocket ativadas.

"As estatísticas parecem desatualizadas"

Causas: Atraso no cache, alterações recentes ainda não refletidas

Solução: As estatísticas são atualizadas quase em tempo real, mas podem ter atrasos de 30 a 60 segundos. Atualize a página para garantir que você esteja vendo os dados mais recentes. Se os dados tiverem horas ou dias de atraso, isso indica um problema no sistema — reporte ao suporte.

"Não consigo acessar o portal de cobrança da Stripe"

Causas: Nenhuma assinatura ativa, navegador bloqueando pop-up

Solução: O gerenciamento do método de pagamento só funciona para assinaturas pagas ativas. Certifique-se de que seu navegador permita pop-ups do domínio do painel. Tente usar o link direto na página Histórico de cobrança em vez do botão.

Conclusão

O painel de gerenciamento do Telegram Bot App transforma a administração de bots, antes baseada em operações complexas de linha de comando, em fluxos de trabalho intuitivos de apontar e clicar, ao mesmo tempo em que oferece recursos avançados de análise e monitoramento que permitem uma gestão de comunidades orientada por dados. Seja para configurar regras básicas de proteção, ajustar limites de detecção por AI, monitorar violações em tempo real ou analisar padrões de comportamento dos usuários, o painel oferece as ferramentas de que você precisa em uma interface unificada e acessível.

Domine os recursos do painel para maximizar a eficácia da sua moderação e, ao mesmo tempo, reduzir o tempo investido. A combinação de controles simples para tarefas comuns e análises detalhadas para decisões estratégicas garante que administradores de todos os níveis de experiência possam gerenciar suas comunidades com sucesso. Explore a interface, experimente configurações enquanto monitora seus efeitos por meio das estatísticas e desenvolva fluxos de trabalho administrativos que atendam às necessidades específicas da sua comunidade.