About this project

Mudbot is a self-hosted WhatsApp automation platform that allows users to connect their accounts via QR code to schedule messages or trigger them via a REST API. It is designed with a strong focus on security and account longevity. Key capabilities include: - **Zero-Knowledge Security**: User data, including WhatsApp sessions and schedules, is encrypted using AES-256 with a user-provided auth token. The server owner cannot read user data as there is no shared server secret. - **Ban Mitigation**: To reduce the risk of account bans, the system routes connections through dedicated residential proxies (via DataImpulse) to mimic real home networks and utilizes a per-account sequential message queue to avoid rapid-fire bursts. - **Calendly Integration**: Automatically sends WhatsApp messages to leads who book meetings via Calendly. This integration uses a combination of a local VM for secret management and Firebase (Firestore/Cloud Functions) for lead tracking and configuration. - **Multi-tenant API**: Provides a REST API for sending messages, managing WhatsApp connections, and generating API keys. - **Authentication**: Uses a passwordless magic link system via email to provide users with a unique auth token stored only in the browser's localStorage.