DEV Community

HEAVSTAL TECH™
HEAVSTAL TECH™

Posted on

Heavstal Tech Built a Scalable Node.js WhatsApp Bot with AI, Multi-Tenancy, and Plugins (Verselor V1)

#node #opensource #automation #javascript

Here is a complete refactor of
If you’ve ever tried building a WhatsApp bot, you probably know the struggle: most open-source solutions are strictly "one user to one instance." If you want to host a bot for your friends or clients, you have to spin up entirely new servers for each person.

Enter Verselor V1 by HEAVSTAL TECH.

Verselor V1 is a high-performance, Node.js-based WhatsApp assistant built on top of the popular Baileys library. We designed it from the ground up to solve the scaling problem through Multi-Tenancy, while packing it with AI capabilities, automation tools, and an incredibly easy-to-use ESM plugin system.

Verselor V1 Banner

Here is a look at what makes Verselor V1 different, how you can deploy it in seconds, and how you can write your own custom plugins for it.

🌟 What Makes Verselor V1 Stand Out?

Basically, the flow looks like this:
User → WhatsApp → Baileys → Command Handler → Plugin System → Response

But we added three major features that set it apart from standard bots:

1. Multi-Tenancy (.pair command)

Verselor V1 allows a single server host to connect multiple users to the bot, each with their own independent session. All of this is managed under a single Node.js process. You can literally just type .pair 234xxxx to link a new user to your hosted bot without touching your server terminal.

2. Built-in AI Intelligence (.botai)

We integrated an advanced AI directly into the bot. Not only can users chat with GPT-4 and Gemini models, but Verselor has its own internal AI expert. You can literally text the bot: "Verselor, pull up the bot's menu for me," and the AI will execute the .menu command on your behalf.

3. Global Multilingual System (.setlang)

Bots locked to a single language are frustrating. Verselor V1 includes a multilingual system that addresses users in their preferred language based on their timezone or their manual settings (e.g., .setlang french).

(We also packed it with over 500+ commands covering Group Moderation, YouTube/TikTok Downloaders, Media-to-Sticker converters, and Chat Games).

🚀 Quick 30-Second Start (Local/VPS)

Want to get it running right now? You just need Node.js (v20+) and Git installed.

# 1. Clone the repository
git clone https://github.com/HeavstalTech/Verselor-V1.git  

# 2. Navigate to the directory
cd Verselor-V1-main  

# 3. Install dependencies
npm install  

# 4. Start the bot
npm start
Enter fullscreen mode Exit fullscreen mode

Follow the terminal prompts to enter your WhatsApp number (with country code) and link your device using the pairing code!

Cloud Deployment: Prefer the cloud? We have 1-click deploy templates for Render, Replit, and Koyeb available on our GitHub Repo.

👨‍💻 Developer Experience: Adding Custom Plugins

We built Verselor V1 with a modular ES Module (ESM) architecture, making it incredibly simple for developers to write their own commands.

To add a new feature, just create a .js file inside Start/Plugins/custom/ and paste this template:

export default [
    {
        name: 'mycmd',
        aliases: ['cmd1', 'cmd2'],
        category: 'misc',
        description: 'A simple custom command',
        usage: '%prefix%mycmd',
        ownerOnly: false, 
        groupOnly: false, 

        execute: async (HeavstalTech, m, context) => {
            // The context object provides easy access to variables!
            const { Vreply, pushname, prefix } = context;

            // Your custom command logic
            await Vreply(`Hello ${pushname}! You just used the ${prefix}mycmd command.`);
        }
    }
];
Enter fullscreen mode Exit fullscreen mode

Save the file, restart the bot, and your command is instantly loaded into the system and added to the dynamic .menu!

⚠️ A Quick Word of Caution

Using unofficial WhatsApp APIs always carries a small risk. To minimize the chance of your account getting banned:

  • Do not spam groups.
  • Turn off startup messages in the config.
  • Highly Recommended: Use a secondary/burner phone number to host the bot.
  • Use at your own risk! Heavstal Tech is not responsible for banned accounts.

🤝 Let's Build Together!

Verselor V1 is currently in Beta (v1.2.1-beta.1), and we are actively looking for contributors, feedback, and testers!

If you think this project is cool, we would absolutely love it if you could:

  1. ⭐ Star the repo on GitHub: HeavstalTech/Verselor-V1
  2. 🍴 Fork it and build your own awesome plugins.
  3. 💬 Join the community: WhatsApp Support Group | Telegram Group
  4. Recommendation: Check Out The Repo's Readme for more information: Verselor-V1

What kind of custom command would you build for a WhatsApp bot? Let me know in the comments below! 👇

Top comments (0)