Руководство по плагину Stock Notifier

Пустая автовыдача — потерянные покупатели: лот продолжает висеть, а выдать нечего. Stock Notifier следит за остатком товара в выбранных лотах и, как только он опустится до вашего порога, присылает в Telegram уведомление с кнопкой «✏️ Пополнить» — она сразу открывает страницу редактирования лота на FunPay.

🎯 Для чего это нужно

1. Товар не заканчивается внезапно: вы узнаёте заранее, пока ещё есть несколько штук.
2. Не нужно проверять лоты вручную: плагин смотрит остатки сам — после каждой продажи и раз в 30 минут.
3. Без спама: одно уведомление на лот, пока вы его не пополните.

✨ Что умеет плагин

• Свой порог для каждого лота: например, предупредить при 5 шт. и меньше; без числа — 3.
• Что считается: строки встроенной автовыдачи FunPay, если она включена в лоте, иначе поле «Наличие».
• Проверка после продажи: через 20 секунд после каждого заказа (FunPay списывает строку автовыдачи не мгновенно) и раз в 30 минут.
• Одно уведомление: следующее — только после того, как остаток поднимется выше порога и снова опустится.
• Кнопка «✏️ Пополнить»: ведёт прямо на страницу редактирования лота.
• Список остатков: /stock — все отслеживаемые лоты, сколько осталось и пороги.

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

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. Узнайте ID лота — число из ссылки на лот.
3. /stock → «➕ Следить за лотом» → пришлите ID и порог.
4. Ждите уведомлений — плагин проверяет остатки сам.

🛠️ Пошаговая настройка

ШАГ 1. Включите плагин (обязательно перед настройкой)

1. Отправьте своему боту команду /menu.
2. Откройте 🔧 Система и Конфиги → 🧩 Плагины и найдите Stock Notifier.
3. Нажмите «Включить».
4. ‼️ Перезапустите бота командой /restart — без перезапуска плагин не заработает.

ШАГ 2. Узнайте ID лота

1. Откройте лот на FunPay: ID — число в ссылке, например funpay.com/lots/offer?id=12345678 → 12345678.

ШАГ 3. Добавьте лот

1. /stock (или «⚙️ Открыть настройки» в карточке плагина) → «➕ Следить за лотом» → 12345678 5 — предупредить, когда останется 5 шт. или меньше. Без числа порог — 3.
2. Бот ответит «✅ Слежу» и покажет, сколько товара в лоте сейчас.
3. Ответ «нет поля «Наличие»» — у лота нет ни автовыдачи FunPay, ни поля «Наличие», следить не за чем.
4. Если товара уже меньше порога, уведомление придёт сразу.

💡 Сменить порог — «➕ Следить за лотом» с тем же ID и новым числом: запись заменится.

ШАГ 4. Получайте уведомления

1. Остаток дошёл до порога — придёт «📦 Заканчивается товар» с названием лота, остатком и кнопкой «✏️ Пополнить».
2. Пополните лот на FunPay — когда остаток станет больше порога, плагин снова начнёт следить и предупредит в следующий раз.

ШАГ 5. Управляйте списком

1. /stock — все лоты со ссылками, остатками и порогами; 🔴 — остаток дошёл до порога.
2. «🗑 Перестать следить» → 12345678 — убрать лот из списка.

🕹️ Меню и кнопки

Панель /stock

Сверху — за сколькими лотами следит бот, ниже — лоты: остаток и порог.

• ➕ Следить за лотом — ID лота и порог, например 12345678 5
• 🗑 Перестать следить — пришлите ID лота
• 🔄 Обновить — показать список заново
• ⬅️ Назад — к карточке плагина

🔄 Как это работает

1. Вы добавляете лот и порог.
2. После каждой продажи (с задержкой 20 секунд) и раз в 30 минут плагин читает лот с FunPay.
3. Берёт остаток: число строк автовыдачи FunPay или значение поля «Наличие».
4. Остаток не больше порога и уведомления ещё не было — всем, кто вошёл в Telegram-бота по паролю, приходит предупреждение.
5. Остаток снова выше порога — плагин сбрасывает отметку и предупредит при следующем падении.

💬 Как это выглядит

Уведомление в Telegram

📦 Заканчивается товар
Ключ Steam — случайная игра
Осталось: 3 (порог 5)
[✏️ Пополнить]

⌨️ Команды

• /stock — остатки отслеживаемых лотов и пороги
• /stock_add — следить за лотом: /stock_add ID порог
• /stock_del — перестать следить: /stock_del ID

💡 Важно знать

• Плагин следит только за лотами вашего аккаунта: чужой или удалённый лот бот не добавит — «❌ Лот не найден на вашем аккаунте».
• Товар выдаёт другой плагин (Steam Rental, LZT и т. п.)? Stock Notifier смотрит только автовыдачу FunPay и поле «Наличие».

❓ Частые вопросы

Можно следить за лотом без автовыдачи?

Да, если у лота заполнено поле «Наличие» — бот следит за ним.

Что именно считает плагин?

То, что указано в лоте на FunPay: строки встроенной автовыдачи FunPay, если она включена в лоте, иначе поле «Наличие».

Сменить порог?

Отправьте /stock_add с тем же ID и новым порогом — запись заменится.

Уведомление пришло один раз, а товар всё ещё заканчивается

Так задумано: повторное уведомление придёт, только когда остаток поднимется выше порога и снова опустится.