Files
BOTKlining/doners/shop-telegram-bot/readme.md
2025-06-08 20:55:08 +09:00

84 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ⚠️ Эта версия бота больше не обновляется!
Сейчас я переписываю бота, за обновлениями следите на ветке rewrite :)
<br>
## 🪲 В случае возникновения ошибок открывайте тикет во вкладке Issues :)
# Навигация
- [Навигация](#навигация)
- [Зачем нужен этот бот?](#зачем-нужен-этот-бот)
- [Установка](#установка)
- [Docker](#docker)
- [Python](#python)
- [Установка необходимых Python-пакетов](#установка-необходимых-python-пакетов)
- [Запуск установщика](#запуск-установщика)
- [Запуск бота](#запуск-бота)
- [Запуск с помощью скрипта](#запуск-с-помощью-скрипта)
- [Linux](#linux)
- [Macos](#macos)
- [Запуск вручную](#запуск-вручную)
- [Режим отладки](#режим-отладки)
# Зачем нужен этот бот?
Зачастую люди, желающие открыть маленький интернет-бизнес, делают это с помощью профиля в социальных сетях, что требует вручную обрабатывать каждую заявку. Этот бот позволит каждому быстро открыть автоматизированный магазин на базе телеграм бота, что значительно уменьшит время обработки заказов.
![overview](DOCS/bot_overview.gif)
# Установка
## Docker
Этот способ установки является основным и рекомендуемым. Он позволяет установить бота в репродуцируемом окружении, что упрощает его обновление и установку на сервер.
Для работы бота необходимо установить [Docker](https://docs.docker.com/get-docker/) и выполнить следущую команду:
```
docker run -d \
-e MAIN_ADMIN_ID='Ваш Telegram ID' \
-e TELEGRAM_TOKEN='token' \
w1png/shop-telegram-bot
```
## Python
Для работы бота необходимо установить [Python версии 3.10 и выше](https://www.python.org/downloads/).
### Установка необходимых Python-пакетов
python3 -m pip install -r requirements.txt
### Запуск установщика
Перед запуском установщика требуется [создать токен](https://youtu.be/fyISLEvzIec) для телеграм бота и [получить ваш ID](https://badcode.ru/kak-v-telegram-uznat-svoi-id/).
Установщик запускается с помощью команды:
python3 installer.py
## Запуск бота
### Запуск с помощью скрипта
#### Linux/MacOS
$ chmod +x start.sh
$ ./start.sh
#### Windows
$ start.cmd
### Запуск вручную
python3 main.py
# Режим отладки
Режим отладки можно активировать во вкладке "Основные настройки".
После активации в терминале начнут отображаться все сообщения и вызовы в формате:
DEBUG: <MESSAGE/CALL> [<user_id>] <Сообщение/вызов>
*Пример: `DEBUG CALL [462741] admin_itemManagement`*