README

A simple and developer-friendly Laravel package for sending SMS via BulkSMSBD — built to make integration painless and clean for all Laravel versions.

🚀 Features

✅ Send SMS (one-to-many)
✅ Send personalized messages (many-to-many)
✅ Check credit balance
✅ Handle Delivery Reports (DLR) via response code
✅ Laravel Events for delivered & failed messages
✅ Works with Laravel 7 – 13 and PHP 8+

🛠️ Installation

composer require rihabrahman/bulksmsbd-laravel

Then publish the config file:

php artisan vendor:publish --tag=bulksmsbd-config

⚙️ Configuration

In your .env file:

BULKSMSBD_API_KEY=your_api_key_here
BULKSMSBD_SENDER_ID=your_sender_id_here
BULKSMSBD_TYPE=text

You can override config in config/bulksmsbd.php.

💬 Sending SMS

🔹 One-to-Many (Same Message to Many Numbers)

use RihabRahman\BulkSmsBd\Facades\Sms;

Sms::send('8801712345678', 'Welcome to our service!');

// Multiple recipients (comma-separated)
Sms::send('8801712345678,8801912345678', 'Meeting starts at 3 PM.');

🔹 Many-to-Many (Different Messages to Different Numbers)

$messages = [
    ['to' => '8801712345678', 'message' => 'Hello Mr. Rahman'],
    ['to' => '8801912345678', 'message' => 'Welcome Ms. Akter'],
];

Sms::sendBulk($messages);

💰 Checking Balance

$balance = Sms::balance();
echo "Remaining Credits: " . $balance;

📡 Delivery Report (DLR)

BulkSMSBD sends the response of your request as plain JSON text.

Example response:

{
  "response_code": 202,
  "message_id": 59432678,
  "success_message": "SMS Submitted Successfully",
  "error_message": ""
}

🧰 Example API Response Codes

🧑‍💻 Developed & Maintained By

Rihab Rahman
🌐 https://rihabrahman.com
📧 Contact: cse.rihab@gmail.com

If you find this package helpful, consider giving it a ⭐ on GitHub!

❤️ Contributing

Pull requests are welcome! Please fork the repo and submit a PR.