Як створити бота в Telegram
Як зробити бота в Telegram через @BotFather: команда /newbot, назва та ім’я користувача на bot, токен і як його захистити, команди, кнопки й де запускати код бота.
Бота в Telegram створюють у чаті з офіційним ботом @BotFather: надішліть йому /newbot, дайте боту назву та оберіть ім’я користувача, що закінчується на bot. BotFather відповість токеном — ключем, яким ваша програма керує ботом. Створення бота нічого не коштує: Telegram не бере плати ні з користувачів, ні з розробників за платформу ботів. Але BotFather лише реєструє бота. Щоб він комусь відповідав, потрібна програма, запущена на вашому комп’ютері чи сервері.
Як створити бота в BotFather
- Відкрийте @BotFather і натисніть «Почати».
- Надішліть команду
/newbot. - Введіть назву бота — його видиму назву.
- Введіть ім’я користувача — адресу бота, наприклад
@my_shop_bot. Воно має містити 5–32 символи, лише латинські літери, цифри та підкреслення, і закінчуватися наbot. - BotFather надішле вам токен. Бот уже існує.
Назву можна змінити пізніше командою /setname, але за документацією Telegram ім’я користувача після створення змінити не можна — обирайте його уважно.
Токен: що це і як його зберігати
Токен виглядає як цифри й літери, розділені двокрапкою. Хто його має, той повністю керує ботом, тому Telegram радить зберігати його в безпечному місці та передавати лише тим, кому потрібен прямий доступ.
- Ніколи не вставляйте токен у публічний код, на GitHub чи в чати.
- Якщо він витік, документація Telegram називає команду
/tokenу BotFather, щоб згенерувати новий. Потім оновіть його скрізь, де його використовує ваша програма. - Токен потрібен лише ботам.
api_idіapi_hash— інші ключі, для програм, які входять як користувач: як їх отримати.
Що налаштувати в BotFather
/mybots відкриває інтерактивне меню налаштувань ваших ботів; те саме доступне в міні-застосунку BotFather. Вигляд бота можна задати й окремими командами:
/setname— назва бота./setdescription— опис бота, короткий текст до 512 символів./setabouttext— інформація «Про бота», коротший текст до 120 символів./setuserpic— фото профілю бота./setcommands— список команд; Telegram підказує їх, коли хтось вводить/./setjoingroups— чи можна додавати бота до груп./setprivacy— які повідомлення бот отримує в групах./deletebot— видалити бота й звільнити його ім’я користувача.
Як змусити бота відповідати
Бот — це програма, яка спілкується з Telegram через Bot API. Кожен запит іде на https://api.telegram.org/bot<token>/METHOD. Отримувати повідомлення можна двома способами, і вони взаємовиключні:
- getUpdates (довге опитування): ваша програма запитує в Telegram нові повідомлення. Найпростіший початок — публічна адреса не потрібна.
- Вебхук: Telegram надсилає повідомлення на ваш сервер. Потрібні HTTPS і один із портів 443, 80, 88 або 8443.
Код можна писати будь-якою мовою, що вміє робити HTTP-запити. Популярні бібліотеки: aiogram і python-telegram-bot для Python, grammY і Telegraf для JavaScript. Офіційний посібник розбирає бота на Java: від BotFather до «Hello World». Запускати бота можна на власному комп’ютері, поки він увімкнений, або на VPS, щоб він працював цілодобово.
Кнопки й команди в боті
- Команди — слова на кшталт
/start, які обробляє бот; список підказок задають через/setcommands. - Інлайн-кнопки під повідомленням не надсилають текст у чат: вони передають боту натискання або відкривають посилання.
- Клавіатури відповідей показують готові відповіді замість звичайної клавіатури.
- Міні-застосунки — повноцінні інтерфейси, що відкриваються всередині Telegram.
Докладніше — в огляді можливостей ботів.
Платежі в боті
Цифрові товари й послуги в ботах оплачують зірками Telegram: рахунок виставляється у валюті XTR, платіжний провайдер не потрібен. Як це налаштувати — в інструкції приймання зірок у боті; зірки, які зібрав бот, виводять через Fragment — як вивести зірки з бота.
Потрібно, щоб ваша програма купувала зірки чи Premium для своїх користувачів? У бота Shiba Bank для цього є API: API зірок Telegram.
Часті запитання
Як створити бота в Telegram без програмування?
Зареєструвати бота через @BotFather можна за хвилину, але щоб він щось робив, потрібен код. Сам Telegram зазначає, що для створення бота потрібні хоча б базові навички програмування.
Скільки коштує створення бота в Telegram?
Нічого: Telegram не бере плати ні з користувачів, ні з розробників за платформу ботів. Ви платите лише за власний сервер, якщо розміщуєте бота на ньому.
Що таке BotFather?
Офіційний бот Telegram для створення ботів і керування ними: назва, опис, фото, команди й токен.
Як отримати токен BotFather?
Токен приходить одразу після /newbot. Якщо він витік, команда /token у BotFather випустить новий.
Яке ім’я користувача може мати бот?
5–32 символи: латинські літери, цифри та підкреслення, і воно має закінчуватися на bot, наприклад my_shop_bot.
Як додати кнопки до бота в Telegram?
Кнопки задаються в коді бота: інлайн-кнопки під повідомленням і клавіатури відповідей. Список команд для меню / задають у BotFather через /setcommands.
