Por que um bot não vê nada por padrão
O Telegram protege as conversas em grupo contra bots. A menos que um bot seja administrador ou que o modo de privacidade esteja desativado para ele, o bot não recebe nenhuma mensagem comum. Essa única configuração explica a maioria dos relatos sobre bots de moderação que parecem não fazer nada: o bot não está com defeito, ele não tem acesso às mensagens.
As permissões importantes
Excluir mensagens é a permissão necessária para o antispam e os filtros. Restringir membros abrange advertências, silenciamentos e banimentos. Fixar mensagens serve para anúncios. Convidar usuários é importante se você usa links de convite ou verificações de entrada que voltam a adicionar pessoas.
Conceda apenas as permissões necessárias aos módulos que você ativou. Um bot com todas as permissões representa um problema maior caso seu token vaze.
Administrador ou modo de privacidade
Ambos resolvem o mesmo problema de formas diferentes. Tornar o bot administrador é a opção habitual e a escolha da maioria dos grupos. Desativar o modo de privacidade no BotFather é a alternativa para um bot que você não deseja promover a administrador. Nos dois casos, o bot precisa ter acesso às mensagens para que a moderação ou as análises possam agir sobre elas.
O que verificar quando um módulo parece não funcionar
Verifique primeiro se o bot é administrador, depois a permissão específica de que o módulo precisa e, por fim, se o módulo está ativado para aquele grupo. Nessa ordem. Quase sempre o problema está no primeiro item.
Como manter o token seguro
O token de um bot é a senha dele. Na plataforma, os tokens são criptografados em repouso com AES-256, e colar um token em uma captura de tela pode comprometer um grupo. Se isso acontecer, revogue o token no BotFather e refaça a conexão.