Де знайти токен 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 її текст і опишіть останній виконаний крок. Не додавайте сам токен. На скриншоті повністю приховайте його.
Як зберегти токен у безпеці
Токен дає доступ до керування ботом, тому поводьтеся з ним як із паролем. Не публікуйте його й не надсилайте стороннім. Вводьте ключ лише в спеціальне поле сервісу, якому ви довіряєте підключення бота.
