Як створити бота в Телеграмі: покрокова інструкція

Розібратися, як створити бота в Телеграмі, можна за кілька хвилин: реєстрація безкоштовна, але відповідати людям він почне тільки після того, як до нього підключать сценарій у конструкторі або код. Простий сценарій для заявок і частих запитань збирають за вечір без розробника, а оплату, базу клієнтів і відповіді нейромережі пишуть програмісти. Нижче крок за кроком: реєстрація, два способи навчити його відповідати, запуск і перевірка.

Що таке бот і що він уміє

Чат-бот - це програма, яка веде діалог з людиною в месенджері за заздалегідь заданим сценарієм або за кодом. Він приймає натискання кнопок і команди, зберігає відповіді й передає їх менеджеру, у таблицю або в облікову систему. Для малого бізнесу це зазвичай п’ять завдань:

• заявки й запис у неробочий час: людина обирає послугу й день, а менеджер уранці отримує готову заявку з іменем і телефоном;
• відповіді на часті запитання кнопками: ціни, адреси, графік роботи, умови доставки й повернення;
• статус замовлення за номером без дзвінка в магазин, а з чого починається автоматизація процесів в інтернет-магазині, ми розбирали окремо;
• розсилки користувачам, які самі відкрили діалог: акції, нагадування про запис, новини; без платного режиму месенджер дозволяє надсилати близько 30 повідомлень на секунду, тому велику базу обходять частинами;
• контакти з реклами: реклама в Telegram веде людину одразу в діалог, де вона ділиться номером телефону однією кнопкою.

Головне обмеження в тому, що написати першим бот не може. Людина сама знаходить його через пошук або відкриває посилання t.me і натискає «Запустити». Тому посилання на нього ставлять у рекламу, на сайт, у підпис листа й на візитку.

Реєстрація в BotFather

BotFather - це офіційний бот месенджера, через який реєструють і налаштовують усі інші. З нього починається будь-який бот, і цей крок однаковий для сервісу без коду й для програми. З телефону все виглядає так само, як на комп’ютері, а команди йому можна надрукувати або вибрати зі списку.

Кроки реєстрації

1. Знайдіть @BotFather через пошук у месенджері. У справжнього BotFather поруч з іменем стоїть синя галочка, а акаунти зі схожими назвами без неї пропускайте. Відкрийте саме цей чат, а не канал зі схожою назвою.
2. Натисніть «Запустити» внизу екрана. У відповідь прийде список команд із короткими поясненнями, з ними далі й працюють. Якщо чат відкривали раніше, просто надішліть /start.
3. Надішліть команду /newbot або натисніть на неї в списку. BotFather по черзі запитає ім’я та юзернейм, відповідайте звичайними повідомленнями в цей самий чат.
4. Введіть ім’я, яке користувачі побачать у списку чатів, у шапці діалогу й у профілі. Зазвичай це назва компанії або послуги, і його можна змінити пізніше командою /setname.
5. Придумайте юзернейм завдовжки від 5 до 32 символів: латинські літери, цифри й нижнє підкреслення, у кінці обов’язково bot, наприклад dental_kyiv_bot або DentalKyivBot. За ним вас знаходять у пошуку й за посиланням, і, на відміну від імені, змінити його потім не можна. Регістр літер не важливий: DentalKyivBot і dentalkyivbot вважаються одним юзернеймом.
6. Зайнятий юзернейм замінюють іншим: додайте місто, вид послуги або скоротіть назву компанії. Він має бути унікальним у всьому месенджері, тому короткі слова зазвичай зайняті.
7. Отримайте відповідь із посиланням вигляду t.me/юзернейм і токеном. Збережіть повідомлення або скопіюйте ключ у менеджер паролів, а посилання відкрийте: чат уже існує, але поки мовчить.

Непотрібного бота видаляє команда /deletebot, вона ж звільняє юзернейм. Скасувати видалення не можна, тому на робочому боті її не чіпають.

Токен: де знайти і як зберігати

Токен - це ключ доступу, за яким сервіс або програма керує ботом через Bot API. Виглядає він як рядок із цифр, двокрапки й латинських літер, у документації приклад такий: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Будь-хто, у кого є цей ключ, може керувати вашим ботом.

Повернутися до налаштувань пізніше можна командою /mybots, де після вибору бота відкриється меню керування. Якщо ключ загубили або він потрапив до сторонніх, його замінюють командою /token: вона випускає новий токен, і програма зі старим перестає працювати. Ключ не вставляють у код, який викладають на GitHub, і не пересилають у спільних чатах із підрядниками. Зберігають його в менеджері паролів, а на сервері у змінній середовища, як у прикладі коду нижче.

Ім’я, опис і меню команд

Меню команд - це підказка, про що питати, тому людині не треба гадати, що написати в першому повідомленні.

Як навчити бота відповідати

Навчити бота відповідати можна сценарієм у конструкторі або кодом: після BotFather у вас є тільки оболонка й токен. Від цього вибору залежить, що бот зможе робити і скільки він коштуватиме в роботі. Один бот керується тільки однією системою, і під час підключення до нового сервісу попередній сценарій перестає працювати.

Для заявок і запису без програміста вистачить першого рядка таблиці. Другий і третій потрібні, коли відповідь залежить від даних: наявності на складі, статусу оплати, історії покупок клієнта. Заради простого меню заявок код зазвичай не пишуть, бо сервіс без коду закриває таке завдання швидше й без власного сервера.

Через конструктор

Як зробити чат-бот у Телеграмі без коду: токен вставляють у налаштування сервісу, а діалог збирають із блоків у візуальному редакторі. Без програміста це працює, якщо йти за порядком:

1. Одне завдання на старт, наприклад запис на консультацію або відповіді на часті запитання. Решту додають, коли перша гілка вже працює.
2. Структура діалогу на папері: привітання, вибір послуги, уточнення, контакт, підтвердження заявки. Кожен крок пишуть одним коротким повідомленням із варіантами відповіді.
3. Кнопки й меню замість вільного тексту. Людина натискає «Записатися» і не пише «хочу до вас», а сценарій не ламається на фразах, яких у ньому немає.
4. Вихід на менеджера з першого екрана: кнопка «Зв’язатися з людиною» потрібна тим, чиє питання не потрапило в список, інакше вони йдуть із чату без відповіді.
5. Куди йде заявка: у чат менеджеру, на пошту, у таблицю або в CRM. Коли заявок стає багато, а облік ведуть у блокноті, за цим зазвичай іде розробка CRM-системи, і сервіс починає надсилати їх уже туди.
6. Перевірка в месенджері: підпишіться на свого бота з особистого акаунта, і сервіс додасть вас до підписників. Пройдіть кожну гілку самі; якщо правка не з’явилася в чаті одразу, перезапустіть діалог. Відкрийте сценарій і з телефону, і з комп’ютера.

SendPulse і HelpCrunch, які працюють в Україні, влаштовані саме так. В обох бота підключають у налаштуваннях каналів і збирають ланцюжки повідомлень із кнопками. Докладна інструкція з підключення є в довідці кожного сервісу й оновлюється разом з його інтерфейсом.

Простий бот на Python

Створення Телеграм-бота з нуля на коді починається з бібліотеки, яка бере на себе роботу з Bot API. Для Python є aiogram 3.x і python-telegram-bot версії 20 і новіші, для Node.js є node-telegram-bot-api. Старі приклади з Updater і Dispatcher для другої бібліотеки вже не запустяться, бо з версії 20 Dispatcher замінили класом Application, а Updater перестав бути точкою входу програми.

Приклад нижче показує, як зробити Телеграм-бот на aiogram 3.x за зразком з офіційної документації. Він відповідає на /start і повторює будь-який текст, а ключ доступу бере зі змінної середовища BOT_TOKEN, тому в самому файлі його немає. Без цієї змінної програма зупиниться з помилкою одразу під час запуску. Потрібен Python від 3.10 до 3.14. Збережіть код у файл bot.py і в тій самій папці створіть віртуальне середовище: на macOS і Linux командами python3 -m venv .venv і source .venv/bin/activate, у Windows командами py -m venv .venv і .venv\Scripts\activate. Без нього Ubuntu 24.04 і Debian 12 відмовляються ставити бібліотеку з помилкою externally-managed-environment. Далі встановіть бібліотеку командою pip install aiogram і задайте ключ: export BOT_TOKEN=... на macOS і Linux або $env:BOT_TOKEN="..." у PowerShell на Windows. Запускають бота командою python bot.py, у Windows py bot.py.

import asyncio
from os import getenv
from aiogram import Bot, Dispatcher, F
from aiogram.filters import CommandStart
from aiogram.types import Message

dp = Dispatcher()

@dp.message(CommandStart())
async def start(message: Message):
    await message.answer("Вітаю! Напишіть що-небудь, і я повторю.")

@dp.message(F.text)
async def echo(message: Message):
    await message.answer(message.text)

async def main():
    await dp.start_polling(Bot(token=getenv("BOT_TOKEN")))

asyncio.run(main())

Перший обробник із фільтром CommandStart спрацьовує на /start і вітається. Другий, із фільтром F.text, отримує будь-яке текстове повідомлення й надсилає його назад. Функція start_polling запускає постійне опитування: програма сама забирає нові повідомлення, поки відкритий термінал, а зупинити її можна сполученням Ctrl+C. Нову логіку зручніше перевіряти на другому, тестовому боті з окремим ключем, щоб не заважати живим клієнтам.

Кнопки бувають двох видів. Inline-кнопки стоять просто під повідомленням, їх натискання не створює нових повідомлень у чаті й запускає дію, відкриває посилання або форму оплати. Їх ставлять там, де користувач обирає всередині кроку, гортає каталог або підтверджує замовлення. Клавіатура відповідей замінює звичайну клавіатуру телефону готовими варіантами, і натискання надсилає текст кнопки як повідомлення. Її беруть для головного меню й для запиту номера телефону, а після вибору приховують параметром one_time_keyboard.

Запуск на сервері й перевірка

Бот на коді відповідає, поки запущена програма: закрили ноутбук, і діалог замовк. Тому код ставлять на сервер, який працює цілодобово. Повідомлення програма отримує одним із двох способів. Вона або сама регулярно запитує їх методом getUpdates, або приймає на свою адресу через вебхук із SSL-сертифікатом на порту 443, 80, 88 або 8443, причому одночасно обидва способи не працюють. Перш ніж давати посилання клієнтам, перевірте шість речей:

1. Сценарій увімкнено: збережена чернетка людям не відповідає, її потрібно опублікувати.
2. Кожна кнопка веде на наступний крок: натисніть усі самі, включно з «Назад», і знайдіть глухі кути.
3. На вільне питання є вихід на людину: напишіть що-небудь поза сценарієм, наприклад з одруківкою, і подивіться відповідь.
4. У групі без прав адміністратора бот бачить тільки команди для себе, відповіді на свої повідомлення й службові повідомлення. Щоб отримувати решту, вимкніть режим приватності командою /setprivacy і додайте його в групу заново.
5. Ключ доступу ніде не опублікований: перевірте репозиторій, спільні чати й документи підрядників.
6. Тестова заявка дійшла: залиште її самі й знайдіть у чаті менеджера, на пошті або в обліковій системі. Якщо в ній немає телефону або вона пішла не туди, сценарій правлять до запуску реклами.

Для бота з оплатою, базою клієнтів чи відповідями ШІ сценарію вже мало: таку програму пишуть під ваш процес, і це вже розробка Telegram-бота на замовлення.

Часті запитання