Como adicionar um bot a um grupo ou canal do Telegram

Resumo. Grupo: página de informações → Adicionar membros → @usuário exato → confirmar; se modera, promova a admin. Canal: bot entra só como administrador. O que os guias pulam: bot sem admin no privacy mode padrão vê apenas os comandos dirigidos a ele; bot admin vê tudo, menos outros bots; permissão se concede no mínimo; e bot tem teto de 20 mensagens por minuto por grupo — é aí que mora quase todo mistério de “meu bot parou de responder”.

Adicionar o bot é os 5% fáceis: três toques e um nome de usuário. Os outros 95% dos problemas chegam depois — permissões, visibilidade, limites. Está tudo abaixo, na ordem em que você vai tropeçar.

Bot no grupo

1. Abra o grupo e toque no nome: abre a página de informações.
2. Adicionar membros.
3. Busque o nome de usuário exato — sempre termina em bot. Pelo identificador, não pelo nome de exibição: bot impostor viaja com nome parecido, e só o identificador é único.
4. Confirme: o bot aparece na lista como qualquer membro.

Se ele deve fazer mais do que responder comando — apagar spam, saudar quem chega, filtrar comentários — siga direto:

5. Informações → Administradores → Adicionar administrador → escolha o bot.
6. Permissões no mínimo: moderador precisa de Apagar mensagens e Banir usuários; não precisa de Alterar informações do grupo nem Adicionar administradores. Cada caixa desmarcada é superfície de ataque que você não carrega.

Bot no canal

Canal não tem lista de membros onde bot possa sentar: bot entra em canal apenas como administrador — informações do canal → Administradores → Adicionar administrador → usuário → permissões.

Bot que publica precisa de Publicar mensagens; um bot editor, além disso, de editar mensagens alheias, se gerencia posts que não criou. Os comentários moram no grupo de discussão vinculado, então o bot que os protege é adicionado a esse grupo — o assento de admin no canal, sozinho, não cobre. O esquema completo dessa bifurcação está em moderação de comentários.

Privacy mode: por que o bot “não vê” o chat

Por padrão, todo bot roda em privacy mode: dentro de um grupo ele recebe só os comandos dirigidos a ele (/comando@seu_bot), as respostas às próprias mensagens e alguns eventos de serviço. A conversa ele não lê. É recurso, não defeito — os membros não deveriam supor um leitor invisível —, mas significa que um filtro antispam instalado como membro comum não filtra nada.

Duas saídas: promover o bot a admin (admins recebem tudo, menos mensagens de outros bots — para moderação, é o estado previsto) ou o desenvolvedor desligar o privacy mode no BotFather. A via do admin é mais transparente para os membros: a lista de administradores é pública.

Corolário que vale saber: nenhum bot, nunca, lê um grupo em que não está. A versão assustadora de “bots leem suas conversas” não é como a plataforma funciona.

Limites fantasiados de bug

• 20 mensagens por minuto por grupo. Saudação, resposta a comando e resumo dividem um único orçamento. Sob carga o bot enfileira — de fora, parece “parou de funcionar e depois alcançou”.
• ~1 mensagem por segundo no privado — por isso um disparo para os membros goteja em vez de detonar.
• Teto de bots por grupo. Se adicionar falha com o resto tudo certo, remova os bots que ninguém usa desde o ano passado e tente de novo.

Um bot ou um zoológico

A montagem clássica é uma pilha: um saúda, outro filtra spam, outro cuida dos filtros de comentários, outro publica. Cada um é um assento de admin à parte, um operador à parte para confiar e uma fatia à parte do orçamento de 20 mensagens.

A alternativa consolidada: um único bot que carrega moderação e proteção, fluxos de boas-vindas e respostas com IA às perguntas dos membros num assento só, com uma só concessão de permissões. Menos assentos para auditar é argumento de segurança, não só de conveniência. Prefere construir o seu? Criar um bot sem código cobre o lado do BotFather.

Checklist de segurança antes de conceder admin

• Identifique o operador. Bot é um programa que alguém roda; esse alguém passa a receber as mensagens do grupo assim que o bot vira admin. Sem desenvolvedor identificável, sem assento.
• Permissões mínimas, revisão trimestral. A lista de Administradores é sua superfície de auditoria; pode os bots que já não merecem o assento.
• Cuidado com sósias. Confira o identificador exato no site ou canal do desenvolvedor, não nos resultados de busca.
• Remover é instantâneo e total. Rebaixou ou removeu, o acesso acabou naquele segundo — nada sobrevive.

---

O comportamento de plataforma citado aqui — as regras de visibilidade do privacy mode, bots admin recebendo tudo menos mensagens de outros bots e o limite de 20 mensagens por minuto — vem do Bot FAQ do Telegram.