Como criar um bot do Telegram e adicioná-lo ao seu canal
Adicione um bot ao seu canal do Telegram como administrador que pode publicar: crie-o com o @BotFather, proteja o token, teste-o e corrija-o quando as publicações não chegam.
Para adicionar um bot a um canal do Telegram, torne-o administrador do canal: abra as informações do canal, adicione um administrador, procure o nome de utilizador do bot e ative a permissão para publicar mensagens (Post messages). Se precisar de um bot próprio, crie-o primeiro com o @BotFather e guarde o token que ele lhe dá. Depois, envie uma publicação de teste antes de contar com ele.
Este guia trata do bot, do token, das permissões, de uma publicação de teste e da resolução de problemas, não da programação de bots. O Studio e outras ferramentas que publicam através de um bot seu precisam desta mesma configuração. Para horários e publicações agendadas que falharam, veja o guia de agendamento no Telegram.
O que um bot pode fazer num canal
Um bot é uma conta especial do Telegram que não precisa de número de telefone. Quem tiver o token pode pô-lo a publicar.
Um bot não pode ser subscritor de um canal, apenas administrador. Publicar é uma das permissões que lhe dá, e as publicações dele são assinadas com o nome do canal.
O exemplo deste guia é inventado: uma oficina de cerâmica gere o canal público Olaria da Rua do Cais e quer um bot que publique o calendário das cozeduras.
Crie o bot com o @BotFather
O guia do BotFather do Telegram descreve os passos:
- Abra o @BotFather no Telegram e confirme que o nome está escrito exatamente assim.
- Envie
/newbot. - Introduza um nome. Pode alterá-lo mais tarde.
- Introduza um nome de utilizador: entre 5 e 32 letras latinas, números ou sublinhados, a terminar em «bot». Não o poderá alterar mais tarde.
- Copie o token da resposta. Tem o formato
123456789:AAF….
A oficina chama ao bot Avisos Olaria do Cais, com o nome de utilizador @olaria_cais_avisos_bot. Escolha um nome que os seus colegas reconheçam na lista de administradores.
Guarde o token do bot em segurança
O Telegram avisa que qualquer pessoa com o token pode controlar o seu bot. Trate-o como uma palavra-passe:
- Guarde-o num gestor de palavras-passe.
- Cole-o apenas na ferramenta que está a ligar.
- Mantenha-o fora de capturas de ecrã, conversas, pedidos de suporte e documentos partilhados.
- Não o partilhe para que outras pessoas possam publicar. Em vez disso, dê-lhes acesso na ferramenta de publicação (veja como partilhar contas de redes sociais com uma equipa).
Se o token ficar exposto, revogue-o no @BotFather, onde /mybots abre as definições do seu bot. Recebe um token novo e o antigo deixa de funcionar, por isso atualize todas as ferramentas que o usavam.
No exemplo, quem gere a oficina cola o token por engano num documento partilhado; depois revoga-o e volta a ligar a ferramenta com o token novo.
Adicione o bot ao canal como administrador
Abra as informações do canal e vá à lista de administradores (em algumas aplicações, fica na gestão do canal, «Manage Channel»; os nomes variam). Escolha adicionar um administrador e procure o nome de utilizador do bot.
O Telegram pergunta depois que permissões de administrador quer dar. Ative apenas aquilo de que a sua ferramenta precisa e guarde:
| Permissão | O que permite | Para um bot que publica? |
|---|---|---|
| Publicar mensagens (Post messages) | Publicar em nome do canal e apagar as publicações recentes que o próprio bot enviou | Sim, obrigatória |
| Editar mensagens (Edit messages) | Afixar publicações e editar as que o bot não enviou | Só se a ferramenta precisar |
| Apagar mensagens (Delete messages) | Apagar publicações que o bot não enviou | Só se a ferramenta precisar |
| Alterar as informações do canal, convidar utilizadores, adicionar administradores (Change channel info, invite users, add admins) | Gerir o próprio canal | Não |
O bot da Olaria da Rua do Cais recebe a permissão para publicar mensagens e mais nenhuma.
Num grupo, pelo contrário, adicione o bot como membro. Nesse caso, publica com o próprio nome e só precisa de permissões de administrador se o grupo impedir os membros de enviar mensagens.
Envie uma publicação de teste e verifique-a
A partir da ferramenta que ligou, envie um teste curto e claramente identificado, como «Teste: calendário das cozeduras, por favor ignore». Os subscritores podem vê-lo, por isso mantenha-o inofensivo. Depois, verifique:
- Apareceu no canal certo, e não num canal com um nome parecido.
- Está assinado com o nome do canal (Olaria da Rua do Cais, no exemplo).
- As ligações e as fotografias, se as for publicar, aparecem como espera.
No fim, apague os testes. Num canal, as publicações apagadas desaparecem para todos os subscritores.
Resolva os problemas de um bot que não consegue publicar
| O que vê | O que fazer |
|---|---|
| O bot não entra como subscritor | Adicione-o como administrador com permissão para publicar mensagens |
| O bot é administrador, mas não chega nada | Ative a permissão para publicar mensagens (Post messages) |
| A ferramenta rejeita o token | Copie-o de novo, ou use o novo se revogou o antigo |
| As publicações saíam e deixaram de sair | Verifique o token, a lista de administradores e as permissões do bot |
| A publicação foi para a conversa errada | Volte a ligar a ferramenta ao canal certo |
Se a configuração estiver correta, mas uma publicação agendada não tiver chegado, use a lista de verificação para publicações que falharam.
No Studio, ligar o Telegram leva três passos: crie o bot com o @BotFather, cole o token (o Studio verifica-o e mostra o nome do bot) e depois prima «Adicionar a um canal». O seletor do próprio Telegram adiciona o bot como administrador com permissão para publicar, editar e apagar mensagens, e o canal aparece sozinho no Studio. «Usar um grupo em vez disso» liga um grupo. Se o token deixar de funcionar, o Studio mostra «Voltar a ligar» na conta. Voltar a ligar repete os mesmos passos com um token novo. O Studio ainda não está disponível, mas pode juntar-se à lista de espera.
