Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prince-mendiratta/botsapp
Your personal assistant, on WhatsApp! The most user friendly userbot for the platform!
https://github.com/prince-mendiratta/botsapp
baileys-bot bot botsapp userbot whatsapp whatsapp-bot
Last synced: 5 days ago
JSON representation
Your personal assistant, on WhatsApp! The most user friendly userbot for the platform!
- Host: GitHub
- URL: https://github.com/prince-mendiratta/botsapp
- Owner: Prince-Mendiratta
- License: gpl-3.0
- Created: 2021-05-12T13:24:26.000Z (over 3 years ago)
- Default Branch: multi-device
- Last Pushed: 2023-08-31T13:48:54.000Z (over 1 year ago)
- Last Synced: 2025-01-09T08:06:46.957Z (12 days ago)
- Topics: baileys-bot, bot, botsapp, userbot, whatsapp, whatsapp-bot
- Language: TypeScript
- Homepage:
- Size: 739 KB
- Stars: 5,504
- Watchers: 33
- Forks: 1,277
- Open Issues: 61
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 💠[BotsApp](https://mybotsapp.com/)ðŸ’
> Your Personal Assisstant, on WhatsApp!
---
 [](https://github.com/bkimminich/juice-shop/releases/latest)
    
 
BotsApp is an optimized and easy-to-use WhatsApp UserBot written in Node.js.
Utilize your personal chat assistant/group manager to make the most out of WhatsApp.
## Documentation
[Documentation Link](https://mybotsapp.com/documentation)
## Tutorial
Here's a tutorial to set up BotsApp on your own account in *less than 3 minutes.* For now, the Multi Device Bot can only be used locally, the tutorial for which is attached below.
[](https://www.youtube.com/watch?v=tGrjEZ3roY0&ab_channel=BotsApp)
[](https://youtu.be/NZy4sZqncjg&ab_channel=BotsApp)
## Deployment
Only local deployment is working for now!
### Easiest Way
You can deploy BotsApp in minimal time without any prior knowledge using this method.
1. Head over to BotsApp's [Official website](https://mybotsapp.com/) and create an account on heroku using your email ID.
2. Once logged in, click on the "Deploy BotsApp" button in the sidebar.
3. Scan the QR code shown using your WhatsApp account (3 dots on top right corner -> Linked devices -> LINK A DEVICE). Click on the 'Continue' button once done.
4. Once the bot is linked to your account, you will come across a form which can be used to manage settings/permissions of BotsApp. If required, change the form fields. Then, click on the submit button.
5. Wait for 1-3 minutes for the bot to start. This is a one time process. Try using the '.alive' command in any of your chats to verify whether your bot has been deployed succesfully.
Voila! You have deployed your bot in 5 easy steps. Once the bot has started successfully, you'll see a integration message on your whatsapp account.
### Manually on Heroku
Deployment to heroku using the button is not working for now!
You can deploy the bot the heroku yourself using the button below!
[](https://dashboard.heroku.com/new?button-url=https%3A%2F%2Fgithub.com%2FPrince-Mendiratta%2FBotsApp%2Ftree%2Fmain&template=https%3A%2F%2Fgithub.com%2FPrince-Mendiratta%2FBotsApp%2Ftree%2Fmainhttps://dashboard.heroku.com/new?button-url=https%3A%2F%2Fgithub.com%2FPrince-Mendiratta%2FBotsApp%2Ftree%2Fmain&template=https%3A%2F%2Fgithub.com%2FPrince-Mendiratta%2FBotsApp%2Ftree%2Fmain)
### Using Docker locally
To follow this method, you will need to have docker installed on your machine and have some experience using docker.
To host the bot on your own device using docker, follow the following steps on your terminal / command prompt -
```bash
wget -O BotsApp.tar.gz https://github.com/Prince-Mendiratta/BotsApp/archive/refs/tags/v2.0.0-beta.tar.gz
tar -xvzf BotsApp.tar.gz
cd BotsApp-2.0.0-beta
docker build -t botsapp .
docker run --rm --name botsapp botsapp
```
This will create a container running BotsApp. You'll have to scan the QR at least once.
### The GNU/Linux Legacy Way
To use this method, you will need ffmpeg, nodejs, npm installed on your device.
To run the bot on your device manually, you can use the following commands -
```bash
git clone https://github.com/Prince-Mendiratta/BotsApp.git
cd BotsApp
yarn
npm start
```
## Scan QR Code again
If you're having issues when running locally it is recommended to scan the code again. To get the QR code again, follow these commands -
```
rm -rf BotsApp.db session.data.json
npm start
```
## Support and Discussion groups
Feel free to post your queries or concerns on any of the discussion forums mentioned below:
[](https://chat.whatsapp.com/GPEHkFlspzOKpSBTsYx7Wt)
[](https://t.me/BotsAppChat)
[](https://t.me/Prince-Mendiratta)
## Contributors
Prince Mendiratta
Project Lead Developer
Prashant Singla
Core Developer
Keshav Pahwa
Core Developer
Johann Jose
Core Developer
Mohit Singh Rana
Core Developer
Neeraj Patel
Moderator
## Inspiration
- Baileys Library
- Yusuf Usta
- [X-tra-Telegram](https://github.com/Prince-Mendiratta/X-tra-Telegram)
## Copyright & License
- Copyright (C) 2021 - 2022 by [Prince-Mendiratta](https://github.com/Prince-Mendiratta)
- Licensed under the terms by [GNU GENERAL PUBLIC LICENSE](https://github.com/Prince-Mendiratta/BotsApp/blob/main/LICENSE)
## Legal
This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by WhatsApp or any of its affiliates or subsidiaries. This is an independent and unofficial software. Use at your own risk.