Skip to content

Latest commit

 

History

History
119 lines (91 loc) · 4.75 KB

README.md

File metadata and controls

119 lines (91 loc) · 4.75 KB
Raw

Shanghai

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
  1. Install dependencies:
$ npm install

  1. 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.

  2. 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

📃 License

This project is licensed under the MIT License.