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

Встроенный автоответчик бота отвечает только на точную команду. Keyword Reply ловит слово или фразу в любом месте сообщения: «а сколько стоит?», «гарантия есть?», «когда будет?». Правил сколько угодно, срабатывает первое подходящее, ответ может быть с картинкой. Одно и то же правило отвечает в один чат не чаще раза за паузу, а на свои сообщения, системные сообщения FunPay, поддержку и покупателей из чёрного списка бот не отвечает.

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

1. Покупатель получает ответ сразу: на частые вопросы — цена, гарантия, сроки — не нужно отвечать вручную.
2. Ловит живую речь: покупатели не пишут точные команды, а спрашивают своими словами.
3. Без спама: пауза не даёт боту отвечать одно и то же на каждое сообщение.

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

• Слово в любом месте: «цена» сработает и на «а какая цена?». Без учёта регистра, «е» и «ё» — одно и то же, лишние пробелы не мешают.
• Несколько слов на правило: «цена, сколько стоит, почём» — через запятую.
• Пауза: одно правило в один чат — не чаще раза в 60 минут (настраивается, 0 — на каждое сообщение).
• «👤 Только покупателям»: отвечать только тем, у кого уже был заказ у вас.
• «🔤 Целым словом»: «код» не сработает на «кода» или «эпизод».
• Ответ с картинкой: пришлите фото с командой в подписи — бот загрузит его на FunPay.
• Переменные: $username, $chat_name, $date, $time подставляются в ответ.
• Не мешает автоответчику: точные команды встроенного автоответчика плагин пропускает.

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

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. Добавьте правило: /keywords → «➕ Добавить правило» → слова и ответ.
3. Проверьте со второго аккаунта FunPay.

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

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

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

ШАГ 2. Добавьте первое правило

1. /keywords (или «⚙️ Открыть настройки» в карточке плагина) → «➕ Добавить правило».
2. Первой строкой — слова или фразы через запятую, например «цена, сколько стоит»; со второй строки — текст ответа, до 2000 знаков.
3. Коротко в одну строку: гарантия = Гарантия 30 дней.

ШАГ 3. Ответ с картинкой (по желанию)

1. Пришлите боту фото, а в подписи — ту же команду /kw_add с текстом.
2. Бот загрузит картинку на FunPay и будет отправлять её вместе с ответом.

ШАГ 4. Настройте правила

1. В /keywords у каждого правила кнопки: ✅ вкл/выкл, 👤 только покупателям, 🔤 только целым словом, 🗑 удалить.
2. Правила проверяются сверху вниз, срабатывает первое подходящее — точные фразы добавляйте раньше общих слов.
3. В ответе работают переменные $username, $chat_name, $date, $time.

💡 Порядок правил — порядок добавления. Чтобы поднять правило выше, удалите общее и добавьте его заново после точного.

ШАГ 5. Задайте паузу

1. «⏱ Пауза: 60 мин» → пришлите число минут — одно и то же правило в один чат срабатывает не чаще раза в столько минут (по умолчанию 60).
2. 0 — отвечать на каждое сообщение.

ШАГ 6. Проверьте

1. Напишите ключевое слово со второго аккаунта FunPay. На сообщения со своего аккаунта бот не отвечает.

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

Панель /keywords

Сверху — сколько правил и пауза, ниже — правила: слова → ответ, 👤 и 🔤 — у правил с этими опциями.

• ➕ Добавить правило — слова или фразы через запятую и ответ — со второй строки или после «=»
• ⏱ Пауза: N мин — через сколько минут одно правило может снова ответить в тот же чат; 0 — на каждое сообщение
• ⬅️ Назад — к карточке плагина

Кнопки у каждого правила в /keywords

• N: ✅ / ❌ — правило включено или выключено
• 👤 ✅ / ❌ — отвечать только тем, у кого уже был заказ у вас
• 🔤 ✅ / ❌ — слово только целиком: «код» не сработает на «кода»
• 🗑 — удалить правило

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

1. Покупатель пишет сообщение в чат FunPay.
2. Плагин пропускает: ваши сообщения и сообщения бота, системные сообщения FunPay, поддержку и арбитраж, публичные чаты игр, ЧС (если в боте выключены ответы для ЧС) и точные команды встроенного автоответчика.
3. Ищет первое включённое правило, слово которого есть в сообщении.
4. Проверяет паузу: это правило уже отвечало в этот чат недавно — молчит.
5. «Только покупателям» — проверяет на FunPay, был ли у этого покупателя заказ у вас (ответ помнит час).
6. Отправляет ответ с подставленными переменными.

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

Покупатель пишет

Здравствуйте, а гарантия есть?

Бот отвечает по правилу «гарантия»

Гарантия 30 дней. Если что-то пойдёт не так — пишите сюда, решим.

⌨️ Команды

• /keywords — список правил и кнопки управления
• /kw_add — новое правило: /kw_add слова = ответ (или ответ со второй строки)
• /kw_cooldown — пауза между одинаковыми ответами в одном чате, минут

💡 Важно знать

• Общие слова вроде «да», «ок», «код» без «🔤 Целым словом» срабатывают слишком часто — включайте его для коротких слов.
• Пауза считается для каждого правила отдельно: другое правило в том же чате ответит.

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

Ответит дважды вместе со встроенным автоответчиком?

Нет: если сообщение — точная команда встроенного автоответчика, этот плагин его пропускает.

Регистр и буква «ё» важны?

Нет: «Цена», «ЦЕНА» и «цена» — одно и то же, «е» и «ё» тоже, лишние пробелы не мешают.

Почему бот не ответил на второй вопрос покупателя?

Сработала пауза: одно правило отвечает в один чат не чаще раза за /kw_cooldown минут. Другое правило в том же чате ответит.

Где бот не отвечает?

В чатах игр, поддержке и арбитражу, на системные сообщения FunPay, на свои сообщения и сообщения бота, а также покупателям из чёрного списка, если для ЧС выключены ответы.