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

AI Reviews отвечает на новые отзывы покупателей текстом от нейросети — живо и каждый раз по-разному, с ником покупателя, названием товара и с учётом того, что он написал. Можно отвечать только на отзывы с нужным числом звёзд и дополнительно писать покупателю тёплое сообщение в чат.

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

1. Ответ на каждый отзыв: продавец, который отвечает на отзывы, выглядит живым и внимательным.
2. Не шаблон: нейросеть каждый раз пишет новый текст по отзыву покупателя.
3. Без лишних ответов: плохие отзывы можно оставить себе — бот отвечает только начиная с заданной оценки.

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

• Провайдеры: OpenRouter, OpenAI или Gemini; по умолчанию OpenRouter с моделью openai/gpt-4o-mini.
• Резервные модели: основная не ответила — плагин пробует резервные (до 10), по умолчанию google/gemini-2.0-flash.
• Порог звёзд: отвечать на отзывы от N★ (по умолчанию от 4★).
• Кулдаун: не отвечать одному покупателю чаще раза в N секунд (по умолчанию 60).
• Свои промпты: для ответа на отзыв и для сообщения в чат; подстановки {name}, {item}, {rating}, {text}, {cost}, {currency}, {category}.
• Сообщение в чат: по желанию — короткая благодарность покупателю (до 500 знаков); по умолчанию выключено.
• Предпросмотр промпта и история последних ответов.
• Без своего ключа — общий ключ ИИ из /ai_keys.

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

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. /aireviews → «🧠 Провайдер» и ключ — или общий ключ в /ai_keys.
3. Выберите модель и порог звёзд.

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

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

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

ШАГ 2. Шаг 1. Провайдер

1. /aireviews → 🧠 Провайдер — OpenRouter, OpenAI или Gemini, затем 🔑 ключ.

ШАГ 3. Шаг 2. Модель

1. 🎯 Основная модель и 🔁 Резервные модели.

ШАГ 4. Шаг 3. Правила

1. ⭐ Мин. оценка, ⏱ Кулдаун.
2. 📝 Промпт отзыва и 💬 Промпт чата; 👁 Превью промпта — посмотреть, что уйдёт в нейросеть.

ШАГ 5. Общий ключ ИИ (вместо своего)

1. /ai_keys — один ключ на GPT Consultant, AI Reviews и Auto Report: OpenRouter, Groq, Gemini, io.net (есть бесплатные лимиты), DeepSeek, OpenAI.
2. /ai_key groq КЛЮЧ — сохранить (бот проверит ключ и удалит сообщение с ним). Свой ключ в настройках плагина важнее общего.

ШАГ 6. Прокси для нейросетей

1. Запросы к нейросетям идут через общий прокси MUVSell: из России OpenAI, Claude, OpenRouter, Groq и Gemini напрямую не отвечают.
2. Свой прокси: /ai_proxy http://логин:пароль@IP:порт, снова общий — /ai_proxy -. Текущий — внизу /ai_keys.

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

Меню /aireviews

Сверху — провайдер, модели, минимальная оценка, кулдаун и включено ли сообщение в чат.

• 🧠 Провайдер — OpenRouter, OpenAI или Gemini и «🔑 Ключ» каждого
• 🎯 Основная модель — модель для ответов
• 🔁 Резервные модели — модели на случай, если основная не ответила
• ⭐ Мин. оценка — с какой оценки отвечать (1–5)
• 📝 Промпт отзыва — задание нейросети для ответа на отзыв
• 💬 Промпт чата — задание для сообщения покупателю в чат
• 💬 В чат: 🟢 / 🔴 — писать ли покупателю в чат после ответа на отзыв
• ⏱ Кулдаун — пауза между ответами одному покупателю, секунд (0–86400)
• 👁 Превью промпта — что именно уйдёт в нейросеть
• 🗂 Последние ответы — история: заказ, оценка, модель
• 🔗 Полезные ссылки — ваши ссылки в меню плагина (по умолчанию пусто)

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

1. Покупатель оставил или изменил отзыв — бот открывает заказ и смотрит оценку.
2. Оценка ниже порога или сработал кулдаун — пропускает.
3. Подставляет данные заказа в промпт и спрашивает нейросеть: основную модель, потом резервные.
4. Отправляет ответ на отзыв на FunPay (до 800 знаков, до 3 попыток).
5. Если включено — пишет покупателю короткое сообщение в чат.

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

Промпт отзыва (по умолчанию)

Привет! Ты — ИИ-ассистент магазина. Покупатель {name} оценил товар «{item}» на {rating}/5 и написал: «{text}». Ответь в доброжелательном тоне, поблагодари за покупку, добавь эмодзи. Без упоминания других ресурсов. До 800 символов.

⌨️ Команды

• /aireviews — меню плагина
• /ai_keys — общие ключи ИИ для всех ИИ-плагинов
• /ai_key ПОСТАВЩИК КЛЮЧ — сохранить общий ключ
• /ai_proxy — свой прокси для нейросетей (- — снова общий)

💡 Важно знать

• Если все модели недоступны, ответ не отправляется — бот пришлёт вам «❌ AIReviews: не удалось сгенерировать ответ на отзыв».
• Свой ключ в настройках плагина важнее общего из /ai_keys.

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

Сколько это стоит?

Плагин бесплатный, а запросы к нейросети оплачиваются у выбранного провайдера по его тарифам. На OpenRouter есть бесплатные модели.

Нейросеть не ответила — отзыв останется без ответа?

Если основная модель недоступна, плагин пробует резервные из 🔁 Резервные модели. Добавьте хотя бы одну.

Нейросеть отвечает «доступ запрещён» (403)?

С серверов в России OpenAI, Claude, OpenRouter, Groq и Gemini напрямую не отвечают, поэтому запросы ИИ-плагинов идут через общий прокси MUVSell — настраивать ничего не нужно. Свой прокси не из России: /ai_proxy http://логин:пароль@IP:порт (бот проверит его и удалит сообщение), вернуть общий — /ai_proxy -. Прокси один на все ИИ-плагины.