Como criar um bot do Telegram para o seu canal
Todo guia manda copiar o token do BotFather e colar. Não precisa mais — o Telegram entrega o bot direto. As duas rotas e quando a antiga ainda importa.
Resumo. Procure como fazer um bot do Telegram e todos os resultados dizem a mesma coisa: abra o BotFather, envie /newbot, copie o token de API, cole em algum lugar. Durante anos foi o único jeito e deixou de ser: o Telegram consegue entregar um bot recém-criado direto para um aplicativo, então o token nem aparece na sua tela. A rota de copiar e colar continua existindo e continua importando quando você já tem um bot. Mas nenhuma das duas é a linha de chegada: um bot que não é administrador do seu canal não publica nele, e é nesse passo que as pessoas param uma jogada antes.
Quase todo guia sobre criar bot foi escrito antes de a transferência existir, e todos terminam igual: copie esta sequência longa, cole ali, não mostre para ninguém. Se você já se perguntou por que uma ferramenta pede para colar um segredo em forma de senha num formulário, a resposta é que antes não havia outro mecanismo.
Por que você precisa de um próprio
O bot aqui não é formalidade. É o que age como você: publica no seu canal, recebe pagamentos na sua conta, responde aos seus clientes com o seu nome.
Daí também a impossibilidade de usar um compartilhado. Qualquer coisa com poder suficiente para publicar no seu canal em seu nome teria poder para fazer o mesmo no de outro. Por isso a conexão é deliberadamente estreita: o AdminHub conecta apenas um bot seu, e a tentativa de conectar outro é ignorada em silêncio, não aceita pela metade.
Vale saber porque a falha é silenciosa: se você apontar outra coisa para nós, não dá erro e nada chega. Parece que a conexão deu certo e o assistente está dormindo.
A rota curta: sem token nenhum
Você toca no passo de criação e o BotFather abre com a entrega já combinada. Escolhe nome e usuário, o BotFather cria o bot, o Telegram entrega. O bot volta conectado.
Não há nada para copiar. O token existe — todo bot tem um — mas viaja entre o Telegram e o aplicativo direto, não pela sua área de transferência. Some junto o passo em que as pessoas colam um segredo na janela errada.
A rota longa: quando o bot já existe
Se o bot já existe — tem o usuário que você quer, ou seu público já o conhece — a rota certa é a do token. No BotFather: /mybots, escolha o bot, abra o token de API, copie, cole.
Essa é também a reserva automática. Se a entrega não completar por algum motivo, nada quebra e nada se perde: o aplicativo simplesmente oferece o campo de colar. As duas rotas terminam no mesmo lugar.
Um bot, muitos canais
Um workspace tem um bot ativo. Tentar criar um segundo devolve o que já existe em vez de fabricar outro.
Isso confunde quem espera «um bot por canal». Não precisa: o mesmo bot pode ser administrador em quantos canais você quiser, e tudo que você publica passa por ele.
O passo em que as pessoas param cedo demais
Criar o bot não é o mesmo que dar acesso a ele. Um bot que existe mas não é administrador do seu canal não publica lá: tem exatamente os mesmos direitos que um desconhecido.
Então a ordem é: criar o bot e depois adicioná-lo ao canal como administrador, com permissão de publicar. Se depois disso o canal não aparecer no aplicativo, quase sempre é por isso — o bot está bem, só ainda não é admin.
Se você revogar o token
Revogar ou redefinir o token no BotFather desconecta o bot, e é exatamente para isso que revogar serve: é o mecanismo pelo qual o dono corta o acesso de um aplicativo ao seu bot. Nada é apagado; a conexão é cortada.
Para reconectar, pegue o token novo no BotFather (/mybots → API Token) e cole. Bom motivo para conhecer a rota do token mesmo que não tenha usado ela para conectar da primeira vez.
Se… então…
| Se… | Então… |
|---|---|
| Você ainda não tem bot | A rota de um toque — sem token nem área de transferência |
| Você já tem um bot que quer manter | A rota do token: /mybots → API Token → colar |
| A entrega não completou | Cole o token; é o mesmo destino |
| Você quer um bot por canal | Não precisa: um bot, quantos canais quiser |
| Seu canal não aparece no aplicativo | O bot ainda não é admin lá |
| Você revogou o token | Pegue o novo e reconecte; nada se perde |
| Alguém te manda um token para colar | Não cole: token é o controle do bot, como uma senha |
Por onde começar
Use a rota de um toque, a menos que tenha um motivo específico para não usar. Ela pula justamente o passo em que o guia pede um segredo e o leitor fica na dúvida se é seguro.
Depois, na mesma sentada e sem deixar para depois, adicione o bot ao canal como administrador. É aqui que a sequência costuma quebrar — não por dificuldade, mas porque criar o bot parece conclusão, e não é. O bot existe e não consegue nada até o canal deixá-lo entrar.
Só então há o que configurar. Um bot conectado e administrador é o ponto em que todo o resto começa a fazer sentido.
O que roda nesse bot depois de conectado — o editor de posts. Fazer ele responder também nas suas privadas — conectar um bot à sua conta. Vender por ele — como vender no Telegram.
Não é para um canal especificamente? O que o BotFather cria de verdade e o que roda atrás do token — como criar um bot do Telegram sem programar.
O que as pessoas costumam perguntar
- Preciso copiar um token de API?
- Na rota normal, não. O Telegram consegue transferir um bot recém-criado direto para um aplicativo: você toca uma vez, cria o bot no BotFather e ele chega já conectado. O token não aparece na sua tela nem passa pela área de transferência. Copiar e colar é a rota reserva, não a principal, embora quase todos os guias que você achar descrevam como se fosse a única.
- Por que preciso de um bot meu?
- Porque o bot é o que age em seu nome: publica no seu canal, recebe pagamentos na sua conta, responde aos seus clientes. Um bot compartilhado não conseguiria fazer isso por você sem poder fazer o mesmo por outra pessoa. Por isso o AdminHub conecta apenas um bot seu, e a tentativa de conectar outro é simplesmente ignorada.
- E se eu já tenho um bot?
- Então use a rota do token: BotFather, /mybots, escolha o bot, copie o token de API, cole. Mesmo resultado, um passo a mais. Faz sentido quando o bot já tem o nome que você quer ou seu público já o conhece.
- Quantos bots um workspace pode ter?
- Um ativo. Se já existe um, o passo de criação não faz um segundo: devolve o que já está lá. Canais podem ser quantos você quiser — todos funcionam pelo mesmo bot.
- O que acontece se eu revogar o token no BotFather?
- O bot para de funcionar e se desconecta. Não é falha: revogar é justamente o mecanismo pelo qual o dono corta o acesso de um aplicativo ao seu bot. Para reconectar, pegue o token novo (/mybots → API Token) e cole.
- O bot precisa ser administrador do canal?
- Precisa, e esse é um passo separado da criação. Um bot que existe mas não é admin do canal não consegue publicar lá. Criar e conectar é o passo um; adicionar ao canal, o dois.