prince-mendiratta/botsapp

★ 5,530TypeScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Auto-respond messages
      Manage groups
      Personal account bot
    Setup
      QR code scan
      Docker option
      Linux Node.js install
    Tech
      TypeScript
      Baileys library
    Risks
      WhatsApp TOS
      Account suspension risk

mindmap root((repo)) What it does Auto-respond messages Manage groups Personal account bot Setup QR code scan Docker option Linux Node.js install Tech TypeScript Baileys library Risks WhatsApp TOS Account suspension risk

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Auto-reply to WhatsApp messages with custom responses when you are offline or unavailable.

USE CASE 2

Automatically manage a WhatsApp group, such as welcoming new members or enforcing group rules.

USE CASE 3

Run a personal WhatsApp assistant that handles common requests without you responding manually.

Tech stack

TypeScriptNode.jsDockerBaileys

Getting it running

Difficulty · moderate Time to first run · 30min

Requires linking your personal WhatsApp account via QR code, WhatsApp's terms of service prohibit automated tools and account suspension is a real risk.

GNU GPL, use and modify freely, but any distributed version must also be open-source under the same license.

In plain English

BotsApp is a WhatsApp userbot, which means it is a program you run that acts on behalf of your own WhatsApp account automatically. Unlike a traditional bot that has its own separate phone number, this one connects to your personal account. Once set up, it can respond to commands and manage groups on your behalf. The setup process is designed to be accessible even without technical experience. The recommended approach involves visiting the project's official website, linking your WhatsApp account by scanning a QR code on your phone, and filling out a settings form. The whole process is described as taking under three minutes. For people who want more control or prefer to self-host, there are additional installation options using Docker, or by running the code directly on a Linux machine with Node.js. The README does not provide a detailed list of commands the bot supports, but it mentions using the bot as a personal chat assistant and group manager. The documentation for specific features lives on the project's external website. A support community exists through WhatsApp and Telegram groups where users can ask questions. The project is released under the GNU General Public License. The README includes a legal notice stating that BotsApp is not affiliated with or endorsed by WhatsApp in any way, and that using it is at the user's own risk. This is relevant because WhatsApp's terms of service generally prohibit the use of automated tools on personal accounts, so there is a real risk of account suspension. BotsApp is built on top of an open-source library called Baileys, which handles the low-level communication with WhatsApp's servers.

Copy-paste prompts

Prompt 1

Help me set up BotsApp on a Linux server using Docker so it auto-replies to WhatsApp messages I receive while I am away.

Prompt 2

Write a BotsApp command handler that automatically welcomes new members who join my WhatsApp group with a custom greeting.

Prompt 3

Show me how to configure BotsApp to respond to specific keyword triggers in WhatsApp with predefined answers.

Open on GitHub → Explain another repo

← prince-mendiratta on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.