kmuwanga83/KaziSMS

Lightning fast SMS API for East Africa - Direct carrier connections # 🚀 SemaSMS - Enterprise SMS Gateway for East Africa **"Speak SMS" - Lightning fast, Two-Way SMS API for East Africa** SemaSMS (Swahili for "Speak SMS") is a production-ready, open-source SMS gateway that allows you to send and receive SMS messages, manage credits, and process payments via Mobile Money (MTN & Airtel). Built specifically for East Africa with direct carrier routing. --- ## 📋 Table of Contents - Features - Supported Countries & Carriers - Quick Start - API Documentation - Usage Examples - Webhooks - Pricing & Business Model - Architecture - Project Structure - Testing - Deployment - Environment Variables - Performance Metrics - Contributing - License - Support --- ## ✨ Features ### 📱 Core SMS Capabilities | Feature | Description | |---------|-------------| | **Send SMS** | High-volume SMS delivery with automatic carrier routing | | **Two-Way SMS** | Receive and reply to messages in real-time | | **Auto-Reply Rules** | Configure keyword-based automatic responses | | **Bulk SMS Ready** | Architecture supports bulk messaging | | **Delivery Reports** | Track message delivery status | ### 💰 Payment & Credits | Feature | Description | |---------|-------------| | **Mobile Money** | MTN & Airtel payments via Flutterwave | | **Credit System** | Pay-per-SMS model (50 UGX per message) | | **Balance Management** | Real-time balance tracking | | **Transaction History** | Complete audit trail of all purchases | ### 🔧 Technical Features | Feature | Description | |---------|-------------| | **RESTful API** | 15+ production-ready endpoints | | **SMPP v3.4** | Direct carrier connections via SMPP protocol | | **Webhook Support** | Real-time notifications for incoming messages | | **Carrier Detection** | Automatic routing to MTN, Airtel, Safaricom | | **SQLite Database** | Lightweight, zero-configuration persistence | --- ## 🌍 Supported Countries & Carriers | Country | Carriers | Prefixe …