Основы управления Балансом в @MenuBuilderBot

Данное руководство поможет вам настроить и управлять Балансами юзеров в вашем боте созданном на конструкторе ботов @MenuBuilderBot. В вашем боте можно создать Баланс для каждого отдельного пользователя, изменять его (добавляя значения, вознаграждения и бонусы), оповещать пользователя об его изменении, выводить данные юзера в сообщении, а также скачать «Лог Транзакций» и осуществлять реферальные начисления.

📜 Перевод представленных материалов на ваш родной язык может быть автоматически осуществлен при помощи переводчика Google. Перейдите по ссылке и выберите нужный язык в заголовке:
https://translate.googleusercontent.com/translate_c?depth=1&sl=ru&tl=es&u=https://telegra.ph/Basics-of-Balance-in-MenuBuilderBot-RU-03-24

⬛ Концепция Баланса в системе

Баланс это прежде всего «переменная» — некое хранилище для цифровых данных пользователя. По сути «Баланс» хранит обычное число — что это число будет означать в вашем конкретном случае — зависит только от вас. Удобство данной концепции в том что переменная баланса храня некое абстрактное значение позволяет администратору бота интерпретировать его по своему усмотрению: Бонусы, Токены, Доллары США, Биткоины и т.д.

Базовый функционал включает в себя:

• Хранение значений для каждого пользователя бота.

• Отображение значений для пользователей.

• Ручная модификация администратором с оповещением юзера

• Автоматическое обновление по Реферальной системе

Доступ к управлению балансом может быть получен только администратором при помощью кнопки «💵 Баланс» в Главном Меню:

Расположение кнопки Баланс в нижнем меню.

⬛ Показ юзеру его индивидуального Баланса

Чтобы отобразить пользователю его баланс, используйте макрос (что такое макрос):

Данный макрос можно размещать в Стартовом сообщении, в Обычном сообщении меню или в сообщении Рассылки.

Создайте сообщение с макросом(ами):

Текст с макросами при создании сообщения.

Посмотрите на результат:

Подставленные значения макросов в готовом сообщении.

В готовом сообщении вместо макроса %balance%, юзеру будет показано состояние его личного баланса — каждому юзеру индивидуально.

⬛ Управление Балансом

Когда вы нажмёте кнопку «💵 Баланс» в Главном Меню, вы увидите элементы управления балансом:

Количество кнопок в редакторе баланса может отличаться в зависимости от количества подключенных плагинов и расширений.

Вы можете работать со значениями баланса только тех пользователей, данные которых вам известны. Для этого вам понадобится ID юзера (User ID), Код юзера (User Code) или любое его сообщение из которого можно получить эти данные.

Вы сможете узнать данные пользователя, если он:

• Напишет вам в форму QnA чат. (идентификатор будет в заголовке)

• Заплатит вам и оставит тем самым свой Код в платеже.

• Напишет вам личное сообщение (User ID можно получить из сообщения переслав («forward») его боту).

Вы НЕ МОЖЕТЕ получить никаких данных пользователя который не вступал с вами в контакт одним из выше перечисленных способов или не посчитал нужным оставить свои данные в вашем боте используя функции требующие User ID для своей работы (Бонусы, Обмены, приглашение рефералов и т. п.).

Данные случайных пользователей (которые просто зашли посмотреть бот) админу не доступны — это принципиальная позиция проекта @MenuBuilderBot.

О том как экспортировать данные юзеров в таблицу будет написано в разделе «Дополнительная Информация» ближе к концу документа.

Кнопка «Узнать».

Кнопка «Узнать» позволяет вам получить значение баланса отдельного юзера. После нажатия вас попросят указать User ID, User Code или переслать («forward») сообщение юзера баланс которого в боте вы хотите узнать:

Отправьте боту что-либо из указанных данных и получите баланс данного юзера:

Если юзер с такими данными не зарегистрирован в вашем боте - вам будет показано сообщение об ошибке:

Кнопка «Изменить».

Кнопка «Изменить» позволяет изменять показания баланса относительно существующего значения. Используйте её если вам нужно добавить или отнять какую-либо сумму.

Вначале, вас также попросят идентифицировать пользователя указав его данные (см. кнопку «Узнать»), после получения бот запросит значение для модификации:

Отправьте положительное значение, чтобы добавить сумму, или отрицательное значение, чтобы вычесть его из пользовательского баланса. После чего вы увидите обновленное значение баланса:

Кнопка «Задать».

Кнопка «Задать» позволяет вам установить конкретное значение баланса пользователя. Вне зависимости от текущего состояния баланса юзера. Текущий баланс при этом будет перезаписан.

Вначале, вас также попросят идентифицировать пользователя указав его данные (см. кнопку «Узнать»), после этого бот запросит значение для установки вместо старого:

Отправьте значение, чтобы установить его в качестве нового баланса пользователя.

Еще раз подчеркиваем: в этом случае текущий баланс будет перезаписан, вне зависимости от его нынешнего состояния.

🟦 ИНФО: Баланс как и любая другая переменная может быть изменен при помощи команд, о том как это сделать смотрите в соответствующих руководствах по ссылкам в этом сообщении.

Реферальный бонус.

Вы (админ) можете установить бонус, который пользователь (Реферальный Родитель) получит на свой баланс, когда новый реферал придет в бот по его реферальной ссылке. Это должно быть только одно числовое значение в строке - которое и будет добавлено к Балансу Реферального Родителя. В сообщении над строкой ввода вы увидите текущий установленный реферальный бонус(ы).

Нажмите кнопку «Реферальный бонус» и отправьте боту значение, которое будет добавлено на баланс Реферального Родителя:

Если в вашем боте подключена Многоуровневая Реферальная Система, вы можете установить реферальный бонус отдельно для каждого уровня реферала. Подробнее смотри в разделе «Дополнительная Информация» ближе к концу документа.

Уведомить пользователя.

«Уведомить юзера» - это опция позволяет вам включить оповещение пользователя об изменении его баланса. При каждой модификации баланса (ручной, реферальный, автоматический и т.д.) пользователь получит уведомление:

Скачать журнал (Log).

@MenuBuilderBot может регистрировать каждую транзакцию, которая изменила баланс пользователя. Такой журнал будет полезен для отслеживания проблем и разрешения конфликтов с пользователями в ситуациях типа: «что случилось с моим балансом!?».

Вы можете скачать (функция платная) журнал в формате CSV (разделенный точкой с запятой), нажав кнопку «Скачать Лог». Такие файлы открываются, используя Excel-подобные программы (LibreOffice, OpenOffice и др.) для поиска и анализа информации.

⬛ Дополнительная Информация

◾ Система позволяет принимать авто платежи и зачислять их суммы на баланс юзеров в боте.

При переводе юзером средств на ваш кошелек одной из электронных платежных систем (таких как Киви, Яндекс, Payeer, CoinBase и других), средства автоматически будут зачислены на баланс этого юзера в боте.

Подробнее об Автоматическом Пополнении Баланса смотри в Боте Помощи.

◾ Система позволяет автоматизировать работу с Балансом начисляя на него Бонусы и о совершая Обмены без участия админа.

Для автоматизации изменения Баланса и чтобы дать возможность юзеру менять свой баланс самостоятельно (получая бонусы, совершая покупки и обмены в вашем боте), можно использовать «Бонус» кнопки и кнопки «Обмена».

Подробнее о Бонусах и Обмененных операциях смотри в Боте Помощи.

◾ Система позволяет скачивать все имеющиеся данные ваших юзеров в виде таблицы (в том числе и Балансы).

При работе с ботом, одного скачивания «Лога Баланса» бывает не достаточно, админу иногда нужны и другие данные юзера, например чтобы сопоставить их с данными баланса (в конструкторе существует возможность принимать и хранить данные полученные от юзера). В этом случае вам поможет «Экспорт Данных Юзера». В нем в виде таблицы будут представлены данные всех переменных для каждого юзера (у кого эти данные есть).

Подробнее об Экспорте Данных Юзера смотри в Боте Помощи.

◾ Конструктор позволяет создавать в боте реферальные системы с начислением на баланс - не ограниченной глубины.

При этом вы можете установить реферальный бонус с начислением на Баланс (или в любую другую переменную) отдельно для каждого уровня реферала.

Подробнее о начислениях многоуровневой реферальной системы смотри в Боте Помощи.

◾ Система позволяет начислять бонусы Реферальному Родителю при изменении переменной его реферала.

При покупке товара, пополнении или другом изменении Баланса (или любой другой числовой переменной) Реферальному Родителю юзера может быть начислено вознаграждение.

Подробнее о начислениях Реферальному родителю смотри в Боте Помощи.