Todo bot do Telegram - seja para arquivar mídia, postar em horário programado ou responder no suporte - começa da mesma forma: uma conversa de dois minutos com o @BotFather. Este guia mostra como criar seu primeiro bot, pegar o token com segurança e quais configurações vale a pena mudar antes de colocar o bot para trabalhar.
O BotFather é o bot oficial do Telegram para gerenciar bots - é por meio dele que todos os bots do Telegram são criados, até os maiores. Você conversa com ele por comandos simples, como com qualquer outro contato, e recebe de volta um token: uma sequência privada de letras e números que funciona como senha do bot.
Até esse ponto você não precisa escrever nenhum código. Código (ou uma ferramenta no-code) só entra em cena depois, quando você decide o que o bot vai fazer de fato.
Abra o Telegram, procure por @BotFather (ele tem o selo azul de verificado - confira se é a conta oficial) e toque em Start.
Envie o comando /newbot. O BotFather vai pedir duas coisas: um nome de exibição (o que os usuários veem, dá para mudar depois) e um nome de usuário - precisa ser único e terminar em "bot", por exemplo mygroup_arquivo_bot.
Depois disso, o BotFather envia o token - uma sequência parecida com 123456789:AAExemploDeTokenNaoCompartilhe. Essa é a única mensagem de todo o processo que você realmente precisa guardar.
Como você adiciona o bot depende de onde ele vai atuar. Em um grupo, adicione o bot como qualquer outro membro pela lista de participantes. Em um canal, ele precisa obrigatoriamente ser adicionado como administrador - canais só entregam publicações para bots com privilégios de administrador, um membro comum não vê nada.
Por padrão, um bot adicionado a um grupo só vê mensagens que começam com um comando (como /start) - isso é o modo de privacidade, que protege a conversa comum de ser lida por todos os bots do grupo. Se o bot precisa ver tudo que é postado (por exemplo, para arquivar cada foto, não só comandos), você precisa desativar esse modo.
Fale com o @BotFather de novo, envie /mybots, escolha o seu bot, depois Bot Settings → Group Privacy → Turn off. A mudança só vale para mensagens novas a partir dali - 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 você escreve código usando a Bot API do Telegram, ou cola o token em uma ferramenta no-code que já sabe o que fazer com ele. Por exemplo, colando o token na tela de "conectar bot" do KSLAB, ele vira um bot de arquivamento de mídia em cerca de um minuto - sem hospedagem e sem código.
Quer que o bot salve automaticamente cada foto e vídeo de um grupo? Leia o guia de arquivamento de mídia.
Precisa de postagem automática programada em um canal? Leia o guia de agendamento de posts.
Sim. O BotFather e a Bot API são gratuitos e sem limite de uso por parte do Telegram. O que pode ter custo é a ferramenta ou hospedagem à qual você conecta o token - depende do que o bot vai fazer.
O nome de exibição pode ser mudado a qualquer momento pelo @BotFather → /mybots. O nome de usuário também pode ser trocado, mas só se o novo estiver livre e ninguém mais tiver usado.
O token do bot autentica uma conta de bot e basta para quase todos os usos, incluindo arquivamento de mídia e postagem programada. O par API ID/hash é para aplicações que fazem login como uma conta de usuário completa - um cenário mais sensível que quase ninguém precisa.
A causa mais comum é o modo de privacidade ainda ativado. Desative pelo BotFather → seu bot → Bot Settings → Group Privacy → Turn off, e depois peça para alguém mandar uma mensagem nova - retroativamente o bot não vê nada.