Баланс и Редактор переменных
Данное руководство поможет вам настроить и управлять Балансами юзеров в вашем боте созданном на конструкторе ботов @MenuBuilderBot. В вашем боте можно создать Баланс для каждого отдельного пользователя, изменять его (добавляя значения, вознаграждения и бонусы), оповещать пользователя об его изменении, выводить данные юзера в сообщении, а также скачать «Лог Транзакций» и осуществлять реферальные начисления.
Всё описанное в данном руководстве в равной мере относится и к любым другим ЧИСЛОВЫМ переменным в вашем боте которые вы можете добавить самостоятельно. А сам Редактор Баланса - это по сути своей «Редактор Переменных» - который можно назначить любой кнопке вашего бота.
❖ Концепция Баланса в системе
Баланс это прежде всего «переменная» — некое хранилище для цифровых данных пользователя. По сути «Баланс» хранит обычное число — что это число будет означать в вашем конкретном случае — зависит только от вас. Удобство данной концепции в том что переменная баланса храня некое абстрактное значение позволяет администратору бота интерпретировать его по своему усмотрению: Бонусы, Токены, Доллары США, Биткоины и т.д.
Базовый функционал включает в себя:
• Хранение значений для каждого пользователя бота.
• Отображение значений для пользователей.
• Ручная модификация администратором с оповещением юзера.
• Автоматическое обновление по Реферальной системе.
Доступ к управлению балансом может быть получен только администратором при помощью кнопки «💵 Баланс» в Главном Меню:
Если кнопка «💵 Баланс» отсутствует в Главном Меню - значит ВЫ отключили её отображение.
Чтобы включить,перейдите в вашем боте:☞ 🔐Админ | ⚙ Настройки Бота
Еще раз напоминаем что кнопка «💵 Баланс» это по сути «Редактор Переменных» - который можно назначить любой кнопке вашего бота.
❖ Показ юзеру его индивидуального Баланса
Чтобы отобразить пользователю его баланс, используйте макрос (что такое макрос):%balance%
Данный макрос можно размещать в Стартовом сообщении, в Обычном сообщении меню или в сообщении Рассылки.
Создайте сообщение с макросом(ами):
Посмотрите на результат:
В готовом сообщении вместо макроса %balance%, юзеру будет показано состояние его личного баланса — каждому юзеру индивидуально.
❖ Управление Балансом
Редактор Баланса
Когда вы нажмёте кнопку «💵 Баланс» в Главном Меню, вы увидите элементы управления балансом:
Количество кнопок в редакторе баланса может отличаться в зависимости от количества подключенных плагинов и расширений.
Вы можете работать со значениями баланса только тех пользователей, данные которых вам известны. Для этого вам понадобится ID юзера (User ID), Код юзера (User Code) или любое его сообщение из которого можно получить эти данные.
Вы сможете узнать данные пользователя, если он:
• Напишет вам в форму QnA чат. (идентификатор будет в заголовке).
• Заплатит вам и оставит тем самым свой Код в платеже.
• Напишет вам личное сообщение (User ID можно получить из сообщения переслав («forward») его боту).
Вы НЕ МОЖЕТЕ получить никаких данных пользователя который не вступал с вами в контакт одним из выше перечисленных способов или не посчитал нужным оставить свои данные в вашем боте используя функции требующие User ID для своей работы (Бонусы, Обмены, приглашение рефералов и т. п.).
Данные случайных пользователей (которые просто зашли посмотреть бот) админу не доступны — это принципиальная позиция этики проекта @MenuBuilderBot.
О том как экспортировать данные юзеров в таблицу будет написано в разделе «Дополнительная Информация» ближе к концу документа.
Кнопка «Узнать»
Кнопка «Узнать» позволяет вам получить значение баланса отдельного юзера. После нажатия вас попросят указать User ID, User Code или переслать («forward») сообщение юзера баланс которого в боте вы хотите узнать:
Отправьте боту что-либо из указанных данных и получите баланс данного юзера:
Если юзер с такими данными не зарегистрирован в вашем боте - вам будет показано сообщение об ошибке:
Кнопка «Изменить»
Кнопка «Изменить» позволяет изменять показания баланса относительно существующего значения. Используйте её если вам нужно добавить или отнять какую-либо сумму.
Вначале, вас также попросят идентифицировать пользователя указав его данные (см. кнопку «Узнать»).
Если вы хотите добавить комментарий к сообщению об изменении данных в переменной (balance в данном случае), то перед вводом UserCode, снизу можно включить опцию "с комментарием", тогда следующим шагом бот запросит комментарий, текст которого будет показан вместе с сообщением об изменении баланса.
После указания UserCode (и комментария) бот запросит значение для модификации:
Отправьте положительное значение, чтобы добавить сумму, или отрицательное значение, чтобы вычесть его из пользовательского баланса. После чего вы увидите обновленное значение баланса:
Кнопка «Задать»
Кнопка «Задать» позволяет вам установить конкретное значение баланса пользователя. Вне зависимости от текущего состояния баланса юзера. Текущий баланс при этом будет перезаписан.
Вначале, вас также попросят идентифицировать пользователя указав его данные (см. кнопку «Узнать»), для данного режима так же доступна возможность добавления комментария (см. кнопку «Изменить»), после этого бот запросит значение для установки вместо старого:
Отправьте значение, чтобы установить его в качестве нового баланса пользователя.
Еще раз подчеркиваем: в этом случае текущий баланс будет ПЕРЕЗАПИСАН, вне зависимости от его нынешнего состояния.
Баланс как и любая другая переменная может быть изменен при помощи команд, о том как это сделать смотрите в соответствующих руководствах по ссылкам в этом сообщении.
Реферальный бонус
Вы (админ) можете установить бонус, который пользователь (Реферальный Родитель) получит на свой баланс, когда новый реферал придет в бот по его реферальной ссылке. Это должно быть только одно числовое значение в строке - которое и будет добавлено к Балансу Реферального Родителя. В сообщении над строкой ввода вы увидите текущий установленный реферальный бонус(ы).
Нажмите кнопку «Реферальный бонус» и отправьте боту значение, которое будет добавлено на баланс Реферального Родителя:
Если в вашем боте подключена Многоуровневая Реферальная Система, вы можете установить реферальный бонус отдельно для каждого уровня реферала. Подробнее смотри в разделе «Дополнительная Информация» ближе к концу документа.
Уведомить пользователя
«Уведомить юзера» - это опция позволяет вам включить оповещение пользователя об изменении его баланса. При каждой модификации баланса (ручной, реферальный, автоматический и т.д.) пользователь получит уведомление:
Скачать журнал (Log)
Вы можете скачать журнал в формате CSV (разделенный точкой с запятой), нажав кнопку «Скачать Лог». Такие файлы открываются, используя Excel-подобные программы (LibreOffice, OpenOffice и др.) для поиска и анализа информации.
Функционал раздела «🧩Расширения»: для использования, функция должна быть активирована в вашем боте.
Лог транзакций баланса.
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Логи и Данные
❖ Дополнительная Информация
Как принимать авто платежи и зачислять их суммы на баланс юзеров в боте?
При переводе юзером средств на ваш кошелек одной из электронных платежных систем (таких как Киви, ЮMoney, Payeer, CoinBase, Perfect Money, Tron, Binance и других), средства автоматически будут зачислены на баланс этого юзера в боте.
Подробнее об Автоматическом Пополнении Баланса смотри в Боте Помощи.
• • •
Как автоматизировать работу с Балансом начисляя на него Бонусы и о совершая Обмены без участия админа?
Для автоматизации изменения Баланса и чтобы дать возможность юзеру менять свой баланс самостоятельно (получая бонусы, совершая покупки и обмены в вашем боте), можно использовать «Бонус» кнопки и кнопки «Обмена».
Подробнее о Бонусах и Обмененных операциях смотри в Боте Помощи.
• • •
Как скачивать все имеющиеся данные ваших юзеров в виде таблицы (в том числе и Балансы).
При работе с ботом, одного скачивания «Лога Баланса» бывает не достаточно, админу иногда нужны и другие данные юзера, например чтобы сопоставить их с данными баланса (в конструкторе существует возможность принимать и хранить данные полученные от юзера). В этом случае вам поможет «Экспорт Данных Юзера». В нем в виде таблицы будут представлены данные всех переменных для каждого юзера (у кого эти данные есть).
Подробнее об Экспорте Данных Юзера смотри в Боте Помощи.
• • •
Как создавать в боте реферальные системы с начислением на баланс - не ограниченной глубины.
Вы можете установить реферальный бонус с начислением на Баланс (или в любую другую переменную) отдельно для каждого уровня реферала.
Подробнее о начислениях многоуровневой реферальной системы смотри в Боте Помощи.
• • •
Как начислять бонусы Реферальному Родителю при изменении переменной его реферала.
При покупке товара, пополнении или другом изменении Баланса (или любой другой числовой переменной) Реферальному Родителю юзера может быть начислено вознаграждение.
Подробнее о начислениях Реферальному родителю смотри в Боте Помощи.