README

A flexible Laravel SMS package that supports multiple SMS gateways like BulkSMSBD, Twilio, Arena, and Elitbuzz.
It allows sending SMS using a default sender or a custom sender dynamically per message.

Features

• Multiple SMS Gateway Support
  Supports bangladeshi and internatonal gateways like BulkSMSBD, Arena, Elitbuzz, and Twilio.

• Centralized Configuration Manage provider credentials from .env Switch default provider with SMS_GATEWAY

• Auto Logging All SMS requests stored in sms_logs table

• Event Driven SmsSent event fired after successful send SmsFailed event fired if provider fails

• Dynamic Sender ID
  Call sender() to set a custom sender per message, overriding the default config.

• Default Sender Support
  If sender() is not called, the package automatically uses the sender_id from the config file.

• Facade for Clean Syntax
  Use SMS::send() or SMS::sender()->send() anywhere in your Laravel app.

• Extensible Architecture
  Add new gateways easily by implementing GatewayInterface and updating SMSService.

• Consistent API Responses
  Returns standardized array responses with success or error details.

• Laravel Config Integration
  All gateway credentials, URLs, and sender IDs are configurable via config/laravel-sms.php.

• Error Handling

  Exceptions thrown on missing credentials or failed response.

• Composer Installable
  Package can be installed via Composer and integrated seamlessly with Laravel.

Installation

Require the package via Composer:

composer require sujonmia/laravel-sms

Configuration

1. Register Service Provider & Facade Alias

Open config/app.php and add the provider & alias:

'providers' => [
    // Other Service Providers...
    SujonMia\Smsbd\SMSServiceProvider::class,
],

'aliases' => [
    // Other Facades...
    'SMS' => \SujonMia\Smsbd\Facades\SMS::class,
],

2. Publish Config & Migration

php artisan vendor:publish --provider="SujonMia\Smsbd\SMSServiceProvider"
php artisan migrate

3. Add Single Provider or All Provider Environment Variables

# Default provider
SMS_GATEWAY=arena

# Arena SMS
ARENA_API_KEY=your_api_key
ARENA_ACODE=your_acode
ARENA_SENDER_ID=MYSHOP
ARENA_URL=https://sms.lpeek.com/API/sendSMS

# Elitbuzz
ELITBUZZ_API_KEY=your_api_key
ELITBUZZ_TYPE=text
ELITBUZZ_SENDER_ID=MYSHOP
ELITBUZZ_URL=https://msg.elitbuzz-bd.com/smsapi

# BulkSMSBD
BULKSMSBD_API_KEY=your_api_key
BULKSMSBD_SENDER_ID=MYSHOP
BULKSMSBD_URL=http://bulksmsbd.net/api/smsapi

# Twilio
TWILIO_SID=your_sid
TWILIO_TOKEN=your_token
TWILIO_SENDER_ID=+123456789

4. Example Usage in Controller

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use SujonMia\Smsbd\Facades\SMS;

class SmsController extends Controller
{
    public function send()
    {
        // Send with default sender (from config)
        SMS::send('017XXXXXXXX', 'Hello from default sender!');

        // Send with custom sender
        SMS::sender('SUJON')->send('017XXXXXXXX', 'Hello from custom sender!');

        // Explicit provider
        SMS::via('arena')->send('8801743776488','Hello via Arena');

        // Another provider
        SMS::via('bulksmsbd')->send('01743776488','Hello via BulkSMSBD');

        // Another provider with custom sender
        SMS::via('bulksmsbd')->sender('SUJON')->send('01743776488','Hello via from custom sender BulkSMSBD');
    }
}

5. Log & View History

use SujonMia\Smsbd\Models\SmsLog;

$logs = SmsLog::where('status', 'sent')->latest()->get();

6. Example SMS Logs Table

License

This package is open-sourced software licensed under the MIT license.

Credits

• Sujon – Author & Maintainer
• Laravel – Framework used

Contributing

Contributions are welcome!
If you’d like to improve this package, please fork the repo and submit a pull request.