FunPayWizard

Бот для автоматизации продаж на FunPay с полноценной панелью управления в Telegram.

Быстрый старт · Установка · Конфиги · Telegram · Группа с топиками · Аналитика

---

Возможности

FunPay

• Автовыдача — выдача товаров по заказам, привязка лотов к файлам в storage/products/
• Автоподнятие лотов по расписанию
• Автоответ на команды в чате покупателя
• Восстановление и отключение лотов при нехватке товара
• Уведомления о заказах, сообщениях, отзывах, подтверждениях, выдаче и поднятии лотов
• Ответы покупателям и возвраты из Telegram

Telegram-панель

• Управление через /menu, reply-клавиатуру и inline-кнопки
• Группа с топиками (обязательно) — без привязанной супергруппы бот не стартует; топик на покупателя, все уведомления и ответы в группе
• Уведомления (🔔) — вкл/выкл новые сообщения в топиках (раздел ✉️ Сообщения скрыт при привязанной группе)
• Шаблоны ответов — в личке и быстрая отправка из топика покупателя
• Аналитика — отчёт по балансу, продажам, возвратам, лотам и сводке за сегодня (блоки на выбор)
• Глубокие настройки — автоответ, автовыдача, ЧС, приветствие, ответы на заказ и отзывы, конфиги
• Чёрный список, вечерняя сводка (23:00), /profile и расширенная статистика

Для разработчиков

• Python 3.9+, модульная структура (api/, app/)
• Пакет api — клиент FunPay, отдельно от Telegram UI
• Docker, установочный скрипт для Linux, CI на GitHub Actions

Быстрый старт

git clone https://github.com/neluckoff/FunPayWizard.git
cd FunPayWizard
pip install -r requirements.txt
cp .env.example .env   # укажи TELEGRAM_BOT_TOKEN от @BotFather
python main.py

При первом запуске бот проведёт настройку в Telegram: golden key, пароль администратора, обязательная привязка супергруппы с топиками. FunPay подключится только после привязки группы.

Подробнее: docs/quick-start.md

Установка

Способ	Документация
Windows	docs/installation.md#windows
Linux (скрипт)	docs/installation.md#linux
Docker	docs/installation.md#docker

# Linux — автоматическая установка
wget https://raw.githubusercontent.com/neluckoff/FunPayWizard/main/linux-install.sh -nc && bash linux-install.sh

# Docker
docker compose up -d --build
docker compose logs -f funpay-wizard

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

api/                 # клиент FunPay API
app/
  bot/               # Telegram: client, keyboards, меню, группа с топиками
  constants/         # тексты интерфейса
  utils/             # конфиги, логгер, хелперы
  assistant.py       # ядро
  handlers.py        # обработчики событий FunPay
assets/              # изображения для бота и README
configs/             # конфигурация (создаётся при настройке)
storage/             # кэш, товары, шаблоны
docs/                # документация
main.py              # точка входа

Конфигурация

Файл	Назначение
configs/_main.cfg	Основные переключатели, Telegram, группа
configs/auto_response.cfg	Автоответчик
configs/auto_delivery.cfg	Автовыдача
.env	Токен бота (TELEGRAM_BOT_TOKEN)

Инструкции внутри конфигов и в docs/configuration.md.

Сообщество и поддержка

• Чат: @FunPayWizard
• Группа поддержки: перейти

Баги и предложения — через Issues. Как внести правки: CONTRIBUTING.md.

Поддержать проект

• ⭐ Звезда на GitHub
• GitHub Sponsors / Funding

---

_{FunPayWizard не аффилирован с FunPay. Используйте на свой страх и риск, соблюдая правила площадки.}