Где найти токен Telegram-бота?
Токен — это секретный ключ, который позволяет Mini Apps Builder подключить вашего бота к проекту. Это не пароль от Telegram и не ссылка на бота. Для его получения не нужно программировать.
Как получить токен, если бота ещё нет
Откройте официальный BotFather. Это инструмент Telegram для создания ботов и управления ими. Проверяйте имя пользователя — именно @BotFather, без дополнительных букв и цифр. Интерфейс одинаковый для всех платформ: Android, iOS, macOS, Windows, Linux, Web.
Следующие шаги выполняются в чате BotFather: Нажмите Start Bot,
Вы увидите такое сообщение. Дальше вы можете создать бота двумя способами: через чат и Mini App.
Создание нового бота через чат
Вам нужно выбрать из сообщения присланного BotFather /newbot. Просто кликните по этому тексту в сообщении, и это сразу запустит процесс создания бота.
BotFather спросит, как назвать приложение. Это "имя" вашего бота/приложение, которое будет видеть любой пользователь в Telegram. Но вы его можете позже также изменить в любой момент.
После ввода "имени" BotFather попросить придумать username_bot - это уникальный ID, его нельзя будет изменить после создания. Плюс сам Telegram вам подскажет, если введеный вариант уже занят.
После ввода username_bot вы увидите такое сообщение, значит бот создан. Внутри сообщения будет bot token. Просто нажмите на него, и он скопируется, значит его можно вставлять у нас на сайте.
Скопированный токен надо вставить в поле "Token" при создании проекта в Mini Apps Builder. После это проект будет создан.
Создание нового бота через Mini App
Это второй способ создать нового бота и получить bot token. Если вы уже воспользовались способом выше, то читать эту часть необязательно.
Нажимаете кнопку "Open" слева внизу рядом с полем ввода текста в чат.
У вас откроется такой экран. Если вы не разу не создавали ботов, то у вас будет "пусто" под текстом "My bots". В любом случае мы сейчас разбираем сценарий создания нового бота, поэтому жмем кнопку "Create a New Bot".
Выделенные поля обязательны для заполнения. Лого и "About" в любой момент позже можно добавить.
Bot Name - название вашего бота/приложение, которое будет видеть любой пользователь в Telegram. Но вы его можете позже также изменить в любой момент.
username_bot - это уникальный ID, его нельзя будет изменить после создания. Плюс сам Telegram вам подскажет, если введеный вариант уже занят.
После ввода Bot Name и username_bot жмите кнопку "Create Bot" внизу экрана.
Вы увидите такой экран, нажмите кнопку "Copy", это скопирует ваш Bot Token для данного бота.
После нажатия кнопки "Copy", вы увидите ненадолго такое уведомление. Значит вы скопировали токен, и его можно вставлять у нас на сайте.
Скопированный токен надо вставить в поле "Token" при создании проекта в Mini Apps Builder. После это проект будет создан.
Что делать, если не получается
| Проблема | Что делать |
|---|---|
| Нужного бота нет в списке | Проверьте, открыт ли аккаунт Telegram, которому принадлежит бот. Если его создавал другой человек, уточните у него, кто владелец. |
| BotFather не принимает username | Используйте латинские буквы, цифры и подчёркивания, добавьте окончание bot. Если имя занято — придумайте другое. |
| Не получается отправить команду | Откройте именно чат @BotFather и отправьте /mybots или /newbot в строке сообщения. |
| Mini Apps Builder не принимает токен | Скопируйте его заново. Проверьте, что вставили всю строку без лишнего текста и пробелов. |
Если ошибка остаётся, отправьте в поддержку Mini Apps Builder её текст и опишите последний выполненный шаг. Не прикладывайте сам токен. На скриншоте полностью скройте его.
Как сохранить токен в безопасности
Токен даёт доступ к управлению ботом, поэтому обращайтесь с ним как с паролем. Не публикуйте его и не отправляйте посторонним. Вводите ключ только в специальное поле сервиса, которому доверяете подключение бота.
