Voltar ao Blog
Glossário4 de novembro de 20262 min read

Por que seu bot do Telegram não consegue ver as mensagens do grupo

Tudo está configurado, o bot é administrador e nada acontece. A causa costuma ser uma configuração do Telegram que não tem relação com a sua configuração do bot.

Por que seu bot do Telegram não consegue ver as mensagens do grupo

O Telegram oferece aos bots uma configuração de privacidade ativada por padrão. Enquanto ela estiver ativada, seu bot só recebe mensagens dirigidas a ele: comandos e respostas. As conversas comuns do grupo nunca chegam até ele, então a moderação e as análises ficam sem dados para trabalhar. Você pode desativar essa configuração no BotFather para um bot criado por você, e o grupo passa a ficar visível a partir desse momento.

O que essa configuração faz

Todo bot tem um modo de privacidade controlado pelo proprietário no BotFather. Enquanto ele está ativado, o Telegram entrega apenas as mensagens relacionadas ao bot: comandos, respostas a ele e menções. Tudo o mais que as pessoas dizem no grupo fica oculto para o bot.

Essa é uma proteção intencional do Telegram, e não uma falha. Isso também significa que um bot adicionado para moderar o grupo não vê quase nada até que essa configuração seja alterada.

Como o problema se manifesta

Os sintomas não revelam a causa, e é por isso que tanta gente perde uma noite tentando resolver o problema. O antispam nunca entra em ação. As análises mostram pouquíssimas mensagens, embora o grupo esteja claramente movimentado. Os filtros de palavras deixam passar o que deveriam bloquear. Tudo está configurado corretamente do seu lado, e o bot é administrador, então a busca pela solução passa por todos os lugares, menos pelo único em que deveria começar.

Como alterar a configuração

Abra o BotFather, selecione seu bot, acesse as configurações dele e desative a privacidade de grupo. Depois, remova o bot do grupo e adicione-o novamente, pois a permissão passa a valer para a entrega de mensagens a partir desse momento.

Se você não criou o bot, apenas a conta que o criou pode fazer essa alteração. Por isso, um bot emprestado de outra pessoa continua com acesso limitado até que ela altere a configuração.

O que o bot passa a ler e o que ele não lê

Com a privacidade desativada, o bot recebe as mensagens do grupo para que os módulos que você ativou possam atuar sobre elas: moderação, filtros e análises. Ele as lê apenas para executar essas funções, e o prazo de retenção das mensagens armazenadas continua valendo. Ao desativar um módulo, a leitura das mensagens deixa de ser usada por ele.

O que essa escolha implica, sem rodeios

Um bot que não consegue ler as mensagens do grupo não consegue moderá-lo. Se isso não for confortável para você, mantenha a privacidade ativada e use o bot para comandos, boas-vindas e a loja, que funcionam em ambos os casos. Escolher a versão limitada de propósito é perfeitamente razoável; o que vale evitar é escolhê-la sem perceber e concluir que a moderação não funciona.

Perguntas frequentes

Onde fica essa configuração?

No BotFather, nas configurações do seu bot, na opção de privacidade de grupo. Apenas a conta que criou o bot pode alterá-la.

Preciso adicionar o bot novamente depois?

Sim. Remova o bot do grupo e adicione-o novamente, pois a entrega de mensagens muda a partir desse momento.

O bot vai ler tudo o que as pessoas dizem?

Ele recebe as mensagens do grupo para que os módulos que você ativou, como moderação e análises, possam atuar sobre elas. As mensagens armazenadas são excluídas após o período de retenção.

Posso moderar o grupo com a privacidade ativada?

Não. A moderação precisa ter acesso às mensagens. Comandos, boas-vindas e a loja no Mini App funcionam com a privacidade ativada.

Compartilhar este artigo