🤖 WBT WhatsApp Bot

Indie multi-purpose WhatsApp Bot using WWeb.js

^{Example usage of WBT in chat}

---

🚩 Getting Started

❇️ Prerequisites

• NodeJS 20+ or Bun.

  ⚠️ Deno is not supported (due to different environment that this project is built for).

  This project uses WWeb.js, which relies on Puppeteer under the hood. Some media-related features (e.g., videos and GIFs) require you to provide the path to your Google Chrome binary in your shell environment or in .env. See this note for details. All helps done by puppeteer-extra for now.

Other details is coming soon as this project isn't yet ready for future use.

💽 Installation

1. Clone this repository

git clone https://github.com/just-shadyumbrella/wbt.git
cd wbt

2. Install depedencies

npm install
# or
yarn install
# or
pnpm install

# with Bun
bun install

3. Start the backend

# Node.js
pnpm start:node

# Bun
bun start:bun
# or simply
bun run .

By default, the process shuts down automatically after ~5 hours and 50 minutes.

• main → timeout is measured against system uptime. Once uptime ≥ timeout, the process shuts down. This is intended for production-like environments (VMs, containers, or real systems) to ensure full memory cleanup. You will need to configure an external restart scheduler yourself.
• dev → timeout is measured from process startup. This mode is primarily for development.

You can adjust or remove this behavior in index.ts.

👤 Usage

Send /help to the client number for a list of available commands. It works both from the bot itself and by foreign sender.

💼 Development

This project is still in its early stages and will continue to grow with more improvements and planned features. Forks, suggestions, and contributions are always welcome! 🚀

🔧 Debugging

You can pass the debug argument to show up the browser window for debugging browser-related features.

# Node.js
pnpm build
node dist debug

# Bun
bun run . debug

For easier debugging, it is recommend switching to the dev branch, which provides a different setup environment.

🚫 Beware of Bans

Some users have reported WhatsApp bans when using automation tools. See related discussions here:

1. wwebjs/whatsapp-web.js#532 (comment)
2. wwebjs/whatsapp-web.js#3594 (comment)
3. wwebjs/whatsapp-web.js#1872
4. More info in the issue tracker.

---

_{© 2025 just-shadyumbrella. All rights reserved.}