Blog 8 min de leitura

Permissões de bots do Telegram explicadas: o que cada uma realmente significa

Alex Morgan

Alex Morgan

Publicado em 15.07.2026

Permissões de bots do Telegram explicadas: o que cada uma realmente significa

Já falamos sobre a importância de verificar se as permissões que um bot pede combinam com a função que ele diz ter antes de confiar nele, mas esse conselho só funciona se você entender o que cada permissão faz. O sistema de permissões do Telegram tem mais camadas do que a maioria imagina, e os nomes que o Telegram usa internamente (manage_topics, anonymous, manage_ranks) nem sempre são autoexplicativos. Esta é uma referência em linguagem simples sobre o que você está realmente autorizando.

Dois sistemas de permissões diferentes, não um só

A primeira coisa a entender é que “permissões de bot” no Telegram são, na verdade, duas coisas separadas:

  1. Direitos de administrador — o mesmo sistema de permissões usado para administradores humanos de grupos e canais, que também pode ser concedido a um bot se você o tornar administrador.
  2. Visibilidade das mensagens (modo de privacidade) — uma configuração separada, no nível da API, que controla se o bot chega a ver as mensagens enviadas em um grupo, independentemente de ser administrador.

A maioria dos guias fala só da primeira. As duas importam.

Direitos de administrador, um por um

Estas são as permissões de administrador definidas pelo próprio Telegram (as mesmas que você vê ao tornar uma pessoa administradora). Qualquer bot pode pedir algumas ou todas ao ser adicionado a um grupo ou canal.

PermissãoO que ela realmente permite ao bot
Alterar informaçõesEditar o nome, a descrição e a foto do grupo ou canal
Publicar mensagensEnviar mensagens em nome do próprio canal (só em canais)
Editar mensagensEditar qualquer mensagem já enviada no chat, inclusive de outras pessoas
Apagar mensagensRemover qualquer mensagem do chat
Banir usuáriosRemover membros e impedir que voltem
Convidar usuáriosGerar links de convite e adicionar novos membros
Fixar mensagensFixar e desafixar mensagens no topo do chat
Adicionar administradoresTornar outros usuários (ou bots) administradores — provavelmente a permissão de maior confiança desta lista
AnônimoPublicar e agir sem que as ações sejam atribuídas ao bot na lista de membros
Gerenciar chats de vozIniciar, encerrar ou moderar chats de voz e vídeo no grupo
Gerenciar tópicosCriar, editar e fechar tópicos em grupos no formato de fórum
Gerenciar mensagens diretasLidar com mensagens diretas enviadas a um canal
Gerenciar títulosAtribuir títulos personalizados a outros administradores

Algumas delas merecem atenção redobrada. “Adicionar administradores” significa, na prática, que o bot poderia dar a si mesmo ou a outra conta o controle total do seu grupo, e raramente há um bom motivo para um bot de moderação ou utilitário precisar disso. “Apagar mensagens” junto com “Banir usuários” é uma combinação comum e razoável para um bot de moderação, mas a mesma combinação em um bot sem função clara de moderação é uma incoerência que vale questionar, exatamente o tipo de checagem que descrevemos no nosso guia para identificar bots falsos ou abandonados.

Modo de privacidade: a permissão que quase ninguém sabe que existe

Além dos direitos de administrador, todo bot do Telegram tem uma configuração chamada modo de privacidade, controlada pelo próprio desenvolvedor do bot pelo @BotFather, e não algo que você concede como usuário.

  • Modo de privacidade ATIVADO (padrão): o bot só recebe mensagens que são comandos (começando com /), respostas diretas a uma de suas mensagens ou que o mencionam pelo nome de usuário. Ele não vê o resto da conversa do grupo.
  • Modo de privacidade DESATIVADO: o bot recebe todas as mensagens enviadas no grupo, por inteiro, sejam ou não dirigidas a ele.

Isso importa muito no caso dos bots com IA. Um bot que resume as conversas do grupo ou responde perguntas com base no contexto do chat precisa do modo de privacidade desativado para funcionar, e esse é um motivo legítimo para desativá-lo. Mas isso também significa que o bot processa todas as mensagens do grupo, e não só as dirigidas a ele, algo que vale saber antes que você ou sua comunidade tratem a presença do bot como ruído de fundo.

O que fazer: se um grupo em que você está adicionar um bot de IA, é justo perguntar ao administrador (ou consultar a documentação do bot) se o modo de privacidade está ativado ou desativado. Essa única configuração provavelmente pesa mais na sua privacidade real do que a maior parte da lista de direitos de administrador acima.

Permissões que existem fora do sistema do Telegram

Algumas das permissões com mais consequências que um bot pode pedir nem fazem parte do sistema de direitos de administrador do Telegram: elas são pedidas dentro da própria conversa com o bot, normalmente por um mini app ou uma visualização web vinculada.

Permissões de conexão de carteira / TON Connect. Bots cripto costumam pedir que você vincule uma carteira, o que pode ir de ver o saldo em modo somente leitura até ter autoridade total para assinar transações. Como mostramos no artigo sobre as Agentic Wallets da TON, algumas ferramentas mais novas baseadas em agentes pedem uma carteira dedicada, com saldo e orçamento de gastos, em vez de acesso à sua carteira principal: uma estrutura de permissões bem diferente (e em geral mais segura) do que entregar o controle total da carteira.

Compartilhamento de contato e número de telefone. A Bot API do Telegram permite que um bot peça seu número de telefone ou cartão de contato, mas só por meio de um botão explícito e visível de “Compartilhar contato”: ele não consegue puxar esses dados em silêncio. Se um bot diz que já tem seu número sem que você nunca tenha tocado nesse botão, isso é um sinal de alerta, não um recurso.

Compartilhamento de localização. Também depende de uma ação explícita de compartilhar: um bot não consegue acessar sua localização de forma passiva.

Pagamentos. A Bot Payments API do Telegram permite que um bot peça um pagamento único pelo fluxo de pagamento do próprio Telegram, o que é diferente (e em geral mais seguro) de um bot pedir que você envie criptomoedas direto para um endereço de carteira ou digite dados do cartão em um site vinculado.

Guia prático: do que cada tipo de bot realmente precisa?

Tipo de botRazoável pedirVale questionar
Chatbot de IA (só perguntas e respostas)Nada além do acesso básico às mensagensDireitos de administrador, acesso à carteira, compartilhamento de contato
Agente pessoalModo de privacidade desativado (para contexto), integrações de agenda ou lembretes que você ative explicitamenteAdicionar administradores, acesso à carteira sem explicação
Bot de moderação de grupos e equipesApagar mensagens, Banir usuários, Fixar mensagens, modo de privacidade desativadoAdicionar administradores (a menos que seja especificamente uma ferramenta de gestão de coadministradores), Gerenciar títulos
Bot de IA para criptoSaldo da carteira em modo somente leitura, ou uma carteira de agente dedicada, com saldo e limite de gastosAutoridade total de assinatura na carteira sem limite de gastos, pedidos para enviar fundos para “verificar” ou “desbloquear” algo
Bot de geração de imagens ou vídeosNada além do prompt que você enviaDireitos de administrador no grupo, acesso ao histórico de mensagens, compartilhamento de contato

Perguntas frequentes

Um bot pode ler minhas mensagens privadas com outras pessoas?

Não. Um bot só vê as mensagens enviadas diretamente a ele em um chat privado ou as mensagens de um grupo em que ele está, e mesmo assim só de acordo com a configuração do modo de privacidade. Bots não conseguem acessar suas outras conversas privadas.

Se eu tornar um bot administrador, ele consegue ver mensagens enviadas antes de ele entrar?

Não. Os direitos de administrador controlam o que o bot pode fazer daqui para frente (apagar, banir, fixar etc.); eles não dão acesso retroativo ao histórico de mensagens de antes de o bot entrar no grupo.

Desativar o modo de privacidade significa que o desenvolvedor do bot lê minhas mensagens pessoalmente?

Não necessariamente: significa que o software do bot processa essas mensagens, normalmente para gerar uma resposta ou um resumo. Se algum humano chega a revisar esses dados, e se eles são armazenados, depende totalmente da política de privacidade do bot; por isso conferir essa política importa tanto quanto conferir a própria permissão.

Em algum caso faz sentido um bot ter a permissão “Adicionar administradores”?

Só em casos bem específicos, por exemplo um bot dedicado à gestão de administradores, cuja função inteira é promover e organizar sua equipe de moderação. Para quase qualquer outro tipo de bot, há poucos motivos legítimos para concedê-la.