Um bot não consegue fazer nada dentro de um canal do Telegram até que você o adicione explicitamente e conceda permissões — diferente de um grupo comum, apenas estar presente em um canal não basta. O processo é simples assim que se entendem as duas etapas distintas envolvidas, e acertar a etapa das permissões importa mais do que a maioria imagina no início.
Por que adicionar um bot é um processo em duas etapas
Adicionar um bot a um canal são, na verdade, duas ações separadas: torná-lo membro e depois promovê-lo a administrador com um conjunto definido de direitos. Um bot que é apenas membro de um canal consegue ler aquilo a que tem acesso, mas não consegue publicar, editar ou moderar nada — os canais não permitem que membros comuns publiquem, sejam bots ou pessoas, então direitos de administrador são a única forma de um bot fazer um trabalho útil ali.
Etapa 1: adicione o bot como membro
Abra o canal, vá até as informações do canal, abra a lista de membros ou assinantes e adicione o bot da mesma forma que adicionaria uma pessoa — pesquisando o nome de usuário dele. A maioria dos bots precisa ser pesquisável e ter sido iniciada pelo menos uma vez antes de poder ser adicionada dessa forma, então certifique-se de que o bot foi inicializado antes de tentar adicioná-lo a um canal.
Etapa 2: promova-o a administrador com permissões específicas
Na lista de administradores, promova o bot e abra as configurações de permissões dele. Conceda apenas o que ele realmente precisa para sua função: Publicar mensagens se precisar publicar conteúdo, Editar mensagens se precisar modificar publicações existentes, Excluir mensagens se precisar remover conteúdo. Deixe todos os demais controles desligados — banir usuários, convidar por link, fixar mensagens, gerenciar o próprio canal, adicionar outros administradores — a menos que a função específica do bot realmente exija isso.
Casos de uso comuns para bots de canal
Bots de publicação automática e agendamento precisam de Publicar mensagens e frequentemente de Editar mensagens, já que costumam enfileirar conteúdo e publicá-lo em um horário definido. Bots de moderação de comentários operam principalmente no grupo de discussão vinculado, e não no canal em si, e precisam de Excluir mensagens e, às vezes, de direitos de banimento restritos a esse grupo. Bots de análise e relatórios estatísticos frequentemente não precisam de nenhum direito de publicação — só precisam ler a atividade do canal, o que a própria condição de membro já garante na maioria dos casos.
Por que conceder permissões demais é um risco
O acesso de um bot só é tão confiável quanto o código e a conta por trás dele, e, diferente de um administrador humano, um token de bot comprometido pode ser usado por qualquer um que o obtenha, instantaneamente e em qualquer escala. Um bot com direitos de administrador completos que na verdade só precisava publicar mensagens representa um risco muito maior do que um restrito exatamente ao que faz — se o token vazar ou o serviço por trás do bot for comprometido, o dano fica limitado às permissões realmente concedidas.
Revisar e remover bots que você não usa mais
Percorra a lista de administradores periodicamente e verifique o que cada bot realmente pode fazer em comparação com para que ainda está sendo usado. Um bot conectado a um fluxo de trabalho descontinuado, a uma integração antiga que você não usa mais, ou a uma configuração de teste de meses atrás deve ser rebaixado ou removido por completo, em vez de deixado com permissões permanentes que ninguém monitora.
Solução de problemas comuns
Se um bot não aparecer ao pesquisar para adicioná-lo, confirme que ele realmente foi iniciado pelo menos uma vez e que o nome de usuário foi digitado corretamente — bots com os quais nunca houve interação costumam não ser encontrados pela pesquisa. Se o bot foi adicionado mas não consegue publicar, a causa quase universal é a falta da permissão Publicar mensagens em seu papel de administrador, e não algo errado no próprio bot; verifique primeiro esse controle antes de investigar o código ou a configuração do bot. Também ajuda lembrar que canais e grupos se comportam de forma diferente para bots — um bot com direitos completos em um grupo de discussão vinculado não tem direitos automáticos no canal principal, e os dois precisam ser configurados separadamente.