Elite-Pulse/Playsms-Plugin-Orange-Maroc

This plugin enables playSMS to send SMS messages through Orange Morocco's SmartMessage API platform. It provides full integration with Orange's REST API, supporting various message types and automatic credit management. # Orange Maroc Gateway Plugin for playSMS ## Description This plugin enables playSMS to send SMS messages through Orange Morocco's SmartMessage API platform. It provides full integration with Orange's REST API, supporting various message types and automatic credit management. ## Features - **JWT Authentication**: Secure authentication using Orange's token-based system - **Multiple Categories**: Support for Promo, OTP, and Transactional messages - **Custom Sender ID**: Configure your approved sender ID - **Delivery Reports**: Receive DLR callbacks from Orange - **Incoming SMS**: Handle incoming messages through callbacks - **Credit Management**: Automatic deduction of credits per SMS sent - **SMSC Support**: Configure multiple SMSCs with different settings - **Comprehensive Logging**: Detailed logs for troubleshooting ## Requirements - playSMS 1.4.3 or higher - PHP 7.4 or higher - PHP curl extension enabled - MariaDB/MySQL database - Orange SmartMessage account - Approved sender ID from Orange ## Installation See INSTALLATION_GUIDE.md for complete installation instructions. Quick installation: ```bash cd /home/user/sms-gateway/public_html/plugin/gateway/ git clone repolink cd orange_maroc bash quick_setup.sh ``` ## Configuration ### Required Settings 1. **API Username (Email)**: Your Orange SmartMessage account email 2. **API Password**: Your Orange SmartMessage password 3. **Sender ID**: Your approved sender ID (e.g., "Orange") 4. **Category**: Select Promo, OTP, or TXN ### Optional Settings 1. **Callback URL**: For receiving delivery reports 2. **Callback Authcode**: Security token for callback authentication 3. **Timezone**: Your local timezone (default: +0100 for Morocco) ## Usage ### Sending SMS 1. Login to playSMS 2. Navigate to "Send message" 3. Fill in recipient and message 4. Click "Send" The system will: - Authenticate with Orange API - Send the SMS - Log the transaction - Deduct 1 credit from your balance - Store the …