Todo o bot do Telegram - quer arquive multimédia, publique num horário agendado ou responda no apoio ao cliente - começa da mesma forma: uma conversa de dois minutos com o @BotFather. Este guia mostra como criar o teu primeiro bot, obter o token com segurança e que configurações vale a pena mudar antes de o bot começar a trabalhar.
O BotFather é o bot oficial do Telegram para gerir bots - é através dele que todos os bots do Telegram são criados, mesmo os maiores. Falas com ele através de comandos simples, como com qualquer outro contacto, e como resposta recebes um token: uma sequência privada de letras e números que funciona como palavra-passe do bot.
Até este ponto não precisas de escrever nenhum código. O código (ou uma ferramenta no-code) só entra em cena mais tarde, quando decidires o que o bot deve realmente fazer.
Abre o Telegram, procura por @BotFather (tem o selo azul de verificado - confirma que é a conta oficial) e toca em Start.
Envia o comando /newbot. O BotFather vai pedir duas coisas: um nome de exibição (o que os utilizadores veem, pode ser alterado depois) e um nome de utilizador - tem de ser único e terminar em «bot», por exemplo mygroup_arquivo_bot.
Depois disso, o BotFather envia o token - uma sequência parecida com 123456789:AAExemploDeTokenNaoPartilhar. É a única mensagem em todo o processo que realmente precisas de guardar.
A forma de adicionar o bot depende de onde ele vai atuar. Num grupo, adicionas o bot como qualquer outro membro a partir da lista de participantes. Num canal, tem obrigatoriamente de ser adicionado como administrador - os canais só entregam publicações a bots com privilégios de administrador, um membro normal não vê nada.
Um bot adicionado a um grupo, por predefinição, só vê mensagens que começam com um comando (como /start) - este é o modo de privacidade, que protege a conversa normal de ser lida por todos os bots do grupo. Se o bot precisar de ver mesmo tudo o que é publicado (por exemplo, para arquivar cada foto, não só comandos), tens de desativar este modo.
Escreve novamente ao @BotFather, envia /mybots, escolhe o teu bot, depois Bot Settings → Group Privacy → Turn off. A alteração aplica-se apenas a mensagens novas a partir desse momento - o que o bot perdeu antes não aparece retroativamente.
Um token sozinho não faz nada - é uma credencial, não um programa. A partir daqui, ou escreves código contra a Bot API do Telegram, ou colas o token numa ferramenta no-code que já sabe o que fazer com ele. Por exemplo, ao colar o token no ecrã «ligar bot» do KSLAB, obténs em cerca de um minuto um bot de arquivo de multimédia - sem alojamento e sem código.
Queres que o bot guarde automaticamente cada foto e vídeo de um grupo? Lê o guia de arquivo de multimédia.
Precisas de publicação automática e agendada num canal? Lê o guia de agendamento de publicações.
Sim. O BotFather e a Bot API são gratuitos e sem limites por parte do Telegram. Pode haver custo apenas na ferramenta ou alojamento a que ligas o token - consoante o que o bot deve fazer.
O nome de exibição pode ser alterado a qualquer momento através de @BotFather → /mybots. O nome de utilizador também pode ser alterado, mas só se o novo estiver livre e ninguém mais o tiver utilizado.
O token do bot autentica uma conta de bot e basta para quase todos os usos, incluindo arquivo de multimédia e publicação agendada. O par API ID/hash é para aplicações que iniciam sessão como uma conta de utilizador completa - um cenário mais sensível de que quase ninguém precisa.
A causa mais comum é o modo de privacidade continuar ativado. Desativa-o através de BotFather → o teu bot → Bot Settings → Group Privacy → Turn off, e depois pede a alguém que escreva uma mensagem nova - retroativamente o bot não verá nada.