Onde encontrar o token do bot do Telegram?
O token é uma chave secreta que permite ao Mini Apps Builder conectar o seu bot ao projeto. Não é a senha do Telegram nem o link do bot. Para obtê-lo, não é necessário programar.
Como obter o token se o bot ainda não existe
Abra o BotFather oficial. Esta é a ferramenta do Telegram para criar bots e gerenciá-los. Verifique o nome de usuário — exatamente @BotFather, sem letras ou números adicionais. A interface é a mesma em todas as plataformas: Android, iOS, macOS, Windows, Linux, Web.
As próximas etapas são realizadas no chat do BotFather: Clique em Start Bot,
Você verá esta mensagem. Depois, é possível criar o bot de duas maneiras: pelo chat e pelo Mini App.
Criando um novo bot pelo chat
Você precisa selecionar na mensagem enviada pelo BotFather a opção /newbot. Basta clicar nesse texto na mensagem, e isso iniciará imediatamente o processo de criação do bot.
O BotFather perguntará como nomear o aplicativo. Este é o "nome" do seu bot/aplicativo, que será visível para qualquer usuário no Telegram. Mas você também pode alterá-lo a qualquer momento depois.
Depois de inserir o "nome", o BotFather pedirá que você crie um username_bot - este é um ID único, que não poderá ser alterado após a criação. Além disso, o próprio Telegram avisará se a opção inserida já estiver em uso.
Após inserir o username_bot, você verá esta mensagem, o que significa que o bot foi criado. Dentro da mensagem estará o bot token. Basta clicar nele e ele será copiado, ou seja, poderá ser colado no nosso site.
O token copiado deve ser inserido no campo "Token" ao criar o projeto no Mini Apps Builder. Depois disso, o projeto será criado.
Criando um novo bot pelo Mini App
Este é o segundo modo de criar um novo bot e obter o bot token. Se você já usou o método acima, não é necessário ler esta parte.
Toque no botão "Open" no canto inferior esquerdo, ao lado do campo de entrada de texto no chat.
Esta tela será aberta. Se você nunca criou bots, estará "vazio" abaixo do texto "My bots". De qualquer forma, agora estamos falando do cenário de criação de um novo bot, então clique no botão "Create a New Bot".
Os campos destacados são obrigatórios. O logo e o "About" podem ser adicionados mais tarde, a qualquer momento.
Bot Name - nome do seu bot/aplicativo, que será visível para qualquer usuário no Telegram. Mas você também pode alterá-lo depois, a qualquer momento.
username_bot - este é um ID único, que não poderá ser alterado após a criação. Além disso, o próprio Telegram avisará se a opção inserida já estiver em uso.
Depois de inserir o Bot Name e o username_bot, clique no botão "Create Bot" na parte inferior da tela.
Você verá esta tela; clique no botão "Copy", isso copiará o seu Bot Token desse bot.
Depois de clicar no botão "Copy", você verá esta notificação por um momento. Isso significa que você copiou o token e pode colá-lo no nosso site.
O token copiado deve ser inserido no campo "Token" ao criar o projeto no Mini Apps Builder. Depois disso, o projeto será criado.
O que fazer se não der certo
| Problema | O que fazer |
|---|---|
| O bot necessário não aparece na lista | Verifique se a conta do Telegram à qual o bot pertence está aberta. Se ele foi criado por outra pessoa, pergunte a ela quem é o proprietário. |
| O BotFather não aceita o username | Use letras latinas, números e sublinhados, e adicione o sufixo bot. Se o nome estiver em uso, invente outro. |
| Não consigo enviar o comando | Abra exatamente o chat @BotFather e envie /mybots ou /newbot na linha de mensagem. |
| O Mini Apps Builder não aceita o token | Copie-o novamente. Verifique se colou a string inteira, sem texto extra nem espaços. |
Se o erro continuar, envie ao suporte do Mini Apps Builder o texto da mensagem e descreva a última etapa realizada. Não envie o token. Na captura de tela, oculte-o completamente.
Como manter o token em segurança
O token dá acesso ao gerenciamento do bot, então trate-o como uma senha. Não o publique nem o envie a terceiros. Insira a chave apenas no campo específico do serviço em que você confia para conectar o bot.
