---

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

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

$ git clone https://github.com/sansxpl/shanghai.git
$ cd shanghai

2. Install dependencies:

$ 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:

$ 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)

$ npm start

> shanghai@1.0.0 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

✍️ Authors

• @sansxpl - Just Coding

📃 License

This project is licensed under the MIT License.