README

A fluent SMS manager for Laravel with multi-driver support and automatic failover.

✨ Features

• 🔗 Fluent API — Chainable, readable interface
• 🔄 Auto Failover — Automatic switch between SMS providers
• 📝 Logging — Every attempt logged to database
• 📊 Delivery Reports — Check message delivery status
• 🔌 Extensible — Add custom drivers with a single interface
• ⚙️ Usage Control — Daily/monthly limits per driver

🚀 Quick Start

composer require karnoweb/sms-sender
php artisan vendor:publish --tag=sms-config
php artisan vendor:publish --tag=sms-migrations
php artisan migrate

use Karnoweb\SmsSender\Facades\Sms;
use Karnoweb\SmsSender\Enums\SmsTemplateEnum;

// Simple message
Sms::message('Hello World')
    ->number('09120000000')
    ->send();

// OTP
Sms::otp(SmsTemplateEnum::LOGIN_OTP)
    ->input('code', '1234')
    ->number('09120000000')
    ->send();

// Multiple recipients
Sms::message('Announcement')
    ->numbers(['09121111111', '09122222222'])
    ->send();

// Check delivery status
$results = Sms::number('09120000000')->checkStatus();

📖 Documentation

Full documentation is available in the docs/ directory.

🧪 Testing

./vendor/bin/phpunit

📄 License

MIT License. See LICENSE for details.