Day 5: Introduction to Bots.Business Libraries

Welcome to Day 5 of the 30-Day Bots.Business JavaScript (BJS) Learning Session! Today, we’re diving into one of the most powerful features of Bots.Business: Libraries. These pre-built tools simplify the process of extending your bot’s functionality and incorporating advanced features without the need to code everything from scratch.

---

What Are Bots.Business Libraries?

Libraries in Bots.Business consist of pre-designed scripts that offer specific features or tools for your bots. Rather than manually coding complex functionalities, you can leverage libraries to efficiently manage tasks such as user resource management, bot protection, or data synchronization with external applications.

---

Popular Libraries in Bots.Business

Here are some commonly utilized libraries you’ll be working with:

1. ResourcesLib

   This library assists in managing user resources like coins, points, energy, etc.

   Example: Track how many virtual coins a user possesses.

2. Guard

   This library safeguards your bot from spammers and abusive behaviors.

   Example: Limit the frequency with which a command can be executed within a specified timeframe.

3. CooldownLib

   This library establishes cooldown periods for commands.

   Example: Prevent users from executing a command too frequently.

4. DatetimeFormatLib

   This library formats and handles dates and times.

   Example: Display the current date in a user-friendly format.

5. TopBoardLib

   This library tracks leaderboards for competitive features.

   Example: Showcase the top 10 users based on their points.

---

How to Use Libraries

Libraries come pre-installed in Bots.Business. To utilize one:

1. Include the library in your bot by adding its script at the top of your command.

2. Employ the library’s methods within your bot’s code.

For instance, to utilize the ResourcesLib, you would write:

let resource = Libs.ResourcesLib.userRes("coins");

This code creates a resource called "coins" for each user.

---

Example 1: ResourcesLib (User Resources)

Let’s develop a system to manage virtual coins for users.

Command 1: /addcoins

Add coins to the user’s account:

let coins = Libs.ResourcesLib.userRes("coins");
coins.add(10); // Adds 10 coins
Bot.sendMessage("You have been given 10 coins! Total coins: " + coins.value());

Command 2: /checkcoins

Check the user’s current coin balance:

let coins = Libs.ResourcesLib.userRes("coins");
Bot.sendMessage("Your total coins: " + coins.value());

Command 3: /spendcoins

Spend coins if the user has enough:

let coins = Libs.ResourcesLib.userRes("coins");

if (coins.have(5)) {
   coins.remove(5);
   Bot.sendMessage("You spent 5 coins! Remaining coins: " + coins.value());
} else {
   Bot.sendMessage("You don’t have enough coins!");
}

---

Example 2: CooldownLib

Cooldowns ensure that users can’t spam a command repeatedly.

Command: /claimreward

Allow users to claim a reward only once every 24 hours:

let cooldown = Libs.CooldownLib;

if (!cooldown.checkCooldown("daily_reward")) {
   Bot.sendMessage("You’ve already claimed your reward today. Try again later.");
   return;
}

cooldown.setCooldown("daily_reward", 24 * 60 * 60); // 24 hours in seconds
Bot.sendMessage("You’ve claimed your daily reward!");

---

Example 3: TopBoardLib (Leaderboard)

Create a leaderboard to track user scores.

Command 1: /addscore

Add a user’s score to the leaderboard:

let leaderboard = Libs.TopBoardLib;
leaderboard.addUser("game_scores", user.telegramid, 100); // Adds 100 points
Bot.sendMessage("You’ve been awarded 100 points!");

Command 2: /leaderboard

Show the top 5 users:

let leaderboard = Libs.TopBoardLib;
let top = leaderboard.getTop("game_scores", 5);

Bot.sendMessage("Top 5 Users:\n" + top);

▎Assignment for Day 5 🎉

1. Create a Coin System: 💰 
   Implement commands /addcoins, /checkcoins, and /spendcoins using ResourcesLib. 
   Bonus: Introduce a feature allowing users to gift coins to other users. 🎁

2. Set Up a Cooldown Command: ⏳ 
   Create a command /dailybonus that grants users 50 coins but only once every 24 hours. 🌟

3. Create a Leaderboard: 📊 
   Utilize TopBoardLib to track and display a leaderboard of user points. 🏆

Day 6: Unlocking the Power of Advanced Libraries – Supercharge Your Bot! 🚀

Welcome to Day 6 of our thrilling 30-day learning adventure! 🎉 Today, we’re diving deep into some of the most powerful libraries available in Bots.Business, designed to elevate your bot's functionality and intelligence. These tools will empower you to protect, organize, and expand your bot with ease and efficiency.

---

▎Libraries We’ll Explore Today

1️⃣ Guard Library (For Command Limitations) 
2️⃣ DatetimeFormatLib (Handling Dates and Times) 
3️⃣ ReferralLib (Building Referral Systems) 

---

▎1. Guard Library: Enforce Command Limits 🛡️

The Guard Library enables you to manage how frequently users can access specific commands, ensuring a smoother user experience.

Example: Temporarily Block a Command for 5 Minutes

if (Libs.Guard.isBlocked()) {  
   Bot.sendMessage("❌ You can only use this command once every 5 minutes.");  
   return;  
}  

Libs.Guard.blockCommand(5 * 60); // Block for 5 minutes  
Bot.sendMessage("✅ Command executed successfully!");

---

▎2. DatetimeFormatLib: Master Dates Times ⏰

This library simplifies the manipulation of dates and times in various formats, making it easy to present time-sensitive information to your users.

Example: Display the Current Date and Time

let currentDate = Libs.DatetimeFormat.format(new Date(), "dddd, MMMM DD YYYY, HH:mm:ss");  
Bot.sendMessage("📅 Current Date and Time: " + currentDate);

---

▎3. ReferralLib: Build an Engaging Referral Program 🌟

The Referral Library is your ticket to creating a robust referral system, allowing you to track user invitations and reward them accordingly.

Example: Reward Users for Referrals

let refUser = Libs.ReferralLib.getAttractedByUser();  

if (refUser) {  
   let referrerCoins = Libs.ResourcesLib.anotherUserRes("coins", refUser.telegramid);  
   referrerCoins.add(10);  
   Bot.sendMessageToChatWithId(refUser.telegramid, "🎉 You earned 10 coins for referring a new user!");
}  
Bot.sendMessage("✅ Referral tracked successfully!");

---

▎Day 6 Challenge 🏆

Put your newfound knowledge to the test with these exciting challenges:

1️⃣ Set a Command Cooldown: Use the Guard Library to limit a command to be executed once every 10 minutes. 
2️⃣ Create a Countdown Timer: Utilize DatetimeFormatLib to display a countdown to a significant date (e.g., New Year). 
3️⃣ Implement a Referral Bonus: Leverage ReferralLib to reward users who successfully invite their friends.

---

▎What’s Next?

Join us tomorrow as we explore dynamic user interactions that will make your bots even more engaging and interactive! Keep practicing, and remember to share your progress with the community! 💪✨

Day 7: Handling Dynamic User Inputs – Creating Interactive Bots! 💬

Welcome to Day 7 of our exciting journey! Today, we're diving into the world of dynamic user inputs to transform your bot into a truly interactive assistant. With these new skills, your bot will be able to engage users by asking questions, collecting responses, and taking action based on their answers. Let’s get started! 🚀

---

▎How It Works:

1️⃣ Ask a Question: Utilize Bot.sendMessage() to prompt the user for information. 
2️⃣ Process the Response: Implement Bot.runCommand() to handle the user's reply in a subsequent command. 
3️⃣ Store or Validate Data: Use User.setProperty() to save responses for future use or validation.

---

▎Examples:

1. Collect and Save User Data

Command 1: /askname

Bot.sendMessage("What is your name?");
Bot.runCommand("/savename");

Command 2: /savename

User.setProperty("name", message, "string");
Bot.sendMessage("Thank you, " + message + "! Your name has been successfully saved.");

---

2. Validate a Password

Prompt the user for a password and verify it:

let correctPassword = "botsbusiness";
if (message == correctPassword) {
    Bot.sendMessage("✅ Access granted! Welcome aboard!");
} else {
    Bot.sendMessage("❌ Incorrect password. Please try again.");
}

---

3. Mini Calculator

Gather two numbers and perform addition:

let num1 = User.getProperty("num1");
let num2 = parseInt(message);
Bot.sendMessage("The sum of " + num1 + " and " + num2 + " is: " + (num1 + num2));

---

▎Assignment:

1️⃣ Build a User Registration System: Create a process to collect and save a user’s name and email address effectively. 
2️⃣ Create a Password Validator: Implement a system that grants or denies access based on user-provided passwords. 
3️⃣ Develop an Interactive Calculator: Design a calculator that can perform addition, subtraction, multiplication, and division based on user inputs.

---

▎Looking Ahead:

Get ready for Day 8, where we’ll explore user management and advanced bot logic! Keep practicing and enhancing your skills! 🌟

Day 8: Advanced User Management – Personalize Your Bots! 👤

Welcome to Day 8! Today, we’ll dive into advanced user management techniques that empower your bot to store, retrieve, and utilize personalized data, enhancing interactivity and user engagement.

---

▎Why Manage Users?

User management allows your bot to:

• Remember user-specific details like name, age, preferences, or scores.

• Personalize responses based on stored data.

• Create features such as progress tracking or user-specific leaderboards.

---

▎How It Works:

1️⃣ Use User.setProperty() to store user-specific data. 
2️⃣ Use User.getProperty() to retrieve data later. 
3️⃣ Employ conditional logic to provide tailored responses.

---

▎Examples:

▎1. Save and Retrieve User Preferences

Save the user's favorite color and use it in future responses.

Command 1: /setcolor 
Bot.sendMessage("What’s your favorite color?"); 
Bot.runCommand("/savecolor");

Command 2: /savecolor 
User.setProperty("color", message, "string"); 
Bot.sendMessage("Got it! Your favorite color is " + message + ".");

Command 3: /getcolor 

let color = User.getProperty("color");
if (color) {
    Bot.sendMessage("Your favorite color is " + color + ".");
} else {
    Bot.sendMessage("I don’t know your favorite color yet. Use /setcolor to tell me!");
}

---

▎2. Track and Display User Progress

Create a bot that tracks user points or achievements.

Command 1: /addpoints 

let points = User.getProperty("points") || 0;
points += 10; // Add 10 points
User.setProperty("points", points, "integer");
Bot.sendMessage("You’ve earned 10 points! 🎉 Total points: " + points);

Command 2: /checkpoints 

let points = User.getProperty("points") || 0;
Bot.sendMessage("Your total points: " + points);

---

▎3. Create User-Specific Access Levels

Grant admin privileges to certain users.

Command 1: /setadmin (for bot owner) 
User.setProperty("isAdmin", true, "boolean"); 
Bot.sendMessage("This user is now an admin.");

Command 2: /checkadmin 

let isAdmin = User.getProperty("isAdmin");
if (isAdmin) {
    Bot.sendMessage("Welcome, Admin! You have full access.");
} else {
    Bot.sendMessage("❌ You are not an admin.");
}

---

▎Assignment:

1️⃣ Create a user profile system that stores a user’s name, age, and favorite color. Use commands to retrieve and display this information.

2️⃣ Track user-specific scores or points and display a message when they reach a milestone (e.g., 100 points).

3️⃣ Build an access control system using user-specific admin roles to restrict certain commands.

---

Tomorrow, in Day 9, we’ll explore custom APIs to connect your bot with external systems and services. Stay tuned and keep experimenting! 🚀

Day 9: Harnessing the Power of Custom APIs – Connect Your Bot to the World! 🌐

Welcome to Day 9 of our journey! Today, we’re diving into the exciting world of Custom APIs, unlocking new dimensions of functionality for your bot. By leveraging APIs, you can enable your bot to interact with external systems, retrieving valuable data such as weather forecasts, stock market trends, and even integrating with a variety of third-party services.

---

▎What Is an API?

An API (Application Programming Interface) serves as a bridge for communication between two systems, allowing them to exchange data seamlessly. With APIs at your disposal, your bot can:

• Fetch real-time information from the internet (e.g., current weather, trending news).

• Perform advanced functions like currency conversion or language translation.

• Send or retrieve data to and from external databases effortlessly.

---

▎How It Works in Bots.Business:

1️⃣ Utilize HTTP.get() or HTTP.post() to initiate API requests. 
2️⃣ Implement callback commands to handle and process the API responses. 
3️⃣ Parse and present the data using JavaScript for a dynamic user experience.

---

▎Example 1: Fetching a Joke Using HTTP.get()

Let’s lighten the mood by fetching a joke from a free joke API.

Command 1: /getjoke

HTTP.get({
   url: "https://official-joke-api.appspot.com/random_joke",
   success: "/processjoke"
});

Command 2: /processjoke

let response = JSON.parse(content); // Parse the API response
let joke = response.setup + "\n" + response.punchline;  
Bot.sendMessage("😂 Here’s a joke for you:\n" + joke);

---

▎Example 2: Fetching Current Weather

Now, let’s check the weather for a specific city using OpenWeatherMap’s API.

Command 1: /getweather

Bot.sendMessage("Please enter the name of your city:");
Bot.runCommand("/fetchweather");

Command 2: /fetchweather

let city = message;  
let apiKey = "your_openweathermap_api_key";  
HTTP.get({
   url: "https://api.openweathermap.org/data/2.5/weather?q=" + city + "&appid=" + apiKey + "&units=metric",
   success: "/processweather"
});

Command 3: /processweather

let response = JSON.parse(content);  
let temp = response.main.temp;  
let description = response.weather[0].description;  
Bot.sendMessage("🌤️ The current temperature in " + response.name + " is " + temp + "°C with " + description + ".");

---

▎Example 3: Sending Data with HTTP.post()

Let’s see how to send user data to a third-party system using HTTP.post().

Command: /senddata

HTTP.post({
   url: "https://example.com/api/save",
   body: { user_id: user.telegramid, name: user.first_name },
   success: "/dataresponse"
});

Callback Command: /dataresponse

Bot.sendMessage("✅ Your data has been sent successfully!");

---

▎Error Handling

Always implement error handling when working with APIs to ensure a smooth user experience:

HTTP.get({
   url: "https://api.example.com/data",
   success: "/onsuccess",
   error: "/onerror"
});

Command for Error Handling: /onerror

Bot.sendMessage("❌ Failed to fetch data. Please try again later.");

---

▎Assignment:

1️⃣ Create a command that fetches and displays random jokes using an API. 
2️⃣ Build a weather bot that retrieves and presents current weather information for any given city. 
3️⃣ Utilize HTTP.post() to send user data (e.g., name, ID) to an external API and confirm successful transmission.

---

Join us tomorrow for Day 10, where we’ll explore webhooks and learn how to receive real-time updates from external services. Stay engaged and keep pushing the boundaries of what your bot can do! 🚀

🚀 Test Your Knowledge: Days 1-10 Challenge! 🎯

Hey learners! 👋 You’ve successfully completed 10 days of the 30-Day Bots.Business JavaScript (BJS) learning journey. Now, it’s time to put your knowledge to the test and see how much you’ve learned so far! 💡

---

Challenge Questions

1️⃣ Day 1: 
What does the following command do? 
Bot.sendMessage("Hello, Bots.Business!"); 
A) Sends a message to the user. 
B) Creates a new bot. 
C) Saves data for later use.

---

2️⃣ Day 2: 
How do you save and retrieve a user’s name? 

Save: 
User.setProperty("name", "John", "string"); 

Retrieve: 
Fill in the blank: 
let name = ____;

---

3️⃣ Day 4: 
What does this condition do? 

if (message == "yes") {
   Bot.sendMessage("You chose YES!");
} else {
   Bot.sendMessage("You chose NO.");
}

 
A) It asks the user a question. 
B) It checks the user’s input and responds based on their answer. 
C) It saves the user’s input for later.

---

4️⃣ Day 5: 
How do you add 10 coins to a user’s account using ResourcesLib? 
Write the correct code: 

let coins = Libs.ResourcesLib.userRes("coins");
__;
Bot.sendMessage("You now have " + coins.value() + " coins!");

---

5️⃣ Day 7: 
How do you handle user inputs in multiple steps? 
A) Use Bot.sendMessage() and Bot.runCommand() to link commands. 
B) Use HTTP.get() for user responses. 
C) Use Libs.CooldownLib to handle user input.

---

6️⃣ Day 9: 
Which method would you use to fetch data from an API? 
A) HTTP.get() 
B) Bot.sendMessage() 
C) User.setProperty()

---

7️⃣ Day 10: 
What is a webhook used for in Bots.Business? 
A) To track user points. 
B) To receive real-time updates from external services. 
C) To manage access to commands.

---

💬 Post your answers below or send them directly! Let’s see how well you’ve mastered the first 10 days! 🎉

Stay tuned for more exciting lessons, and keep pushing your bots to the next level! 🚀

Day 10: Webhooks – Unlock Real-Time Communication for Your Bot! 🌐

Welcome to Day 10 of our journey! Today, we’re diving into the powerful world of webhooks—an advanced technique that empowers your bot to receive real-time updates from external services. With webhooks, your bot can respond instantly to events such as payments, form submissions, or any external triggers, enhancing its interactivity and responsiveness.

---

▎What Is a Webhook?

Think of a webhook as a notification system that operates in real-time. When an event occurs in an external service, it sends data (known as a payload) to your bot’s designated webhook URL. This allows your bot to process the incoming data and take immediate action, creating a seamless user experience.

---

▎How Webhooks Work in Bots.Business:

1️⃣ Set Up a Webhook Listener: Utilize WebhookLib to enable your bot to listen for incoming webhook events effortlessly. 
2️⃣ Process the Payload: Parse the incoming data and integrate it into your bot’s commands for dynamic responses. 
3️⃣ Trigger Actions: Respond to events in real-time based on the information received from the webhook data.

---

▎Step-by-Step Example: Payment Webhook

Let’s build a bot that listens for payment notifications and automatically confirms payments.

▎Step 1: Set Up a Webhook Listener

Create a command /setupwebhook to enable the webhook:

Libs.Webhooks.setupWebhook({
   url: "your-bot-webhook-url",
   command: "/processpayment" // Command to handle the webhook data
});
Bot.sendMessage("✅ Webhook is successfully set up and ready to receive payment updates!");

---

▎Step 2: Process the Webhook Payload

Now, create a command /processpayment to manage incoming payment data:

let payment = JSON.parse(content); // Parse the webhook payload  
let userId = payment.user_id;  
let amount = payment.amount;  

Bot.sendMessageToChatWithId(userId, "🎉 Payment of $" + amount + " has been received! Thank you for your support!");

---

▎Example 2: Form Submission Webhook

Next, let’s create a bot that listens for data from Google Form submissions.

▎Step 1: Set Up Webhook Listener

Create a command /setupformwebhook:

Libs.Webhooks.setupWebhook({
   url: "your-bot-webhook-url",
   command: "/processform"
});
Bot.sendMessage("✅ Webhook for form submissions is now set up!");

---

▎Step 2: Process the Submitted Data

Create a command /processform to handle the incoming form data:

let formData = JSON.parse(content);  
let userName = formData.name;  
let userResponse = formData.response;  

Bot.sendMessage("📋 New form submission received:\nName: " + userName + "\nResponse: " + userResponse);

---

▎Error Handling in Webhooks

In case something goes wrong during webhook processing, implement error handling:

Error Command: /webhookerror

Bot.sendMessage("❌ An error occurred while processing the webhook. Please try again later.");

---

▎Tips for Effective Webhooks:

1️⃣ Ensure your bot’s webhook URL is publicly accessible (typically provided by Bots.Business). 
2️⃣ Test the webhook functionality using tools like Postman or services like Webhook.site to simulate events. 
3️⃣ Always implement graceful error handling to prevent disruptions in service and enhance user satisfaction.

---

▎Assignment:

1️⃣ Create a webhook that listens for payment updates and promptly notifies users upon receiving their payments. 
2️⃣ Set up a webhook to process Google Form submissions and dynamically display the collected data. 
3️⃣ Enhance your webhook processing commands with robust error handling to manage potential failures effectively.

---

Join us tomorrow for Day 11, where we’ll explore advanced logic and automation techniques to elevate your bot-building skills even further. Keep experimenting with webhooks, and let your creativity shine! 🚀

Day 11: Advanced Logic and Automation – Crafting Smarter, More Powerful Bots! 🤖

Welcome to Day 11! Today, we’re diving deep into the realm of advanced logic and automation techniques that will transform your bots into intelligent, efficient companions. By harnessing the power of conditional statements, loops, and event-driven actions, you can create bots capable of solving complex problems, automating tedious tasks, and dynamically responding to user interactions. Let’s get started on this exciting journey!

---

▎Key Concepts for Today

1️⃣ Complex Conditions (Nested Logic): Master the art of handling multiple conditions to deliver tailored responses that meet user needs. 
2️⃣ Loops: Streamline repetitive tasks and manage data collections effortlessly. 
3️⃣ Event-Driven Automation: Trigger commands or actions based on user events or changes in bot state, creating a more interactive experience. 

---

▎1. Nested Conditions for Complex Logic

Example: Multi-Level Access Control

Let’s build a bot that checks the user’s role and responds accordingly, ensuring a personalized experience.

let role = User.getProperty("role");

if (role == "admin") {
   Bot.sendMessage("👮 Welcome, Admin! You have full access to all features.");
} else if (role == "moderator") {
   Bot.sendMessage("🛡️ Welcome, Moderator! You have limited access to manage content.");
} else {
   Bot.sendMessage("👤 Welcome, User! Enjoy your basic access and explore our features.");
}

---

▎2. Using Loops for Repetitive Tasks

Example: List User Data

Loops empower you to perform actions repeatedly without the hassle of coding each step individually.

Let’s create a command that lists all items in a user’s inventory:

let items = User.getProperty("inventory") || [];
let message = "🎒 Your Inventory:\n";

for (let i = 0; i < items.length; i++) {
   message += (i + 1) + ". " + items[i] + "\n";
}

Bot.sendMessage(message);

---

▎3. Automate Repeating Actions with Intervals

You can leverage Libs.ResourcesLib or commands to automate recurring actions, such as awarding coins every hour.

Example: Hourly Reward

Automatically reward users with coins every hour:

let coins = Libs.ResourcesLib.userRes("coins");
coins.add(10); // Add 10 coins
Bot.sendMessage("💰 You’ve received 10 coins! Your total balance is now: " + coins.value());

Utilize Libs.CooldownLib to ensure this command runs only once per hour when triggered by users.

---

▎4. Event-Driven Actions

Trigger commands based on user activities or changes in stored state for a more engaging experience.

Example: Award Milestone Rewards

Reward users when they reach a score of 100 points:

let score = User.getProperty("score") || 0;

if (score >= 100) {
   Bot.sendMessage("🎉 Congratulations! You’ve reached an impressive milestone of 100 points!");
   User.setProperty("score", 0, "integer"); // Reset score for new challenges
} else {
   Bot.sendMessage("Your current score: " + score + ". Keep going to reach that milestone!");
}

---

▎Assignment for Day 11

1️⃣ Create an Access Control System: 
   Implement nested conditions to establish multi-level roles (e.g., Admin, Moderator, User). Control access to specific commands based on the user’s role.

2️⃣ Build an Inventory Manager: 
   Utilize loops to display a comprehensive list of items in a user’s inventory. Add functionality to allow users to add or remove items seamlessly.

3️⃣ Automate Milestone Rewards: 
   Set up triggers to award users when they achieve a specific score, followed by resetting their score for future challenges.

---

Tomorrow, on Day 12, we’ll explore how to integrate multi-command workflows for more complex bot interactions. Keep pushing your bots to new heights and unleash their full potential! 🚀

Day 12: Multi-Command Workflows – Mastering Complex Interactions! 🔄

Welcome to Day 12 of our exciting journey! Today, we’re diving into the world of multi-command workflows, a powerful feature that enables your bot to handle intricate tasks in a step-by-step manner. This approach is ideal for creating forms, managing multi-step processes, or engaging in scenarios that require multiple user inputs. Get ready to enhance your bot's interactivity!

---

▎What Are Multi-Command Workflows?

Multi-command workflows allow you to break down complex tasks into manageable steps. Each step corresponds to a separate command, making it easier to guide users through the process. Here’s how it typically unfolds:

1. Initial Interaction: The bot poses a question in Command 1.

2. User Response: The user's reply triggers Command 2.

3. Processing Input: Command 2 processes the input and seamlessly transitions to Command 3.

This structured approach ensures that your bot can efficiently manage lengthy interactions while providing a smooth user experience.

---

▎How to Build Multi-Command Workflows

1️⃣ Engage Users: Use Bot.sendMessage() to pose questions and gather input.
2️⃣ Link Commands: Utilize Bot.runCommand() to connect each step of the workflow.
3️⃣ Store Responses: Save user inputs with User.setProperty() for future reference in subsequent steps.

---

▎Example 1: User Registration

Step 1: Start Registration

Command: /register

Bot.sendMessage("Welcome! What’s your name?");
Bot.runCommand("/saveName");

Step 2: Save the Name

Command: /saveName

User.setProperty("name", message, "string");
Bot.sendMessage("Hi, " + message + "! How old are you?");
Bot.runCommand("/saveAge");

Step 3: Save the Age

Command: /saveAge

User.setProperty("age", message, "integer");
Bot.sendMessage("Registration complete! ✅\nName: " + User.getProperty("name") + "\nAge: " + User.getProperty("age"));

---

▎Example 2: Quiz Workflow

Step 1: Start the Quiz

Command: /startquiz

Bot.sendMessage("Question 1: What is the capital of France?\n\nA) Paris\nB) Berlin\nC) Madrid");
Bot.runCommand("/checkAnswer1");

Step 2: Check Answer 1

Command: /checkAnswer1

if (message.toLowerCase() == "a" || message.toLowerCase() == "paris") {
   User.setProperty("score", 1, "integer");
   Bot.sendMessage("✅ Correct! Now for Question 2...");
} else {
   User.setProperty("score", 0, "integer");
   Bot.sendMessage("❌ Wrong! The correct answer is A) Paris. Next question...");
}
Bot.runCommand("/question2");

Step 3: Ask Question 2

Command: /question2

Bot.sendMessage("Question 2: What is 5 + 3?\n\nA) 6\nB) 8\nC) 10");
Bot.runCommand("/checkAnswer2");

Step 4: Check Answer 2 and Display Results

Command: /checkAnswer2

let score = User.getProperty("score");
if (message.toLowerCase() == "b" || message.toLowerCase() == "8") {
   score += 1;
}
Bot.sendMessage("🎉 Quiz Complete! Your score: " + score + "/2");

---

▎Example 3: Multi-Step Order Form

Step 1: Ask for Product

Command: /order

Bot.sendMessage("What product would you like to order?");
Bot.runCommand("/saveProduct");

Step 2: Ask for Quantity

Command: /saveProduct

User.setProperty("product", message, "string");
Bot.sendMessage("How many " + message + "s would you like?");
Bot.runCommand("/confirmOrder");

Step 3: Confirm the Order

Command: /confirmOrder

User.setProperty("quantity", message, "integer");
let product = User.getProperty("product");
let quantity = User.getProperty("quantity");

Bot.sendMessage("✅ Order placed!\nProduct: " + product + "\nQuantity: " + quantity);

---

▎Assignment for Day 12

1️⃣ Create a Registration Workflow: 
   Collect the user’s name, email, and age using multiple commands. Display the saved data in the final step.

2️⃣ Build a Quiz Bot:

Develop a quiz with 3-5 questions, keeping track of the user’s score. Present the final score at the end.

3️⃣ Create an Order Form: 
   Design an order form that asks the user for a product and quantity, then confirm their order in the final step.

---

Tomorrow, on Day 13, we’ll delve into persistent data storage—learning how to manage user data effectively across sessions for advanced bot functionality. Keep up the fantastic work and continue building amazing bots! 🚀

I think that you're not really interested in this 30 Days Bjs Learning Series... 💔

Day 13: Persistent Data Storage – Mastering User Data Management Across Sessions 📂

Welcome to Day 13 of our journey! Today, we’re diving into the essential concept of persistent data storage—a powerful feature that allows your bot to seamlessly store and retrieve user data across multiple sessions. This capability enables your bot to "remember" user preferences, interactions, and states, even after extended periods of inactivity. With persistent data storage, you can create truly personalized and consistent experiences for your users.

---

▎What Is Persistent Data Storage?

Persistent data storage empowers your bot to:

1️⃣ Save User-Specific Data: Store essential details like names, scores, or preferences using User.setProperty(). 
2️⃣ Access and Utilize Saved Data: Retrieve and leverage stored information effortlessly with User.getProperty(). 
3️⃣ Reset or Delete Stored Data: Easily clear data when necessary using User.setProperty(key, null). 

This functionality ensures that your bot can maintain a continuous dialogue with users, enhancing engagement and satisfaction.

---

▎Benefits of Persistent Storage

• Personalization: Tailor responses based on stored user details to create a more engaging experience.

• Long-Term Tracking: Monitor user progress, preferences, or usage statistics over time for better insights.

• Multi-Session Support: Ensure user data remains accessible even after bot restarts or updates, providing a seamless experience.

---

▎How to Use Persistent Storage

1️⃣ Save Data: Use User.setProperty(key, value, type) to store user preferences.

   Example: Save the user's favorite color.
  

   User.setProperty("color", "blue", "string");
   

2️⃣ Retrieve Data: Use User.getProperty(key) to access saved information.

   Example: Retrieve and display the saved color.
  

   let color = User.getProperty("color");
   Bot.sendMessage("Your favorite color is: " + color);
   

3️⃣ Delete Data: Use User.setProperty(key, null) to clear saved information.

   Example: Clear the saved color.
  

   User.setProperty("color", null);
   Bot.sendMessage("Your favorite color has been cleared.");
   

---

▎Examples of Persistent Data Storage

1. User Profiles

   Create a system to store and display user-specific details such as name, email, and age.

   Command 1: /setprofile
  

   User.setProperty("name", "John", "string");
   User.setProperty("email", "john@example.com", "string");
   User.setProperty("age", 25, "integer");
   Bot.sendMessage("✅ Profile saved!");
   

   Command 2: /viewprofile
  

   let name = User.getProperty("name");
   let email = User.getProperty("email");
   let age = User.getProperty("age");

   if (name && email && age) {
       Bot.sendMessage("📋 Your Profile:\nName: " + name + "\nEmail: " + email + "\nAge: " + age);
   } else {
       Bot.sendMessage("⚠️ No profile data found. Use /setprofile to create your profile.");
   }
   

---

2. User-Specific Progress Tracking

   Track user progress in completing tasks or levels.

   Command 1: /starttask
  

   User.setProperty("progress", 1, "integer");
   Bot.sendMessage("📈 Task 1 started! Progress saved.");
   

   Command 2: /nexttask
  

   let progress = User.getProperty("progress") || 1; // Default to 1 if no progress is saved
   progress += 1;
   User.setProperty("progress", progress, "integer");
   Bot.sendMessage("✅ Task " + progress + " started!");
   

   Command 3: /checkprogress
  

   let progress = User.getProperty("progress") || 1;
   Bot.sendMessage("Your current progress: Task " + progress);
   

---

3. Resetting All User Data

   Occasionally, you may want to reset a user’s data entirely.

   Command: /resetdata
  

   User.setProperty("name", null);
   User.setProperty("email", null);
   User.setProperty("age", null);

   User.setProperty("progress", null);
   Bot.sendMessage("⚠️ All your data has been reset.");
   

---

▎Advanced Tip: Use Global Properties for Shared Data

For scenarios where you need to store data accessible across all users (e.g., global leaderboards), utilize Bot.setProperty() and Bot.getProperty().

Set a Global Property:

Bot.setProperty("global_message", "Hello, world!", "string");

Get the Global Property:

let message = Bot.getProperty("global_message");
Bot.sendMessage(message);

---

▎Assignment for Day 13

1️⃣ Build a User Profile System: Create commands to save, retrieve, and reset user details (name, email, and age).

2️⃣ Track User Progress: Implement commands to start, update, and check task progress for each user.

3️⃣ Global Data Management: Use global properties to create a shared bot-wide announcement that all users can view.

---

Join us tomorrow for Day 14, where we’ll explore the exciting realm of Bot Monetization! Learn how to integrate payment systems for premium features or services. Keep practicing and enhancing your skills! 🚀

Day 14: Bot Monetization – Integrate Payment Systems into Your Bot 💳

Welcome to Day 14! Today, we dive into the exciting world of bot monetization by integrating payment systems into your Bots.Business bot. This powerful feature empowers you to charge users for premium services, subscriptions, or one-time purchases. Let’s embark on this journey together! 🚀

---

▎Understanding Payment Systems

With Bots.Business, you can easily integrate payment systems that enable you to:
1️⃣ Accept payments seamlessly from users. 
2️⃣ Automatically verify and confirm transactions. 
3️⃣ Grant access to premium content, virtual goods, or exclusive features.

---

▎Available Payment Libraries

Here are some popular payment libraries you can utilize within Bots.Business:

1. Coinbase: Perfect for cryptocurrency transactions. 

2. QiwiPayments: Ideal for Qiwi Wallet payments. 

3. Oxapay: Supports multiple payment gateways for flexibility. 

4. CoinPayments: Focused on crypto-based payments.

---

▎Setting Up Payments

▎Example: Simple Qiwi Payment Integration

1️⃣ Create a Payment Link 
Generate a Qiwi payment link using Libs.QiwiPayments.createPayment():

Command: /pay

let amount = 10; // Amount in the currency
let currency = "RUB"; // Example: RUB for Russian Ruble
let comment = "Payment for premium features";

Libs.QiwiPayments.createPayment({
   amount: amount,
   currency: currency,
   comment: comment,
   success: "/onPaymentSuccess",
   error: "/onPaymentError"
});

Bot.sendMessage("💳 Please complete the payment of " + amount + " " + currency + " to unlock premium features.");

2️⃣ Handle Payment Success 
On successful payment, execute a callback command:

Command: /onPaymentSuccess

Bot.sendMessage("✅ Payment successful! Premium features unlocked.");
User.setProperty("premium", true, "boolean"); // Grant premium access

3️⃣ Handle Payment Errors 
If an error occurs, inform the user:

Command: /onPaymentError

Bot.sendMessage("❌ Payment failed. Please try again.");

---

▎Example: Sell Virtual Goods Using Coinbase

1️⃣ Generate a Payment Request 
Request cryptocurrency payments with Libs.Coinbase.createInvoice():

Command: /buycoins

Libs.Coinbase.createInvoice({
   amount: 5, // Amount in USD
   currency: "USD",
   description: "Buy 100 virtual coins",
   success: "/onInvoiceSuccess",
   error: "/onInvoiceError"
});

Bot.sendMessage("💰 Please pay $5 in cryptocurrency to receive 100 virtual coins.");

2️⃣ Handle Successful Payments 
Add coins to the user’s account upon successful payment:

Command: /onInvoiceSuccess

let coins = Libs.ResourcesLib.userRes("coins");
coins.add(100); // Add 100 coins
Bot.sendMessage("✅ Payment successful! 100 coins have been added to your account.");

3️⃣ Handle Errors 
Notify the user of any issues encountered:

Command: /onInvoiceError

Bot.sendMessage("❌ Payment error. Please try again.");

---

▎Example: Premium Access

Utilize properties to manage access to premium features.

1️⃣ Check Premium Status 
Before granting access, verify if the user has paid:

Command: /premiumfeature

let isPremium = User.getProperty("premium");

if (isPremium) {
   Bot.sendMessage("✅ Welcome to the premium section!");
} else {
   Bot.sendMessage("⚠️ This feature is for premium users only. Use /pay to upgrade.");
}

---

▎Tips for Effective Monetization

1️⃣ Provide clear and concise instructions for users on completing payments. 
2️⃣ Offer enticing incentives such as coins, premium features, or exclusive content. 
3️⃣ Thoroughly test your payment setup to ensure everything runs smoothly before going live.

---

▎Assignment for Day 14

1️⃣ Set up a payment system (e.g., Qiwi or Coinbase) to charge users for a premium feature or virtual goods. 
2️⃣ Create a premium access system that verifies payment status before granting access to specific commands.

3️⃣ Implement error-handling commands to keep users informed of failed payments.

---

Join us tomorrow for Day 15, where we will explore analytics and user tracking to gain valuable insights into your bot’s performance and user behavior. Keep building and innovating! 🚀

▎Day 15: Analytics and User Tracking – Unlock Your Bot’s Performance Insights 📊

Welcome to Day 15! Today, we’re diving deep into the world of analytics and user tracking to help you understand your bot’s performance and user behavior. This knowledge is crucial for optimizing your bot, enhancing user engagement, and gaining valuable insights into how your bot is utilized. Let’s embark on this data-driven journey together! 🚀

---

▎Why Analytics Are Essential

Analytics empower you to:
1️⃣ Monitor User Interaction: Gain insights into how many users are engaging with your bot.
2️⃣ Measure Engagement Levels: Discover which commands are most frequently used to enhance user experience.
3️⃣ Identify User Behavior Patterns: Recognize active users and pinpoint where others may be dropping off.
4️⃣ Tailor Your Bot Experience: Utilize data to understand user preferences and improve overall functionality.

---

▎How to Track Analytics in Bots.Business

You can effectively track analytics by utilizing the following methods:

1. Bot-wide Properties: Store global statistics for overarching insights.

2. User Properties: Track individual user activity to personalize experiences.

3. Command Usage Frequency: Monitor how often specific commands are utilized.

---

▎Example 1: Track Total Users

Keep a running tally of the total number of users interacting with your bot.

Command: /start

let totalUsers = Bot.getProperty("totalUsers") || 0;
totalUsers += 1;
Bot.setProperty("totalUsers", totalUsers, "integer");
Bot.sendMessage("Welcome! You’re user number " + totalUsers);

To check the total users, create a command:

Command: /checkusers

let totalUsers = Bot.getProperty("totalUsers") || 0;
Bot.sendMessage("📊 Total users: " + totalUsers);

---

▎Example 2: Track Individual User Activity

Monitor the number of commands a user has triggered to assess engagement.

Command: /trackactivity

let commandsUsed = User.getProperty("commandsUsed") || 0;
commandsUsed += 1;
User.setProperty("commandsUsed", commandsUsed, "integer");
Bot.sendMessage("You’ve used " + commandsUsed + " commands so far!");

---

▎Example 3: Track Command Usage

Count how frequently specific commands are executed.

Command: /trackcommand

let cmdUsage = Bot.getProperty("commandUsage") || 0;
cmdUsage += 1;
Bot.setProperty("commandUsage", cmdUsage, "integer");
Bot.sendMessage("This command has been used " + cmdUsage + " times!");

---

▎Example 4: Identify Active Users

Log the last time a user interacted with the bot to gauge activity levels.

Command: /anycommand

let lastActive = new Date();
User.setProperty("lastActive", lastActive, "string");
Bot.sendMessage("Last active time updated: " + lastActive);

To view all active users, export user data from Bots.Business' analytics dashboard.

---

▎Example 5: Track Specific Events

Capture custom events such as purchases or feature usage for targeted insights.

Command: /purchase

let purchases = Bot.getProperty("totalPurchases") || 0;
purchases += 1;
Bot.setProperty("totalPurchases", purchases, "integer");
Bot.sendMessage("🎉 Thank you for your purchase! Total purchases: " + purchases);

---

▎Tips for Effective Analytics

1️⃣ Visualize Data: Export analytics to tools like Google Sheets for deeper insights and trends.
2️⃣ Focus on Key Metrics: Prioritize tracking essential metrics such as user retention, command usage, and purchase frequency.
3️⃣ Set Clear Goals: Establish specific objectives for your bot (e.g., aim to increase active users by 10% within a month).

---

▎Assignment for Day 15

1️⃣ Track Total Users: Implement a system to count and display the total number of users engaging with your bot.
2️⃣ Monitor Command Usage: Set up tracking for how many times each command is utilized.

3️⃣ Record User Activity: Save the number of commands each user triggers along with their last active timestamp.

---

Join us tomorrow for Day 16, where we’ll explore how to create custom libraries for reusable bot logic and advanced features. Stay committed and keep tracking your progress! 🚀

Day 16: Creating Custom Libraries – Reusable Logic for Your Bots 📚

Welcome to Day 16! Today, we’re diving into the world of custom libraries in Bots.Business. These powerful tools enable you to write reusable code that can be effortlessly shared across multiple commands, enhancing your bot's efficiency and organization. Let’s embark on this exciting journey! 🚀

---

▎What Are Custom Libraries?

A custom library is a collection of reusable functions or code snippets that can be utilized across various commands. By consolidating your code into a library, you eliminate redundancy and streamline your coding process, allowing you to call upon the same logic whenever necessary.

---

▎Why Use Custom Libraries?

1️⃣ Code Reusability: Say goodbye to repetitive code across multiple commands. Write it once and reuse it wherever needed.

2️⃣ Simplified Maintenance: Make updates in one central location instead of hunting through multiple commands for changes.

3️⃣ Better Organization: Maintain a clean and manageable codebase, making it easier to navigate and understand your bot’s logic.

---

▎How to Create a Custom Library

1️⃣ Navigate to the Libraries section of your Bots.Business dashboard.

2️⃣ Create a new library and assign it a unique name (e.g., MyLibrary).

3️⃣ Write your reusable code within the library.

---

▎Example 1: Greeting Library

Create a library to generate personalized greetings.

Step 1: Create the Library

Library Name: GreetingLib

function getGreeting(name) {
   return "Hello, " + name + "! Welcome to the bot!";
}

publish({
   getGreeting: getGreeting
});

Step 2: Use the Library in a Command

Command: /greet

let name = User.getProperty("name") || "User";
let greeting = Libs.GreetingLib.getGreeting(name);
Bot.sendMessage(greeting);

---

▎Example 2: Math Library

Create a library to perform basic math operations.

Step 1: Create the Library

Library Name: MathLib

function add(a, b) {
   return a + b;
}

function multiply(a, b) {
   return a * b;
}

publish({
   add: add,
   multiply: multiply
});

Step 2: Use the Library in a Command

Command: /calculate

let result = Libs.MathLib.add(5, 10);
Bot.sendMessage("The sum of 5 and 10 is: " + result);

---

▎Example 3: Coin Management Library

Create a library to manage user coins.

Step 1: Create the Library

Library Name: CoinLib

function addCoins(amount) {
   let coins = Libs.ResourcesLib.userRes("coins");
   coins.add(amount);
   return coins.value();
}

function deductCoins(amount) {
   let coins = Libs.ResourcesLib.userRes("coins");
   if (coins.have(amount)) {
      coins.remove(amount);
      return true;
   } else {
      return false;
   }
}

publish({
   addCoins: addCoins,
   deductCoins: deductCoins
});

Step 2: Use the Library in a Command

Command: /coins

let action = message.toLowerCase();

if (action == "add") {
   let total = Libs.CoinLib.addCoins(10);
   Bot.sendMessage("💰 You now have " + total + " coins!");
} else if (action == "deduct") {
   let success = Libs.CoinLib.deductCoins(5);
   if (success) {
      Bot.sendMessage("5 coins deducted successfully!");
   } else {
      Bot.sendMessage("❌ You don’t have enough coins!");
   }
}

---

▎Tips for Creating Custom Libraries

1️⃣ Keep It Focused: Each library should cater to a specific functionality (e.g., math, coins, greetings) for clarity and efficiency.

2️⃣ Test Your Library: Thoroughly test all library functions before deploying them across multiple commands to ensure reliability.

3️⃣ Use Descriptive Names: Opt for clear and descriptive names for your functions and libraries, making them intuitive and easy to use.

---

▎Assignment for Day 16

1️⃣ Create a Greeting Library: Develop a library that generates personalized greetings based on the time of day (e.g., "Good morning, [name]!").

2️⃣ Build a Math Library: Implement reusable functions for addition, subtraction, multiplication, and division.

3️⃣ Develop a Coin Management Library: Craft functions to add, deduct, and check user coins effectively.

---

Get ready for tomorrow’s adventure! On Day 17, we’ll explore advanced bot security techniques to safeguard your bot and its users. Keep building and enhancing your code! 🚀

▎Day 17: Advanced Bot Security – Protect Your Bot and Users 🛡️

Welcome to Day 17! Today, we will focus on fortifying your bot against misuse while safeguarding user data. Implementing robust security measures is essential for ensuring that your bot operates smoothly and that user interactions remain safe and secure.

---

▎1. Add Cooldowns to Commands

Prevent users from spamming commands by establishing time-based restrictions.

Example: Daily Reward Cooldown

let cooldown = Libs.CooldownLib;

if (!cooldown.checkCooldown("daily_reward")) {
   Bot.sendMessage("❌ You’ve already claimed your reward today. Try again tomorrow!");
   return;
}

cooldown.setCooldown("daily_reward", 24 * 60 * 60); // 24 hours
Bot.sendMessage("🎉 You’ve claimed your daily reward of 50 coins!");

---

▎2. Restrict Access by Role

Ensure that sensitive commands are accessible only to admin users.

Example: Admin Command

let isAdmin = User.getProperty("isAdmin");

if (!isAdmin) {
   Bot.sendMessage("⛔ Access denied! This command is for admins only.");
   return;
}

Bot.sendMessage("✅ Welcome, Admin!");

To assign the admin role:

User.setProperty("isAdmin", true, "boolean");

---

▎3. Validate User Inputs

Mitigate the risk of invalid or malicious inputs by implementing validation checks.

Example: Password Validation

let correctPassword = "secure123";

if (message != correctPassword) {
   Bot.sendMessage("❌ Incorrect password. Try again.");
   return;
}

Bot.sendMessage("✅ Access granted!");

---

▎4. Limit Access to Approved Users

Restrict access to your bot to a select group of users.

Example: Restricted Access

let allowedUsers = [123456789, 987654321]; // Telegram IDs of allowed users

if (!allowedUsers.includes(user.telegramid)) {
   Bot.sendMessage("⛔ You’re not authorized to use this bot.");
   return;
}

Bot.sendMessage("✅ Welcome to the restricted area!");

---

▎Assignment for Day 17

1️⃣ Implement cooldowns for commands like /dailyreward. 
2️⃣ Restrict sensitive commands to admin users only. 
3️⃣ Validate user inputs to prevent errors or abuse. 
4️⃣ Limit bot access to specific Telegram IDs.