Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/erozx/shanghai
Shanghai is an automated bot for adding contacts to a WhatsApp group.
https://github.com/erozx/shanghai
automated bot contact group management node nodejs whatsapp whatsapp-automation whatsapp-bot whatsapp-web-js
Last synced: about 1 month ago
JSON representation
Shanghai is an automated bot for adding contacts to a WhatsApp group.
- Host: GitHub
- URL: https://github.com/erozx/shanghai
- Owner: erozx
- License: mit
- Created: 2024-07-26T14:16:50.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-07-27T15:49:11.000Z (5 months ago)
- Last Synced: 2024-10-15T05:40:55.321Z (3 months ago)
- Topics: automated, bot, contact, group, management, node, nodejs, whatsapp, whatsapp-automation, whatsapp-bot, whatsapp-web-js
- Language: JavaScript
- Homepage:
- Size: 30.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
Shanghai is a simple but useful bot designed to automate the process of adding contacts to a WhatsApp group. Its name, "Shanghai," reflects its function of 'kidnapping' contacts into the group.
# TODO - v1.1.1
## Major (later)
- [ ] Make the gui version
## Minor
- [ ] Add english version
- [ ] Choice to load welcome message from text file
- [ ] Check each number before adding into group
- [ ] Can add multiple contact at once
- [ ] Can add into multiple group at once
## Patch
- [ ] Fix auth & cache folder
## 🔍 Features
- **Automatic Contact Addition**: Add a list of contacts to a WhatsApp group effortlessly.
- **Customizable Delays**: Set delay intervals between adding each contact to avoid bans.
- **Welcome Messages**: Send welcome messages to the group at specified intervals.
- **Error Handling**: Logs errors and retries on failure, ensuring robust performance.
- **Real-Time Logging**: Provides real-time logs for monitoring the bot's actions.
## 🚀 Getting Started
First of all, nodejs must be installed on the device that will be used.
Download here from the official website
### Prerequisites
```bash
- Node.js (v18 or higher)
- WhatsApp account for authentication that has group admin permissions
- The number to be added to the group must first be saved to contacts in order to be added to the group.
```
### Installation
1. Clone the repository:
```bash
$ git clone https://github.com/sansxpl/shanghai.git
$ cd shanghai
```
2. Install dependencies:
```bash
$ npm install
```
3. Prepare the contact list:
- Create a file named `contact.txt` or edit the existing one in the root directory.
- Add phone numbers in the format `+countrycode number`, one per line.
4. Run the bot:
```bash
$ npm start
```
## 🎈 Usage
1. **Scan QR Code**: On the first run, scan the QR code with your WhatsApp account.
2. **Input Prompts**: Provide the required inputs such as group name, welcome message, delay interval, and message frequency.
3. **Monitoring**: Monitor the real-time logs to track the bot's progress and actions.
### Example
Here’s an example of what the output process looks like:
(the numbers listed here are fake numbers, for example)
```bash
$ npm start
> [email protected] start
> node index.js
[2024-07-27 12:56:31] [%] Sedang memulai bot, harap tunggu...
[2024-07-27 12:56:44] [+] User terverifikasi!
┓ ┓ •
┏┣┓┏┓┏┓┏┓┣┓┏┓┓
┛┛┗┗┻┛┗┗┫┛┗┗┻┗
v1.0.0 ┛
By ./SansXpl
Masukkan nama grup (lengkap): My Group
[2024-07-27 12:56:48] [INFO] Bot telah disetting ke grup My Group
Masukkan pesan selamat datang: Welcome to my group!
Masukkan delay setiap memasukkan kontak (detik): 1
Kirim pesan selamat datang setiap berapa kontak: 1
[2024-07-27 12:57:04] [INFO] Memulai menambahkan kontak
[2024-07-27 12:57:07] [+] Nomor 0123456789 berhasil dimasukkan kedalam grup My Group
[2024-07-27 12:57:07] [INFO] Pesan selamat datang berhasil di kirim ke grup My Group
[2024-07-27 12:57:09] [+] Nomor 1122334455 berhasil dimasukkan kedalam grup My Group
[2024-07-27 12:57:09] [INFO] Pesan selamat datang berhasil di kirim ke grup My Group
[2024-07-27 12:57:10]
[DONE] Semua kontak telah berhasil di tambahkan
```
- [@sansxpl](https://github.com/sansxpl) - Just Coding
## 📃 License
This project is licensed under the MIT License.