// встановлення
01
// prerequisite
Встановити Python
Завантажте Python 3.10 або новіший з офіційного сайту.
# Після встановлення — перевірте в командному рядку: python --version # Очікуваний результат: Python 3.10.x
ВАЖЛИВО: При встановленні обов'язково поставте галочку
"Add Python to PATH" — інакше команда python не знайдеться.
02
// dependencies
Встановити залежності
Відкрийте командний рядок (cmd або PowerShell) і виконайте:
pip install python-telegram-bot requests
03
// botfather
Створити бота в Telegram
Знайдіть в Telegram бота @BotFather і виконайте такі кроки:
1. Надішліть: /newbot 2. Введіть назву: Кав'ярня Ранок 3. Введіть username: kavyarnya_ranok_bot 4. Отримаєте токен: 1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ↑ збережіть його, знадобиться далі
04
// owner id
Дізнатись свій Telegram ID
Знайдіть бота @userinfobot — надішліть йому будь-що, він відповість вашим ID.
Id: 382499750 ↑ ваш ID — збережіть
// налаштування під свій бізнес
05
// config · business
Налаштування бізнесу
Відкрийте файл bot.py у будь-якому текстовому редакторі. Знайдіть секцію BUSINESS і замініть значення:
BUSINESS = {
"name": "Кав'ярня «Ранок»", # ← назва бізнесу
"emoji": "☕", # ← emoji бізнесу
"tagline": "Найкраща кава у місті", # ← слоган
"phone": "+380 67 123 45 67", # ← ваш телефон
"address": "вул. Соборна, 12", # ← адреса
"maps": "https://maps.app.goo.gl/...", # ← Google Maps
"instagram":"@kavyarnya_ranok", # ← Instagram
"hours": (
"Пн–Пт: 08:00 – 21:00\n"
"Сб–Нд: 09:00 – 22:00" # ← графік
),
}
Поля для заміни:
| Поле | Приклад | Опис |
|---|---|---|
| name | "Салон Краси Лілія" | Назва бізнесу у заголовку |
| emoji | "💇" | ☕ кафе · 💇 салон · 🍕 їжа · 👗 одяг · 🏋️ фітнес |
| phone | "+380 67 000 00 00" | Контактний номер |
| maps | "https://maps.app.goo.gl/abc" | Посилання з Google Maps (кнопка "Відкрити на карті") |
06
// config · menu
Налаштування меню
Знайдіть секцію MENU_ITEMS — додайте свої категорії і позиції:
MENU_ITEMS = {
"☕ Кава": [ # ← назва категорії
("Еспресо", "35 грн"), # ← (назва, ціна)
("Латте", "65 грн"),
("Капучіно", "60 грн"),
],
"🥐 Їжа": [
("Круасан", "45 грн"),
("Вафлі", "85 грн"),
],
# ← додайте скільки потрібно категорій
}
07
// config · faq
Налаштування FAQ
Знайдіть секцію FAQ — замініть питання і відповіді:
FAQ = {
"Чи є доставка?": "Так, від 200 грн по місту.",
"Як оплатити?": "Готівка, картка, Monobank.",
"Чи є знижки?": "Постійним клієнтам — 10%.",
"Як зробити замовлення?": "Натисніть кнопку Замовлення.",
}
// запуск
08
// launch
Запуск бота
Відкрийте командний рядок у папці з файлом bot.py і виконайте:
# Задати змінні: set TG_TOKEN=1234567890:AAHxxxxxxxxxxxxxxxxxxxxxxxx set OWNER_ID=382499750 # Запустити: python bot.py
Якщо бот запустився успішно — у консолі побачите:
Bot started: Кав'ярня «Ранок»
09
// test
Тестування
Знайдіть свого бота в Telegram і перевірте:
1. Напишіть боту: /start 2. Натисніть: 🛒 Замовлення 3. Введіть: Латте х2. Самовивіз. Олена, 067-xxx-xx-xx 4. Бот відповість: ✅ Замовлення прийнято! 5. Вам прийде: 🛒 Нове замовлення! 👤 @username_клієнта 📝 Латте х2. Самовивіз. Олена, 067-xxx-xx-xx
меню
графік
адреса
контакти
faq
замовлення
10
// deployment
Щоб бот працював постійно
Бот активний поки відкрита консоль. Для цілодобової роботи — оберіть варіант:
| Варіант | Вартість | Складність | Опис |
|---|---|---|---|
| ПК увімкнений | безкоштовно | легко | Просто — але якщо ПК вимкнеться, бот зупиниться |
| Railway.app | безкоштовно | середньо | Хмарний хостинг, потрібен GitHub акаунт |
| VPS-сервер | $3–5/міс | середньо | Найнадійніший варіант, 24/7 без зупинок |
// troubleshooting
!
// помилки · рішення
Часті проблеми
| Помилка | Рішення |
|---|---|
| ModuleNotFoundError: telegram | Виконайте: pip install python-telegram-bot |
| python: command not found | Перевстановіть Python з галочкою "Add to PATH" |
| Бот не відповідає | Перевірте правильність токену в TG_TOKEN |
| Замовлення не приходять | Перевірте OWNER_ID — має бути ваш Telegram ID |
| Бот відповідає на іншій мові | Перевірте текст у секції FAQ і BUSINESS у bot.py |