Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
gensart-ai authored Feb 17, 2024
1 parent 257c098 commit 052e4d4
Showing 1 changed file with 49 additions and 13 deletions.
62 changes: 49 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@


# WhatsApp Bot by Node.js + whatsapp-web.js
> Since this project still on development 🚧, I do not have any briliant names for it. Maybe soon, stay tuned !
#### Just an automated WhatsApp reply system based on text sent that built under Node.js, with help of a library called [whatsapp-web.js](https://wwebjs.dev/).
Expand All @@ -11,29 +12,64 @@


# Table of contents
- [Requirements](#requirements)
- [Installation](#installation)
- [Configurations](#configurations)
- [Quickstart](#quickstart)
- [Usage](#usage)
- [Recommended configurations](#recommended-configurations)
- [Contributing](#contributing)
- [License](#license)

# Requirements
[(Back to top)](#table-of-contents)
This project requires **Node.js** to run, I use **Node v20.10** on Windows 10 and **Debian 11** too and it works fine. I haven't tested it yet on different version or environment than mine, but you may try it and report it to me, so I can update this details by you :).

Oh also, make sure you have installed **NPM** too. Usually **Node.js** includes **NPM** so you don't need to install it again.

**πŸ”΄ IMPORTANT NOTICE πŸ”΄**
This project greatly having use of [whatsapp-web.js](https://wwebjs.dev/), and maybe **if you are running on a `no-gui` Linux image (Server, or Linux OS that do not installed GUI system)**, you may need to see and follow this page first : [Click Me](https://wwebjs.dev/guide/#installation-on-no-gui-systems)

# Installation
[(Back to top)](#table-of-contents)
> 🚧 Coming soon !
[(Back to top)](#table-of-contents)
First thing you do, clone this repo by using :
```bash
git clone https://github.com/gensart-ai/whatsapp-bot.git
```
Do not know how to clone in GitHub ? maybe you can check this page for a quickstart : [Click Me!](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)

# Usage
[(Back to top)](#table-of-contents)
> 🚧 Coming soon !
After that, go to the repo root directory and do the command below to install the packages needed for the project :
```bash
npm i
```
And it's done.
# Configurations
[(Back to top)](#table-of-contents)
As the current version, I put some global configurations on a Typescript file in : `./src/env.ts`. You can change the bot name, imgBb keys, etc.

# Recommended configurations
[(Back to top)](#table-of-contents)
> 🚧 Coming soon !
For `imgBBKey`, you can retrieve the key from [here](https://api.imgbb.com/), but you may need to sign up first if you didn't have any ImgBB account before.

# Contributing
[(Back to top)](#table-of-contents)
> 🚧 Coming soon !
# Quickstart
[(Back to top)](#table-of-contents)
If you have done the [Installation](#installation) and have checked the [Configurations](#configurations), you can open the terminal at root directory of the project and do the command below to build the `src` to JavaScript to `dist`:
```bash
npm run build
```
After that, you can run the project using this command :
```bash
npm run serve
```
If you succeed, you should see some message like this :
![WhatsApp QR Code shown on terminal](https://i.ibb.co/K5rzdxp/readme-quickstart-1.png)
The terminal will shows a QR Code to be scanned with your WhatsApp app (doing it like scanning for WhatsApp Web). And if project succeed the QR, it will output :
`System is online!`
And congrats, your WhatsApp number (that scan the QR) is successfully integrated with the project !πŸŽ‰
# Usage
[(Back to top)](#table-of-contents)
As of current version, you can send a message : `.help` to an associated WhatsApp number with the project, you can see the detail of features on there ! :)

Your contributions are always welcome! Please have a look at the [contribution guidelines](CONTRIBUTING.md) first. :tada:
# Contributing
[(Back to top)](#table-of-contents)
Your contributions are always welcome! Please have a look at the [contribution guidelines](CONTRIBUTING.md). :tada:

# License
[(Back to top)](#table-of-contents)
Expand Down

0 comments on commit 052e4d4

Please sign in to comment.