MSS'enger - A ChatBlast Engine 🚀

MSS'enger is a powerful open-source WhatsApp automation tool designed for bulk messaging, form building, and conversational workflows. It leverages the Evolution API to provide a robust and scalable solution for managing WhatsApp interactions.

✨ Features

• 📊 Dashboard: Real-time statistics on connected instances, messages sent, and form performance.
• ✉️ Bulk Sender: Send personalized messages to individual contacts or groups via CSV upload.
• 📝 Form Builder: Create interactive conversational forms that users can fill out directly within WhatsApp.
• 📅 Scheduling: Schedule messages and campaigns for future delivery (supports IST timezone).
• 🔄 Instance Management: Easily connect and manage multiple WhatsApp instances via QR code.
• 🐳 Dockerized: Simple deployment using Docker Compose.

🛠️ Tech Stack

• Backend: FastAPI (Python)
• Frontend: Streamlit
• Database: PostgreSQL
• Cache: Redis
• WhatsApp Engine: Evolution API
• Tunneling: Ngrok (for public access)

🚀 Getting Started

Prerequisites

• Docker and Docker Compose
• Ngrok (optional, for exposing the frontend)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/ChatBlastEngine.git
   cd ChatBlastEngine

2. Configure Environment: The project comes with a pre-configured docker-compose.yml. You can adjust the environment variables in the services section if needed.

3. Start the services:

   docker-compose up -d

4. Initialize the Database:

   docker-compose exec backend python create_db.py

Accessing the App

• Frontend (Dashboard): http://localhost:8501
• Backend API: http://localhost:8000
• Evolution API: http://localhost:8080

🌐 Public Access (Ngrok)

To make your forms accessible to users on their mobile devices, you need a public URL.

1. Start the Ngrok tunnel:

   ./start_tunnel.sh

2. Copy the https://....ngrok-free.app URL.
3. Paste this URL into the App Configuration section in the ChatBlast Dashboard.

📖 Usage Guide

1. Connect WhatsApp: Go to the "Connection" tab and scan the QR code with your WhatsApp app.
2. Upload Contacts: Use the "Bulk Sender" tab to upload a CSV of contacts.
3. Create Forms: Use the "Form Builder" to design conversational workflows.
4. Send/Schedule: Send messages immediately or schedule them for later.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is open-source and available under the MIT License.