Voltar ao Blog
Guias7 de novembro de 20261 min read

O seu bot do Telegram deixou de responder: o que verificar

Um bot que funcionava ontem quase nunca deixa de funcionar por um motivo invulgar. Estas são as seis causas, pela ordem em que vale a pena verificá-las.

O seu bot do Telegram deixou de responder: o que verificar

Verifique por esta ordem: o bot continua a ser administrador nessa conversa, a privacidade do grupo está desativada para o bot, o módulo que pretende usar está realmente ativo nesse canal, o token continua válido, ultrapassou algum limite do plano e o bot responde a um comando direto. Cinco das seis causas são questões de configuração, e seguir esta ordem permite poupar tempo.

Primeiro: permissões de administrador

Comece por aqui, porque é o problema mais frequente e passa despercebido. Alguém reorganiza os administradores ou volta a adicionar o bot sem lhe dar as permissões necessárias, e tudo o que depende dessas permissões deixa de funcionar sem qualquer aviso. Um bot pode estar num grupo, parecer ativo e não conseguir fazer nada.

Segundo: a definição de privacidade do grupo

Se a moderação e as estatísticas não detetam nada, mas os comandos continuam a funcionar, a causa é quase sempre esta. Enquanto o modo de privacidade está ativo, o Telegram não envia as mensagens normais do grupo aos bots, e este modo está ativo por predefinição. Quem criou o bot pode alterar esta definição no BotFather.

Terceiro: o módulo está ativo nesse canal?

Os módulos são ativados por canal. Uma definição que ativou num grupo não fica ativa no seguinte, e um novo canal começa sem nada ativado. Abra o canal no painel de controlo em vez de confiar no que se lembra de ter configurado noutro.

Quarto: o token

Se o token for revogado ou gerado novamente no BotFather, o bot fica sem ligação. Se o substituiu por qualquer motivo, tem de o atualizar no local onde ligou o bot.

Quinto: um limite do plano

Os limites são verificados antes de uma ação, por isso, quando ultrapassa um limite, parece que o bot se recusa a agir, e não que deixou de funcionar. Conte os canais que gere e lembre-se de que uma loja também ocupa uma vaga.

Sexto: fale diretamente com o bot

Envie-lhe um comando numa conversa privada. Se responder, o bot e o token estão a funcionar corretamente, e o problema está numa permissão ou definição da conversa onde estava a testar. Se não responder, o problema está no próprio bot, o que reduz as possíveis causas acima ao token e à ligação.

Perguntas frequentes

Qual é o problema mais frequente?

As permissões de administrador na conversa, geralmente depois de alguém reorganizar os administradores ou voltar a adicionar o bot sem lhe dar as permissões necessárias.

Os comandos funcionam, mas a moderação não faz nada. Porquê?

A privacidade do grupo está ativa para o bot, pelo que as mensagens normais nunca lhe chegam. Quem criou o bot pode alterar esta definição no BotFather.

As definições são transferidas para um novo canal?

Não. Os módulos são ativados por canal, e um novo canal começa sem nada ativo.

Como posso saber se o problema está no próprio bot?

Envie-lhe um comando numa conversa privada. Se responder, o bot está a funcionar corretamente e o problema está na conversa onde estava a testar.

Compartilhar este artigo