Basics of Balance in @MenuBuilderBot EN
MegaHubTelegram
This guide will help you set up and manage the Balance in your bot created on the @MenuBuilderBot bot constructor. In your bot, you can create a Balance for each individual user, change it (adding values, rewards and bonuses), notify the user about its change, display user Balance data in the message, as well as download the «Transaction Log» and carry out referral charges.
📜 The translation of this materials into your native language can be automatically done using the Google translator. Follow the link and select the desired language in the title:
https://translate.googleusercontent.com/translate_c?depth=1&sl=en&tl=es&u=https://telegra.ph/Basics-of-Balance-in-MenuBuilderBot-EN-03-24
⬛ The conception of Balance in the system
First of all, balance is a “variable” - a kind of storage for the user's digital data. In essence, “Balance” stores the regular number. What this number will mean in your particular case, it is up to you. The convenience of this concept is that the balance variable storing some abstract value allows the bot administrator to interpret it at his discretion: Bonuses, Tokens, US Dollars, Bitcoins, etc.
The basic functionality includes:
• Storage of values for each bot user.
• Display values for users.
• Manual modification by administrator with user notification
• Automatic updates carried by the Referral system
Access to balance management can only be obtained by the administrator using the «💵 Balance» button in the Main Menu:
⬛ Showing the user his individual Balance
To display the user’s balance, use the macros (what is a macros):
This macros can be placed in the Start message, in the Normal menu message or in the Mailing message.
Create a message with macros:
Look at the result:
In the message shown, instead of the %balance% macros, the user will be shown the status of his personal balance, individually to each user.
⬛ Balance Management
When you press «💵 Balance» in the «Main Menu», you will see the balance control buttons:
You can only work with balance values of those users whose data you know. To do this, you will need a User ID, User Code or any message from which you can get this data.
You can find out the user data if he:
• Should write you a QnA chat form. (the identifier will be in the title)
• Should pay you and thereby leave his User Code in the payment.
• Should write you a personal message (User ID can be obtained from the message by sending it ("Forwarding") to his bot).
You CANNOT get any data of a user who did not contact you in one of the above ways or did not consider it necessary to leave his data in your bot using functions that require a User ID for their work (Bonuses, Exchanges, referrals invitations, etc.).
The data of random users (who just went to see the bot) is not accessible to the admin - this is the principal position of the @MenuBuilderBot project.
About how to export user data to a table will be written in the "Additional Information" section near the end of the document.
Button «Get».
The «Get» button allows you to get the balance value of an individual user. After clicking you will be asked to indicate User ID, User Code or “Forward” the user's message whose balance in the bot you want to know:
Send any data, which specified above, to the bot and get the balance of this user:
If a user with identification data you have provided is not registered in your bot you will receive an error message:
«Change» Button.
The «Change» button allows you to change the balance relatively to the existing value. Use it if you need to add or subtract any amount.
At first, you will also be asked to identify the user by indicating his data (see the «Get» button), after receiving it, your bot will request a value for modification:
Send a positive value to add the amount, or a negative value to subtract it from the user balance. After which you will see the updated balance value:
«Set» Button.
The «Set» button allows you to set a specific value for the user's balance. Regardless of the current state of the user’s balance itself. The current balance will be overwritten.
At first, you will also be asked to identify the user by indicating his data (see the «Get» button), after which, your bot will ask for a value to set instead of the old one:
Submit a value to set it as a new user balance.
We emphasize once again: in this case, the current balance will be overwritten, regardless of its current state.
🟦 INFO: Balance, same as any other variable, can be changed using commands, for how to do this, see the corresponding guides by links in this message.
Referral bonus.
You (admin) can set the bonus that the user (Referral Parent) will receive on his balance when a new referral comes to the bot by his referral link. It should be only one numeric value per line, which will be added to the Referral Parent’s Balance. In the chat message above the Text Input Box, you will see the current referral bonus state.
Click the «Referral Bonus» button and send a value to the bot that will be added to the Referral Parent’s balance:
If a Multilevel Referral System is activaetd in your bot, you can set a referral bonus separately for each referral level. See the “More Information” section closer to the end of the document for details.
Notify user.
«Notify user» - this option allows you to enable the user to be notified about a change in his balance. With each modification of the balance (manual, referral, automatic etc.), the user will receive a notification:
Download the Log.
@MenuBuilderBot can log every transaction that has changed the user's balance. Such a journal will be useful for tracking problems and resolving conflicts with users in situations such as: “what happened to my balance!?”.
You can download (paid function) a log (journal) in CSV format (separated with semicolon) by clicking the «Download Log» button. Such files are opened using Excel-like programs (LibreOffice, OpenOffice, etc.) to search and analyze information.
⬛ Additional Information
◾ The system allows you to accept auto payments and credit those amounts to the balance of users in the bot.
When a user transfers funds to your wallet in one of the electronic payment systems (such as Qiwi, Yandex, Payeer, CoinBase and others), the funds will automatically be credited to the balance of the user in the bot.
For more information on Automatic Balance Replenishment, see the help bot.
◾ The system allows you to automate the work with the Balance by crediting bonuses on it and making exchanges without the participation of the administrator.
To automate changes in the Balance and for the user to be able to change his balance on his own (receiving bonuses, making purchases and exchanges in your bot), you can use the «Bonus» and the «Exchange» type buttons.
For more information on Bonuses and Exchange operations, see the help bot.
◾ The system allows you to download all the available data of your users in the form of a table (including Balances).
When working with a bot, a simple downloading of a «Balance Log» is not always enough, the administrator sometimes needs other user data, for example, to compare it with the balance data (in the constructor it is possible to receive and store the data from the user). In this case, the «User Data Export» will help you. That Exported file, will contain the data of all variables for each user (who has this data) in the form of a table.
For more information on User Data Export, see the help bot.
◾ The constructor allows you to create referral systems, of unlimited depth, in the bot with accruals to the balance.
In this case, you can set a referral bonus with accrual to the Balance (or to any other variable) separately for each Referral Level.
For more information about the accruals of a multi-level referral system, see our help bot.
◾ The system allows you to add (accrue) bonuses to the Referral Parent if his referral’s variable was changed.
Upon user purchase of goods, replenishment or other changes in the Balance (or any other numerical variable), the Referral Parent of that user may be automatically rewarded.
For more information about the accruals for Referral Parent, see our help bot.
