📝 Review Reminder для Starvell — больше отзывов без ручной рутины

Review Reminder — модуль StarvellBot, который сам просит покупателя оставить отзыв о заказе. Довольные клиенты часто просто закрывают вкладку, а отзывы на Starvell напрямую влияют на рейтинг и доверие к магазину. Модуль закрывает этот пробел: одно-два ненавязчивых сообщения в нужный момент, и только тем, кто ещё не оценил заказ.

Главное:

⏱ Три момента запуска таймера — после оплаты, после того как вы подтвердили выполнение, или после того как покупатель подтвердил получение.
✌️ До двух напоминаний с разными текстами.
🧠 Без спама. Перед каждой отправкой бот открывает заказ на Starvell: если отзыв уже есть или оформлен возврат — напоминание отменяется.
💾 Очередь сохраняется при перезапуске бота.
🚫 Учитывает чёрный список бота.

🛠 Настройка

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

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

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

Шаг 1. Когда запускать таймер

В панели есть три переключателя (✅/❌), можно включить несколько:

Кнопка	Событие на Starvell	Когда удобно
Оплачен	покупатель оплатил заказ	мгновенные товары с автовыдачей
Выполнен	вы нажали «Подтвердить выполнение»	услуги и товары с ручной выдачей
Закрыт	покупатель подтвердил получение	самый спокойный вариант, включён по умолчанию

Если включено несколько моментов и первое напоминание ещё не ушло, более поздний шаг («Выполнен», «Закрыт») перезапускает таймер — просьба об отзыве придёт уже после завершения сделки.

⚠️ Если не выбран ни один момент, заказы в очередь не попадают — модуль предупредит об этом в панели.

Шаг 2. Первое напоминание

⏱ Задержка — через сколько минут после выбранного события отправить сообщение (по умолчанию 30).
📝 Текст — шаблон сообщения.

Шаг 3. Второе напоминание (по желанию)

🔔 Включить второе напоминание.
⏱ Задержка — минуты после отправки первого (по умолчанию 60). Хороший вариант — 1440 (сутки).
📝 Текст — короче и мягче первого.

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

💡 Очищенные из очереди заказы повторно не добавляются — по каждому заказу бот делает не больше одного цикла напоминаний.

💬 Переменные

$username — ник покупателя · $order_id — номер заказа · $order_link — ссылка на заказ · $order_title — название лота · $lot_id — ID лота · $quantity — количество · $price — сумма в рублях · $date, $date_text, $full_date_text, $time, $full_time — текущие дата и время · $sleep=N — пауза N секунд и отправка остатка отдельным сообщением.

Примеры

Первое напоминание:

$username, спасибо за покупку! 💙 Если всё понравилось, оставьте, пожалуйста, пару слов о заказе #$order_id — это очень помогает магазину. $order_link

Второе напоминание:

$username, напомню про отзыв к «$order_title» 🙏 Если что-то пошло не так — напишите сюда, решим.

🚀 Сценарий

Триггер «Закрыт», первое напоминание через 30 минут, второе через 1440 минут.

Покупатель подтвердил получение → таймер 30 минут.
Через 30 минут бот открывает заказ. Отзыва нет → первое сообщение, таймер на сутки.
Покупатель оставил отзыв → Starvell присылает уведомление в чат, и заказ сразу уходит из очереди.
Если отзыва так и нет — через сутки второе напоминание, и задача закрывается.

❓ Вопросы

Я сделал возврат — покупатель получит просьбу об отзыве? Нет. Возврат убирает заказ из очереди, а перед отправкой бот дополнительно проверяет статус заказа.

Не будет ли это спамом? Два вежливых сообщения с разумной задержкой — нормальная практика. Не ставьте задержку в 1 минуту и не отправляйте напоминание сразу после оплаты, если товар выдаётся вручную.

Бот был выключен ночью. Напоминания пропадут? Нет, очередь хранится на диске. После запуска бот отправит просроченные напоминания — предварительно проверив, не оставил ли покупатель отзыв за это время. Но заказы, события по которым пришли, пока модуль был выключен, в очередь не попадут.

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

Чем это отличается от «Ответа на подтверждение заказа» в основном меню? «✅ Ответ на подтверждение заказа» (/menu → ▶️ Далее) отправляет сообщение сразу после того, как покупатель подтвердил получение. Review Reminder пишет с задержкой и только если отзыва ещё нет. Если включены оба и выбран триггер «Закрыт», покупатель получит два сообщения — просьбу об отзыве лучше оставить в одном из них.