Skip to content

Your personal assistant, on WhatsApp! The most user friendly userbot for the platform!

License

Notifications You must be signed in to change notification settings

magneum/BotsApp

 
 

Repository files navigation

💠BotsApp💠

Your Personal Assisstant, on WhatsApp!


GitHub top language GitHub release GitHub contributors GitHub closed pull requests GitHub pull requests GitHub Repo stars GitHub repo size

Docker Pulls Docker Image Size

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

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.

How to deploy

Multi Device

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 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!

Deploy To Heroku

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 -

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 -

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:

Join WhatsApp Group

Join Telegram Group

Join Telegram Channel

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

Copyright & 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.

About

Your personal assistant, on WhatsApp! The most user friendly userbot for the platform!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 93.4%
  • JavaScript 6.4%
  • Dockerfile 0.2%