Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Telegram Bot с Админ-панелью

Описание

Полноценное веб-приложение для управления Telegram ботом с административной панелью. Система хранит данные в JSON файлах, что упрощает использование и развертывание. Бот поддерживает интерактивные кнопки с изображениями, отслеживание пользователей и управление сообщениями.

GitHub репозиторий

Основные возможности

  • Управление пользователями: просмотр информации, отправка сообщений конкретным пользователям
  • Настраиваемые кнопки с изображениями: создание интерактивных кнопок с визуальным сопровождением
  • Отслеживание сообщений: полная история общения с пользователями
  • Статистика и аналитика: данные об активности пользователей
  • Простая настройка: управление параметрами бота через веб-интерфейс
  • Резервное копирование: экспорт/импорт данных и создание бэкапов

Технические требования

  • Python 3.7+
  • Flask 3.0.2+
  • python-telegram-bot 20.8+
  • Модули: python-dotenv, requests, werkzeug, flask_wtf, httpx, aiohttp, aiofiles, secure, Pillow

Установка

  1. Клонируйте репозиторий:
git clone https://github.com/yourusername/telegram-bot-admin.git
cd telegram-bot-admin
  1. Установите необходимые зависимости:
pip install -r requirements.txt
  1. Создайте файл .env с настройками:
TELEGRAM_TOKEN=ваш_токен_бота
FLASK_DEBUG=True
SECRET_KEY=ваш_секретный_ключ

Запуск

python run.py

После запуска админ-панель будет доступна по адресу http://127.0.0.1:5000

Структура проекта

telegram-bot-admin/
├── app.py             # Основной файл приложения Flask и логика бота
├── data.py            # Функции для работы с данными в JSON-файлах
├── bot.py             # Дополнительная логика Telegram бота
├── run.py             # Точка входа для запуска приложения
├── config.py          # Конфигурационные параметры
├── requirements.txt   # Зависимости проекта
├── .env               # Переменные окружения
├── data/              # Директория с JSON-файлами данных
│   ├── users.json     # Данные пользователей
│   ├── messages.json  # История сообщений
│   ├── settings.json  # Настройки бота
│   ├── buttons.json   # Настройки интерактивных кнопок
│   └── admins.json    # Учетные записи администраторов
├── static/            # Статические файлы (CSS, JS, изображения)
│   ├── css/           # CSS-стили
│   ├── js/            # JavaScript файлы
│   ├── avatars/       # Аватары пользователей
│   └── button_images/ # Изображения для кнопок
├── templates/         # HTML-шаблоны для веб-интерфейса
│   ├── admin.html     # Главная страница админ-панели
│   ├── buttons.html   # Управление кнопками
│   ├── messages.html  # Просмотр сообщений
│   └── ...
└── files_users/       # Папка для хранения файлов пользователей

Учетные данные по умолчанию

  • Логин: admin
  • Пароль: admin

После первого входа рекомендуется сменить учетные данные в файле data/admins.json или через админ-панель.

Настройка бота

  1. Получите токен для вашего бота через @BotFather в Telegram
  2. Укажите полученный токен в файле .env или в настройках админ-панели
  3. Настройте приветственное сообщение и другие параметры через веб-интерфейс
  4. Создайте интерактивные кнопки с изображениями в разделе "Кнопки"

Функции администратора

  • Мониторинг пользователей: просмотр активности, информации и статистики
  • Управление сообщениями: отправка личных и массовых сообщений
  • Настройка кнопок: создание интерактивных элементов с изображениями и ссылками
  • Управление системой: экспорт/импорт данных, создание резервных копий
  • Настройка бота: изменение параметров и управление поведением

Безопасность

В продакшен-версии рекомендуется:

  1. Настроить HTTPS для веб-интерфейса
  2. Изменить стандартные учетные данные администратора
  3. Использовать более надежный SECRET_KEY
  4. Настроить ограничения доступа к админ-панели по IP

Поддерживаемые языки

Бот и админ-панель поддерживают многоязычность с основным фокусом на русский язык. Интерфейс может быть легко адаптирован для других языков путем изменения текстов в шаблонах.

Лицензия

MIT

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages