Як створити бота в Telegram за допомогою BotFather та налаштувати команди?
Покрокова інструкція зі створення бота в Telegram через BotFather: налаштування команд, токену, опису та інших параметрів для початківців.
Як створити бота в Telegram за допомогою BotFather та налаштувати команди
Telegram Bot API відкриває широкі можливості для автоматизації, але перший крок завжди однаковий — реєстрація нового бота через офіційного бота BotFather. У цьому посібнику ми розглянемо весь процес — від створення та отримання секретного токена до тонкого налаштування команд, опису й обмежень сфери використання. Матеріал підійде як початківцям, так і досвідченим розробникам, адже містить практичні поради, які стануть у пригоді на будь-якому етапі.
Що таке BotFather і чому він потрібен
BotFather — це офіційний бот Telegram, який виконує роль адміністративного інтерфейсу для керування іншими ботами. Він дозволяє створювати нових ботів, змінювати їхні імена, описи, аватарки, налаштовувати команди та керувати токенами. Усі дії виконуються через текстові команди, тому працювати з BotFather можна з будь-якого клієнта Telegram — мобільного, десктопного чи веб-версії. Єдина вимога — мати активний обліковий запис. Станом на 2026 рік функціонал BotFather залишається стабільним і зворотно сумісним, тому наведені кроки будуть актуальними тривалий час.
Підготовка до роботи
Перш ніж почати, переконайтеся, що ви маєте:
- Обліковий запис Telegram (номер телефону, підтверджений у додатку).
- Стабільне інтернет-з’єднання.
- Чітке уявлення про призначення майбутнього бота — це допоможе правильно обрати ім’я та username.
Достатньо лише цих трьох складових; жодних додаткових інструментів не потрібно. Весь процес виконується безпосередньо в чаті з BotFather.
Крок 1: Пошук і запуск BotFather
Відкрийте Telegram і скористайтеся пошуком. У рядку пошуку введіть @BotFather. Виберіть бота з офіційною синьою галочкою — це гарантує, що ви спілкуєтеся з реальним BotFather, а не з підробкою, яка може намагатися викрасти ваш токен. Офіційний BotFather має username @BotFather і відображається першим у результатах пошуку.
Натисніть кнопку Start або надішліть команду /start. BotFather відповість привітанням і списком доступних команд. Якщо цього не сталося, перевірте з’єднання та спробуйте ще раз.
Крок 2: Створення нового бота
У чаті з BotFather надішліть команду /newbot. Бот попросить вас обрати ім’я для вашого бота — це назва, яку бачитимуть користувачі в списку чатів. Наприклад, «Мій Перший Бот». Далі потрібно вказати username — унікальний ідентифікатор, який завжди закінчується на bot. Наприклад, MyFirstBot_bot. Username може містити латинські літери, цифри та нижнє підкреслення, але не може починатися з цифри. Якщо обраний username уже зайнятий, BotFather повідомить про це та запропонує альтернативний варіант.
Після успішного створення BotFather надішле повідомлення з привітанням і токеном — унікальним рядком, який використовується для автентифікації вашого бота через Bot API. Токен має вигляд: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Зберігайте його в безпечному місці, оскільки будь-хто, хто має цей токен, може повністю контролювати вашого бота.
Увага:
Ніколи не публікуйте токен у відкритих репозиторіях, чатах або на веб-сторінках. Якщо підозрюєте, що токен скомпрометовано, негайно згенеруйте новий командою /revoke в BotFather.
Крок 3: Особисті налаштування бота
Після створення бота варто одразу налаштувати його зовнішній вигляд і опис. BotFather пропонує кілька команд:
- /setname — зміна імені бота (наприклад, назви, яку бачать у чаті).
- /setdescription — короткий опис (до 512 символів), який з’являється поруч з іменем бота в списку чатів.
- /setabouttext — детальніший опис (до 512 символів), який відображається в профілі бота.
- /setuserpic — завантаження аватара (зображення у форматі JPEG або PNG, рекомендований розмір 512×512 пікселів).
Щоб скористатися будь-якою з цих команд, введіть її вручну або натисніть у меню, а потім виберіть потрібного бота зі списку. Якщо у вас кілька ботів, BotFather покаже їхній перелік, і налаштування застосуються миттєво.
Крок 4: Налаштування команд (основний розділ)
Команди — це основна точка взаємодії користувача з вашим ботом. Telegram автоматично відображає список доступних команд після введення символу / у чаті. BotFather дозволяє задати до 100 команд для одного бота. Кожна команда складається з імені (латиницею, без пробілів) і короткого опису.
Щоб додати команди, виконайте команду /setcommands у BotFather. Виберіть бота зі списку. Після цього надішліть список команд у форматі:
start - Запуск бота help - Довідка info - Інформація про бота settings - Налаштування
Кожен рядок містить команду (без слеша), дефіс, пробіл і короткий опис. Опис обмежений до 256 символів, але користувачі бачать лише перші кілька слів у спливаючому меню. Тому варто робити опис лаконічним, у межах 40–60 символів.
Після надсилання списку BotFather підтвердить успішне оновлення. Команди стають доступними одразу для всіх користувачів, які починають новий чат із ботом. Для вже існуючих чатів команди з'являться після перезапуску діалогу або оновлення клієнта, тому не хвилюйтеся, якщо одразу не побачили змін.
Область застосування команд (scope)
За замовчуванням команди діють у всіх чатах — особистих, групових і супергрупах. Однак, починаючи з версії Bot API 5.3 (2021 рік), з'явилася можливість обмежити область видимості команд. BotFather підтримує цю функцію через команду /setcommands з додатковим параметром — вибором області. Під час додавання команд BotFather запитає, чи хочете ви вказати область. Якщо так, з'явиться список типів: Default (усі чати), All Private Chats, All Group Chats, All Channel Chats. Також можна вказати конкретний чат (за ID або username) для специфічних команд.
Наприклад, якщо ваш бот працює переважно в групах, доцільно приховати службові команди з особистих чатів, а для групи залишити лише необхідні. Це зменшує візуальний шум для користувачів і робить інтерфейс чистішим.
Підказка:
Якщо ви керуєте ботами програмно через Bot API, область команд можна також задати в методі setMyCommands. Однак команди, встановлені через BotFather, мають вищий пріоритет і не можуть бути перезаписані API без явної вказівки бота.
Крок 5: Інші корисні налаштування
Приватний режим (Privacy Mode)
За замовчуванням боти, додані до груп, бачать усі повідомлення в цій групі. Якщо ви хочете, щоб бот отримував лише ті повідомлення, які містять команди або згадки, використовуйте команду /setprivacy у BotFather. Виберіть бота і встановіть значення Enabled. Після цього бот ігноруватиме звичайні текстові повідомлення, що зменшує навантаження на обробку.
Інлайн-режим (Inline Mode)
Якщо ваш бот підтримує інлайн-запити (користувачі можуть викликати його в будь-якому чаті через @username), увімкніть цю опцію командою /setinline. Після увімкнення потрібно буде реалізувати обробку інлайн-запитів у коді бота.
Керування токеном
Команда /token показує поточний токен для вибраного бота. /revoke генерує новий токен, анулюючи старий. Обидві дії потребують підтвердження, щоб уникнути випадкових змін.
Поширені помилки та їх усунення
| Симптом | Можлива причина | Рішення |
|---|---|---|
| BotFather не відповідає | Проблеми з’єднання або тимчасовий збій серверів Telegram | Зачекайте кілька хвилин і повторіть команду. Якщо проблема не зникає, перевірте статус сервісів Telegram. |
| Помилка «Sorry, this username is already taken» | Обраний username зайнятий іншим ботом | Виберіть інший username, можна додати додаткові символи або підкреслення. |
| Команди не відображаються в клієнтах | Неправильно введено список команд (не той формат), або застарілий клієнт Telegram | Перевірте формат: кожен рядок має бути «команда - опис» без зайвих пробілів. Оновіть додаток Telegram до останньої версії. |
| Бот не відповідає на команди після налаштування | Не реалізовано обробку команд у коді бота | Команди, встановлені через BotFather, лише відображаються в UI. Для обробки потрібно написати програму, яка використовує Telegram Bot API і реагує на відповідні оновлення. |
Критерії успішного налаштування
Після завершення всіх кроків перевірте:
- Бот реагує на команду /start (якщо ви реалізували обробку).
- У чаті з ботом список команд з’являється після введення «/».
- Опис та аватар відображаються коректно.
- Токен працює (спробуйте надіслати запит до Bot API, наприклад,
https://api.telegram.org/bot{ТОКЕН}/getMe— ви повинні отримати JSON з інформацією про бота).
Успішне виконання всіх пунктів означає, що ваш бот готовий до взаємодії з користувачами.
Коли використовувати програмне налаштування команд замість BotFather
Хоча BotFather підходить для більшості сценаріїв, є ситуації, коли краще використовувати метод Bot API setMyCommands:
- Якщо вам потрібно динамічно змінювати команди залежно від контексту (наприклад, різні команди для різних груп).
- Якщо ви автоматизуєте розгортання бота (CI/CD) і не хочете щоразу вручну вводити команди в BotFather.
- Якщо потрібно встановити різні набори команд для різних мов (BotFather підтримує лише один набір команд на бота вручну, а через API можна вказати мовний код).
Однак для швидкого старту та простих ботів BotFather є найпростішим і найнадійнішим інструментом.
Часті запитання (FAQ)
Чи можна змінити username бота після створення?
Так, використовуйте команду /setname для зміни імені. Для зміни username скористайтеся меню /mybots: оберіть бота, далі «Edit Bot» → «Edit Username».
Чи можна відновити токен, якщо його втрачено?
Так, у BotFather виконайте /token і оберіть бота — токен буде показано знову. Якщо старий токен скомпрометовано, виконайте /revoke для генерації нового.
Чи обов’язково робити опис команди англійською?
Ні, опис може бути будь-якою мовою, але враховуйте, що команди (імена) завжди пишуться латиницею. Опис відображається мовою, якою ви його вказали. Користувачі побачать опис у своєму інтерфейсі так, як ви його задали.
Скільки ботів можна створити через один обліковий запис?
Офіційне обмеження Telegram — до 20 ботів на один акаунт. Якщо потрібно більше, використовуйте кілька облікових записів.
Висновки
Створення бота в Telegram через BotFather — це простий і зрозумілий процес, який не вимагає глибоких технічних навичок. Головне — правильно обрати ім’я та username, надійно зберігати токен і продумати набір команд. За допомогою BotFather можна також налаштувати опис, аватар, приватний та інлайн-режими. Для складніших сценаріїв варто розглянути програмне керування через Bot API, але базовий функціонал повністю покривається вбудованими інструментами.
Після налаштування команд наступним кроком буде написання коду обробника. Тут уже знадобляться знання програмування або використання готових фреймворків. Фундамент закладено — ваш бот зареєстрований і готовий до взаємодії. Починайте з малого, експериментуйте з командами й поступово додавайте складніші функції. Якщо виникли додаткові запитання — звертайтеся до офіційної документації Telegram Bot API або спільноти розробників. Вдалих проєктів!