Руководство по плагину Review Guard

Review Guard реагирует на отзывы по оценке: на каждую от 1 до 5★ — свои правила. За отзыв бот может написать покупателю в чат, подарить промокод или ключ, а за плохой — вернуть деньги (FunPay снимает отзыв с возвращённого заказа) и добавить покупателя в чёрный список. Возврат — только до заданной суммы в рублях. Можно реагировать на изменённый отзыв и написать тому, кто отзыв удалил. Покупателю из чёрного списка новый заказ возвращается сразу, если товар ещё не выдан.

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

1. Рейтинг под защитой: плохой отзыв на дешёвом заказе снимается возвратом — FunPay не учитывает отзыв возвращённого заказа.
2. Больше хороших отзывов: подарок или благодарность за 5★ мотивирует покупателей.
3. Проблемные покупатели не возвращаются: плохой отзыв — сразу в чёрный список, а их новые заказы возвращаются.

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

• Свои правила на каждую оценку 1–5★: возврат, чёрный список, сообщение, подарок — в любом сочетании.
• Возврат с потолком: только заказы до заданной суммы в ₽ (по умолчанию 100 ₽).
• Сообщение покупателю: с переменными $username, $order_id, $order_link, $order_title, $game, $category, $date, $time.
• Подарок за отзыв: промокод, ключ или ссылка из вашего списка — один на заказ; список строками или файлом .txt.
• «🎁 Подарки по кругу»: строки не тратятся — подходит для одного промокода на всех.
• Предупреждение: подарков осталось 3 и меньше — бот напомнит пополнить.
• Изменённый отзыв: по желанию обрабатывается по правилам новой оценки.
• Удалённый отзыв: своё сообщение покупателю, удалившему отзыв.
• Заказы из ЧС: покупателю из чёрного списка — возврат (если товар ещё не выдан) и сообщение.
• Уведомление в Telegram о каждом действии.

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

1. Включите плагин и перезапустите бота (шаг 1 ниже) — по умолчанию всё выключено.
2. /review_guard → нажмите на оценку и включите «↩️ Возврат» и «🚫 В ЧС», где нужно.
3. Там же — «✏️ Потолок возврата» и «✏️ Сообщение» покупателю.
4. По желанию — подарки за 5★: «5★» → «🎁 Добавить подарки».

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

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

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

ШАГ 2. Правила по оценкам

1. /review_guard (или «⚙️ Открыть настройки» в карточке плагина) — сверху видно, что настроено для каждой оценки.
2. Нажмите на оценку, например «1★»: «↩️ Возврат: ❌» и «🚫 В ЧС: ❌» — нажмите, чтобы включить (✅).

ШАГ 3. Потолок возврата и сообщения

1. «✏️ Потолок возврата» → 300 — за эту оценку возвращать заказы до 300 ₽.
2. «✏️ Сообщение» — что написать покупателю за эту оценку; «-» — без сообщения.
3. Для 5★: «✏️ Сообщение» → Спасибо, $username! — ответ с ником покупателя.

💡 Возврат на высокие суммы невыгоден — ставьте потолок по своим ценам.

ШАГ 4. Изменённые и удалённые отзывы

1. «✏️ Изменённый отзыв: ✅» — отзыв, изменённый на 1★, обработается как новый 1★.
2. «🗑 Удалённый отзыв» — что написать покупателю, удалившему отзыв; «-» — ничего.

ШАГ 5. Чёрный список

1. «🚫 Возврат из ЧС: ✅» — возвращать заказы покупателей из чёрного списка.
2. «🚫 Потолок ЧС» — потолок такого возврата, «🚫 Сообщение ЧС» — сообщение такому покупателю.

ШАГ 6. Подарки за отзыв

1. Нажмите на оценку → «🎁 Добавить подарки» и пришлите подарки — каждая строка один подарок, они добавятся к списку.
2. Много подарков — пришлите файл .txt с подписью /rg_gift 5: строки добавятся к списку.
3. «📄 Подарки файлом» — текущий список подарков файлом; «🎁 Добавить подарки» → «-» — очистить список.
4. $gift в сообщении за оценку вставит подарок в ответ, без неё подарок придёт отдельным сообщением «🎁 Подарок за отзыв».
5. «🎁 По кругу: ✅» в главном меню — строки не тратятся.

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

Меню /review_guard

Сверху — изменённый и удалённый отзыв, заказы из ЧС, подарки по кругу и что настроено для каждой оценки.

• 1★ … 5★ — открыть настройки оценки
• ✏️ Изменённый отзыв: ✅ / ❌ — изменённый отзыв обрабатывается по правилам новой оценки
• 🗑 Удалённый отзыв — что написать покупателю, удалившему отзыв
• 🚫 Возврат из ЧС: ✅ / ❌ — возвращать заказы покупателей из чёрного списка, если товар ещё не выдан
• 🚫 Потолок ЧС — до какой суммы возвращать такие заказы, ₽
• 🚫 Сообщение ЧС — что написать покупателю из ЧС
• 🎁 По кругу: ✅ / ❌ — выданная строка уходит в конец списка, а не удаляется
• ⬅️ Назад — к карточке плагина

Экран оценки

Возврат, ЧС, сообщение и сколько подарков в списке для этой оценки.

• ↩️ Возврат: ✅ / ❌ — возвращать деньги за отзыв с этой оценкой (до потолка)
• 🚫 В ЧС: ✅ / ❌ — добавлять покупателя в чёрный список за отзыв с этой оценкой
• ✏️ Потолок возврата — до какой суммы возвращать, ₽
• ✏️ Сообщение — ответ покупателю: $username $order_id $order_link $order_title $game, $gift — подарок; «-» — без сообщения
• 🎁 Добавить подарки — промокоды, ключи или ссылки — каждая строка один подарок; «-» — очистить список
• 📄 Подарки файлом — прислать текущий список подарков файлом
• ⬅️ Все оценки — назад в меню

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

1. FunPay присылает системное сообщение о новом, изменённом или удалённом отзыве.
2. Бот открывает заказ и узнаёт оценку и сумму.
3. По правилам этой оценки: отправляет сообщение и подарок, делает возврат (если сумма в ₽ и не выше потолка), добавляет в ЧС.
4. О каждом действии приходит уведомление в Telegram.
5. Новый заказ от покупателя из ЧС: сообщение и возврат — только если товар ещё не выдан.

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

Покупателю за 5★

Спасибо за отзыв, Ник! Ваш промокод на следующую покупку: SALE10

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

⭐ Отзыв 1★ к заказу #ABCD1234 от Ник: сообщение, возврат 90 ₽, в чёрном списке

⌨️ Команды

• /review_guard — меню правил
• /rg_sum — потолок возврата за оценку: /rg_sum 1 300
• /rg_msg — сообщение покупателю за оценку: /rg_msg 5 текст
• /rg_bl_sum — потолок возврата заказа из ЧС
• /rg_bl_msg — сообщение покупателю из ЧС
• /rg_del_msg — сообщение покупателю, удалившему отзыв
• /rg_gift — подарки за оценку: /rg_gift 5 и строки
• /rg_gift_get — список подарков файлом .txt

💡 Важно знать

• Потолок задаётся в рублях: заказы в другой валюте бот не возвращает — только пишет сообщение и добавляет в ЧС, если это включено.
• Подарок по одному заказу выдаётся только один раз — даже если отзыв меняли.
• ⚠️ Возврат необратим: проверьте потолки перед включением.

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

Зачем возвращать деньги за плохой отзыв?

FunPay снимает отзыв с возвращённого заказа. На дешёвых заказах вернуть деньги выгоднее, чем держать 1★ в профиле, а потолок суммы не даст вернуть дорогой заказ.

А заказы в другой валюте?

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

Покупатель из ЧС купил товар с автовыдачей?

Если товар уже выдан, возврата не будет — иначе товар достался бы бесплатно.

Подарки кончились — что получит покупатель?

Сообщение без подарка: $gift просто пропадёт из текста. Когда подарков остаётся 3 и меньше, бот заранее напоминает пополнить список.

Можно разные подарки за 4★ и 5★?

Да: у каждой оценки свой список — /rg_gift 4 и /rg_gift 5.