💬 Review Chat Reply для Starvell — личное сообщение и подарок за отзыв

Review Chat Reply — модуль StarvellBot, который пишет покупателю в личный чат Starvell сразу после того, как он оставил или удалил отзыв. Для каждой оценки — свой текст, а за нужные оценки бот может выдать подарок из файла: промокод, бонусный ключ, ссылку или инструкцию.

Не путайте с встроенной функцией «⭐ Ответ на отзыв» (/menu → ▶️ Далее). Та публикует публичный ответ под отзывом, а Review Chat Reply отправляет личное сообщение в чат. Их можно использовать вместе.

🌟 Когда это полезно

❤️ Благодарность за 5 ★. «Спасибо за отзыв! Держите промокод на следующую покупку» — и бот сам пришлёт строку из файла.

💔 Работа с негативом (1–3 ★). Бот сразу пишет: «Вижу низкую оценку — расскажите, что пошло не так, я всё исправлю». Покупатель на Starvell может изменить отзыв, если проблему решили.

🗑️ Удалённый отзыв. Можно отдельно спросить, всё ли в порядке.

🚀 Возможности

• 🎯 Отдельный текст для 1, 2, 3, 4, 5 ★ и для удалённого отзыва — каждый включается своим переключателем.
• 🎁 Подарки за отзывы по принципу автовыдачи: один отзыв — одна строка из .txt-файла.
  • общий файл для всех оценок или свой файл для конкретной оценки;
  • режим «По кругу» — строка не расходуется, а переносится в конец файла;
  • подарок отдельным сообщением или в одном сообщении с ответом;
  • уведомления о каждой выдаче и предупреждение, когда подарков осталось мало.
• 📁 Управление файлами прямо в Telegram: создание, загрузка .txt, добавление строк, скачивание. Файлы общие со встроенной автовыдачей — те же, что в /menu → 📦 Настройки авто-выдачи → 🗂️ Файлы с товарами.
• 🛡 Без повторов. Один заказ — один ответ и один подарок, даже после перезапуска бота. Если сообщение с подарком не отправилось, строка возвращается в начало файла.
• 🚫 Чёрный список. Покупателям из ЧС бота модуль не пишет.

🛠️ Настройка

Шаг 1. Включение

/menu → 🧩 Функции → Review Chat Reply → 🚀 Включить. Затем откройте панель командой /review_reply. Кнопка «Функция: 🟢/🔴» в панели тоже включает и выключает модуль.

Шаг 2. Тексты по оценкам

В панели каждая строка — оценка (слева) и кнопка «Статус: 🟢/🔴» (справа), которая сразу включает или выключает ответ на эту оценку. Строка 🗑 (Удалённый) — ответ на удаление отзыва. Значок 🎁 рядом с оценкой означает, что за неё выдаётся подарок.

По умолчанию у всех оценок нет текста и ответ выключен — настройте хотя бы одну:

1. Нажмите на оценку (например, ⭐⭐⭐⭐⭐).
2. ✏️ Изменить текст → пришлите текст одним сообщением. Отправьте -, чтобы удалить текст.
3. Переключите «Ответ: 🟢» (или «Статус: 🟢» в главной панели).

Если ответ для оценки выключен или текст пустой, текстовый ответ на отзыв с такой оценкой не отправляется. Подарок (если он включён для этой оценки) при этом всё равно придёт — отдельным сообщением.

Примеры:

• 5 ★ — Спасибо, $username! Рад, что всё понравилось. Заглядывайте ещё 🙌
• 1 ★ — $username, вижу оценку $rating ★ по заказу #$order_id. Напишите, пожалуйста, что случилось — постараюсь исправить.

Шаг 3. Подарки 🎁

Чтобы подарок выдался, должны выполняться три условия: включены «Подарки» глобально, включён «🎁 Подарок за оценку» у нужной оценки и выбран файл, в котором есть строки.

1. В панели нажмите 🎁 Подарки за отзывы и включите «Подарки: 🟢 Вкл».
2. 📂 Файл — откроется список файлов: нажмите на существующий, чтобы выбрать его, или ➕ Создать новый файл (пришлите имя, например gifts — .txt добавится сам), или ⬆️ Загрузить .txt. 🚫 Отвязать файл — убрать выбор.
3. ➕ Добавить подарки — пришлите строки одним сообщением, каждая строка = один подарок (добавятся в конец файла). ⬆️ Загрузить .txt — пришлите .txt-документ (до 5 МБ): его строки добавятся в конец выбранного файла. Если файл ещё не выбран, загруженный файл сохранится под своим именем и сразу привяжется. 📥 Скачать файл — получить текущий файл.
4. Откройте нужную оценку и включите «🎁 Подарок за оценку: 🟢». Там же можно выбрать 📂 Свой файл для этой оценки — тогда за неё подарки берутся из него, а не из общего.

Параметры выдачи:

• ✏️ Текст сообщения — шаблон с переменной $gift на месте подарка (по умолчанию: «🎁 Спасибо за отзыв! Держите подарок:» и подарок с новой строки). Если $gift забыли, бот сам допишет подарок последней строкой. Отправьте -, чтобы вернуть стандартный текст.
• 📨 Отдельно — 🟢 подарок отдельным сообщением, 🔴 — вместе с ответом.
• ♾ По кругу — 🟢 строки не расходуются.
• 🔔 Уведомления — сообщение в Telegram о каждой выдаче.
• 📉 Порог — предупреждение, когда в файле останется N подарков или меньше (пришлите целое число, например 5; 0 — выключить). В режиме «По кругу» не используется.

⚠️ За удалённый отзыв подарок не выдаётся.

📋 Переменные

⚙️ Как это работает внутри

На Starvell отзыв приходит системным уведомлением в чат заказа. Модуль ловит его, открывает страницу заказа и берёт оценку (она появляется там с небольшой задержкой, поэтому бот делает несколько попыток), проверяет, что это ваша продажа, и отправляет ответ и подарок в чат с покупателем.

❓ Вопросы

Подарки закончились — что получит покупатель? Только текст ответа (если он включён для этой оценки). Вам придёт уведомление «📭 Подарки закончились».

Отзыв оставили, а бот ничего не написал. Проверьте: модуль включён (в панели «Функция: 🟢»), для этой оценки включён ответ и задан текст, покупатель не в чёрном списке. Отзывы, оставленные пока модуль был выключен, не обрабатываются.

Можно ли давать разные подарки за 4 и 5 звёзд? Да: в настройке оценки нажмите 📂 Свой файл и привяжите отдельный файл, например bonus_4.txt и bonus_5.txt.

Покупатель удалил отзыв и оставил новый — ответит ли бот снова? На удаление бот ответит текстом для «🗑 Удалённый» (если он включён). На повторный отзыв по тому же заказу бот второй раз не пишет — ответ и подарок по одному заказу отправляются только один раз, чтобы покупатель не мог «фармить» подарки удалением и повторной публикацией отзыва.