⏳ Confirm Reminder для Starvell — покупатель не забудет подтвердить получение

Confirm Reminder — модуль StarvellBot, который вежливо напоминает покупателю нажать «Подтвердить получение», когда вы уже отметили заказ выполненным. Деньги быстрее переходят на ваш баланс, а вам не нужно писать каждому клиенту вручную.

📌 Особенность Starvell, под которую сделан модуль

На Starvell сделка закрывается в два шага:

Продавец нажимает «Подтвердить выполнение».
Только после этого покупатель может подтвердить получение.

Поэтому таймер модуля запускается не в момент оплаты, а когда вы подтвердили выполнение заказа — неважно, как именно: на сайте, кнопкой «✅ Подтвердить заказ» в уведомлении Telegram, автоподтверждением во встроенной автовыдаче или в одном из модулей (Auto Stars, Auto Rent Steam и др.).

🔥 Что умеет модуль:

Одно или два напоминания. Второе — для тех, кто пропустил первое, с отдельным текстом.
Проверка перед каждой отправкой. Бот открывает заказ: если покупатель уже подтвердил получение или оформлен возврат — сообщение не уходит.
Мгновенная отмена. Подтверждение или возврат, пришедшие уведомлением в чат, сразу убирают заказ из очереди.
Очередь переживает перезапуск. Таймеры хранятся на диске; после перезапуска бот продолжит с того же места.
Чёрный список. Покупателям из ЧС бота напоминания не ставятся.

⚙️ Настройка

Включите модуль: /menu → 🧩 Функции → Confirm Reminder → 🚀 Включить.
Откройте панель командой /confirm_reminder (или ⚙️ Настройки → ⏳ Открыть настройки в карточке модуля).

В панели видно состояние модуля, сколько заказов стоит в очереди и текущие тексты. Кнопки:

Кнопка	Что делает
🚀 Запустить / 🛑 Остановить	Включает или выключает модуль целиком
📝 Текст первого напоминания	Шаблон первого сообщения
⏱ Задержка первого напоминания	Минуты после подтверждения выполнения (по умолчанию 15)
🔔 Включить / 🔕 Отключить второе напоминание	Второе сообщение по желанию
📝 Текст второго напоминания	Отдельный шаблон
⏱ Задержка второго напоминания	Минуты после отправки первого (по умолчанию 30)
📋 Очередь	Список заказов с таймерами и кнопкой «🧹 Очистить очередь»

Задержка — целое число минут от 1 до 43 200 (30 дней): просто отправьте число, например 20. Новая задержка применяется к новым заказам; заказы, уже стоящие в очереди, сохраняют свой таймер.

Пример расчёта: первая задержка 20 минут, вторая 60 — второе сообщение придёт через 1 час 20 минут после подтверждения выполнения.

🧩 Переменные в текстах

Переменная	Что подставится
`$username`	ник покупателя
`$order_id`	номер заказа
`$order_link`	ссылка на заказ на Starvell
`$order_title`	название лота
`$lot_id`	ID лота
`$quantity`	количество
`$price`	сумма заказа в рублях
`$date`, `$date_text`, `$full_date_text`	текущая дата в разных форматах
`$time`, `$full_time`	текущее время
`$sleep=2`	пауза 2 секунды — текст после неё уйдёт отдельным сообщением

💡 Готовые тексты

Первое напоминание (через 15–30 минут):

$username, заказ #$order_id готов 💙 Если всё в порядке, подтвердите, пожалуйста, получение на Starvell: $order_link

Второе напоминание (через 1–3 часа после первого):

$username, простите за беспокойство 🙏 Заказ «$order_title» всё ещё ждёт подтверждения. Если что-то не так — напишите, разберёмся.

❓ Вопросы

Почему напоминание не пришло сразу после оплаты? Так задумано: до того как продавец подтвердил выполнение, покупатель на Starvell не может подтвердить получение, и напоминание было бы бессмысленным.

Что будет, если бот был выключен? Очередь сохранится. После запуска бот проверит заказы с наступившим временем и отправит напоминания только тем, кто ещё не подтвердил получение.

Бот не нашёл чат с покупателем. Модуль повторит попытку через 5 минут. После 12 неудачных попыток подряд заказ убирается из очереди, чтобы не висеть вечно.

Заказы, подтверждённые пока модуль был выключен, попадут в очередь? Нет. Модуль реагирует только на подтверждения выполнения, которые произошли, пока он включён.

Работает ли вместе с автоподтверждением? Да, это удобная связка: включите автоподтверждение выполнения во встроенной автовыдаче (переключатель «Автоподтверждение» в карточке лота) или в нужном модуле — и Confirm Reminder сам напомнит покупателю подтвердить получение.