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

Buyer Notes — личная CRM прямо в Telegram. Оставьте заметку о покупателе: «постоянный клиент, скидка 5%», «берёт оптом» или «требует возврат по пустякам». Когда этот человек снова напишет вам в чат FunPay или оформит заказ, бот пришлёт заметку в Telegram с кнопкой «💬 Открыть чат» — и вы ответите, уже зная, с кем говорите.

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

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

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

• Заметка одной командой: /note Ник текст — к любому нику FunPay, до 1000 знаков, можно в несколько строк.
• Уведомление о сообщении: покупатель с заметкой пишет в чат — бот присылает заметку, не чаще раза в 5 минут на покупателя, чтобы не спамить.
• Уведомление о заказе: покупатель с заметкой оформил заказ — уведомление со ссылкой на заказ приходит сразу, без паузы.
• Кнопка «💬 Открыть чат»: в каждом уведомлении — переход в диалог с покупателем на FunPay.
• Список заметок: /notes — все заметки, новые сверху; длинный список приходит несколькими сообщениями.
• Без учёта регистра: Ник, ник и @ник — один и тот же покупатель.

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

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

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

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

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

ШАГ 2. Добавьте заметку

1. /notes (или «⚙️ Открыть настройки» в карточке плагина) → «➕ Заметка» → пришлите Ник постоянный клиент, скидка 5% — всё, что после ника, станет текстом заметки.
2. Бот ответит «✅ Заметка сохранена» и покажет её.
3. Новая заметка о том же покупателе заменяет прежнюю. Символ @ перед ником писать не нужно.

💡 Ник берите точно как на FunPay — по нему бот узнаёт покупателя в чате и в заказах.

ШАГ 3. Получайте уведомления

1. Покупатель с заметкой написал в чат — придёт «💬 Пишет покупатель с заметкой» и текст заметки.
2. Следующее уведомление о его сообщениях — не раньше чем через 5 минут, даже если он пишет много.
3. Покупатель с заметкой оформил заказ — придёт «🛒 Заказ #… от покупателя с заметкой» сразу, со ссылкой на заказ.

ШАГ 4. Смотрите и удаляйте заметки

1. /notes — все заметки, новые сверху.
2. «🗑 Удалить» → ник — удалить заметку.
3. /note Ник — показать заметку об одном покупателе.

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

Панель /notes

Сверху — сколько заметок, ниже — все заметки, новые сверху.

• ➕ Заметка — ник и текст; заметка о том же покупателе заменит прежнюю
• 🗑 Удалить — пришлите ник покупателя
• ⬅️ Назад — к карточке плагина

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

1. Покупатель пишет вам в чат FunPay или оформляет заказ.
2. Плагин ищет его ник среди ваших заметок (без учёта регистра).
3. Ваши собственные сообщения, сообщения бота и системные сообщения FunPay он пропускает.
4. Заметка нашлась — уведомление уходит всем, кто вошёл в Telegram-бота по паролю: о сообщениях — не чаще раза в 5 минут, о заказе — сразу.

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

Покупатель с заметкой пишет в чат

💬 Пишет покупатель с заметкой
📝 Ник: постоянный клиент, скидка 5%
[💬 Открыть чат]

Покупатель с заметкой оформил заказ

🛒 Заказ #ABCD1234 от покупателя с заметкой
📝 Ник: постоянный клиент, скидка 5%
[💬 Открыть чат]

⌨️ Команды

• /note — добавить или заменить заметку: /note Ник текст; без текста — показать заметку
• /notes — все заметки, новые сверху
• /note_del — удалить заметку: /note_del Ник

💡 Важно знать

• Покупатель заметок не видит: они хранятся только в вашем боте и приходят только вам в Telegram.
• Одна заметка на покупателя: чтобы дописать, отправьте /note Ник с полным новым текстом.

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

Покупатель видит заметки?

Нет, заметки хранятся только в вашем боте и приходят только вам в Telegram.

Сколько заметок можно хранить?

Сколько угодно, по одной на покупателя. Длинный список /notes бот присылает несколькими сообщениями.

Кому приходят уведомления?

Всем, кто вошёл в Telegram-бота по паролю.

Почему пришло только одно уведомление, хотя покупатель написал несколько сообщений?

Так задумано: о сообщениях одного покупателя бот напоминает не чаще раза в 5 минут. О заказе уведомление приходит всегда.