mudbot

Mudbot is an unofficial, self-hosted WhatsApp messaging automation platform designed for efficient message scheduling and real-time delivery. Powered by Mudslide, this tool offers a secure and scalable solution with user-controlled encryption, ideal for developers and businesses looking to streamline their messaging operations without compromising privacy.

Key Features

• User-Controlled Encryption: Every piece of user data is encrypted using a personal authentication token, ensuring that even server administrators cannot access user messages.
• Two-Way API Integration: Easily connect and manage your WhatsApp account using QR code login, automate message delivery with a REST API, and control the timing for sending messages through a cron scheduler.
• Account Ban Mitigation: By routing connections through residential IPs, Mudbot effectively reduces the risk of WhatsApp account bans. Each user is assigned a unique dedicated IP address, mimicking a real user to bypass spam detection mechanisms.

Live Demo

Experience Mudbot in action at watobot.xyz, where users can sign up, schedule messages, and explore the API functionalities.

How It Works

1. Authentication: Users access the platform using a passwordless magic link sent to their email. No emails are stored, enhancing user privacy.
2. Data Storage: All user data is securely stored as AES-256 encrypted files. The app uses unique keys derived from the user's authentication token for encryption, promoting data security.
3. Scheduling Mechanism: The platform employs cron jobs for running scheduled tasks, ensuring that messages are sent at the desired times without exposing any secrets on the server.

Message Queueing for Spam Prevention

Mudbot implements a message queueing system to address spam detection concerns. Outgoing messages are serialized and sent one at a time, helping maintain compliance with WhatsApp’s guidelines and reducing the risk of account suspension.

Instructions for Use

To connect your WhatsApp account:

1. Navigate to http://localhost:3000.
2. Enter your email address to receive a magic link.
3. Click the link to open your dashboard and connect your account by scanning the QR code provided.

Example API Requests

Send a Message:

curl -X POST https://<domain>/api/message \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"to": "919876543210", "message": "Hello!"}'

Create a Scheduled Message:

curl -X POST https://<domain>/api/schedules \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Daily Reminder", "recipients": ["919876543210"], "message": "Good morning!", "timezone": "Asia/Kolkata", "localTime": "09:00", "frequency": "Daily"}'

Disclaimer

This project is intended for educational purposes only. Any use of unofficial WhatsApp automation may violate WhatsApp's Terms of Service, and the author disclaims any liability for account bans that may arise from usage.