PHPackages                             qsms/qbiez-sms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. qsms/qbiez-sms

ActiveLibrary[Mail & Notifications](/categories/mail)

qsms/qbiez-sms
==============

Laravel package for Qbiez SMS API integration - Phone number formatting, queue support, and real-time delivery reports

v2.0.8(1y ago)037MITPHPPHP ^8.1

Since Apr 27Pushed 1y ago1 watchersCompare

[ Source](https://github.com/ino3103/qbiez-sms)[ Packagist](https://packagist.org/packages/qsms/qbiez-sms)[ Docs](https://github.com/qsms/qbiez-sms)[ RSS](/packages/qsms-qbiez-sms/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (9)Versions (12)Used By (0)

Qbiez SMS Package for Laravel
=============================

[](#qbiez-sms-package-for-laravel)

[![Version](https://camo.githubusercontent.com/90cd57de56aa2fb5b168794204c814fd70e50f8237792200268b1b8906342e07/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f71736d732f716269657a2d736d73)](https://camo.githubusercontent.com/90cd57de56aa2fb5b168794204c814fd70e50f8237792200268b1b8906342e07/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f71736d732f716269657a2d736d73)[![License](https://camo.githubusercontent.com/1c3b003f9a3541671c7b1e379f54811bf29619088614a3a56531af8f5f9cc56c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f71736d732f716269657a2d736d73)](https://camo.githubusercontent.com/1c3b003f9a3541671c7b1e379f54811bf29619088614a3a56531af8f5f9cc56c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f71736d732f716269657a2d736d73)[![PHP Version](https://camo.githubusercontent.com/a9a70ca2b11af82bf8e530dcdc5e50dc48320d975b8066276a9c64dd4d032543/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f71736d732f716269657a2d736d73)](https://camo.githubusercontent.com/a9a70ca2b11af82bf8e530dcdc5e50dc48320d975b8066276a9c64dd4d032543/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f71736d732f716269657a2d736d73)

A modern SMS integration package for Laravel applications with comprehensive features and robust error handling.

📋 Requirements
--------------

[](#-requirements)

- PHP 8.0+
- Laravel 9.x/10.x/12.x
- Composer
- Active Qbiez SMS account

🚀 Quick Start
-------------

[](#-quick-start)

### Registration

[](#registration)

First, register for a free account at  to obtain your API token and sender ID.

### Installation Steps

[](#installation-steps)

1. Install the package via Composer:

```
composer require qsms/qbiez-sms
```

2. Add the following variables to your `.env` file:

```
QSMS_API_TOKEN=your_api_token_here
QSMS_SENDER_ID=your_sender_id_here
QSMS_API_URL=https://sms.qbiez.com/api/http/sms/send
QSMS_LOGGING_ENABLED=true
QSMS_DEFAULT_COUNTRY_CODE=255
QSMS_LOG_FORMAT=json
QSMS_LOG_RETENTION=14
QSMS_RATE_LIMIT=30
QSMS_RATE_WINDOW=60
```

### Basic Usage

[](#basic-usage)

```
use Qsms\QbiezSms\SendSMS;

$sms = new SendSMS();
$response = $sms->send('255755270046', 'Hello World!');
```

⚙️ Advanced Configuration
-------------------------

[](#️-advanced-configuration)

To use advanced configuration options, follow these steps:

1. Create a new file `config/qsms.php` in your Laravel project
2. Copy the following configuration:

```
return [
    'api_token' => env('QSMS_API_TOKEN', ''),
    'sender_id' => env('QSMS_SENDER_ID', ''),
    'api_url' => env('QSMS_API_URL', 'https://sms.qbiez.com/api/http/sms/send'),

    'http' => [
        'timeout' => env('QSMS_HTTP_TIMEOUT', 30),
        'retry' => [
            'times' => env('QSMS_RETRY_TIMES', 3),
            'sleep' => env('QSMS_RETRY_SLEEP', 100),
        ],
    ],

    'default_country_code' => env('QSMS_DEFAULT_COUNTRY_CODE', '255'),

    'logging' => [
        'enabled' => env('QSMS_LOGGING_ENABLED', true),
        'path' => storage_path('logs/qsms'),
        'level' => env('QSMS_LOG_LEVEL', 'info'),
    ],
];
```

3. Optionally, publish the configuration file (if you want to customize it further):

```
php artisan vendor:publish --tag=qsms-config
```

📱 Features
----------

[](#-features)

- Automatic phone number formatting
- Rate limiting protection
- Comprehensive logging
- Error handling
- Message splitting
- Queue support

### Phone Number Formats

[](#phone-number-formats)

```
// All supported formats:
$sms->send('255712345678', 'Message');   // International
$sms->send('0712345678', 'Message');     // Local with zero
$sms->send('712345678', 'Message');      // Local without zero
$sms->send('+255712345678', 'Message');  // With plus
```

### Response Handling

[](#response-handling)

```
$response = $sms->send('255712345678', 'Test');

if ($response['status'] === 'success') {
    echo "Message sent! ID: " . $response['data']['message_id'];
} else {
    echo "Error: " . $response['message'];
}
```

🧪 Testing
---------

[](#-testing)

```
// tests/Feature/SmsTest.php
public function test_can_send_sms()
{
    $sms = new SendSMS();
    $response = $sms->send('255712345678', 'Test');
    $this->assertEquals('success', $response['status']);
}
```

📝 Logging
---------

[](#-logging)

Logs are stored in `storage/logs/qsms/qsms-YYYY-MM-DD.log`

```
{
    "timestamp": "2025-04-27 10:30:00",
    "level": "info",
    "message": "SMS sent",
    "context": {
        "recipient": "255712345678",
        "status": "delivered"
    }
}
```

🔒 Security
----------

[](#-security)

- Rate limiting: 10 messages/minute by default
- Secure API token handling
- Phone number validation
- Input sanitization

🤝 Support
---------

[](#-support)

- [Documentation](https://docs.qbiez.com)
- [GitHub Issues](https://github.com/qbiez/sms/issues)
- Email:

📄 License
---------

[](#-license)

MIT License. See [LICENSE](LICENSE) for details.

🔄 Changelog
-----------

[](#-changelog)

See [CHANGELOG.md](CHANGELOG.md) for release history.

###  Health Score

32

—

LowBetter than 71% of packages

Maintenance51

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

11

Last Release

376d ago

Major Versions

v1.1.0 → v2.0.02025-04-27

PHP version history (2 changes)v1.0.0PHP ^8.0

v2.0.1PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/559c15dc5a852c709f5300f5ed80c7b573ad41e9a9a8e49afbadd64c4f5eb362?d=identicon)[ino3103](/maintainers/ino3103)

---

Top Contributors

[![ino3103](https://avatars.githubusercontent.com/u/62280074?v=4)](https://github.com/ino3103 "ino3103 (14 commits)")

---

Tags

apilaravelnotificationsmsmessaginggatewayqbiez

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/qsms-qbiez-sms/health.svg)

```
[![Health](https://phpackages.com/badges/qsms-qbiez-sms/health.svg)](https://phpackages.com/packages/qsms-qbiez-sms)
```

###  Alternatives

[gr8shivam/laravel-sms-api

A modern, flexible Laravel package for integrating any SMS gateway with REST API support

10138.4k](/packages/gr8shivam-laravel-sms-api)[laravel-notification-channels/telegram

Telegram Notifications Channel for Laravel

1.1k3.4M35](/packages/laravel-notification-channels-telegram)[laravel-notification-channels/discord

Laravel notification driver for Discord.

2371.3M11](/packages/laravel-notification-channels-discord)[tzsk/sms

A robust and unified SMS gateway integration package for Laravel, supporting multiple providers.

320244.3k6](/packages/tzsk-sms)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

226102.4k](/packages/erag-laravel-disposable-email)[ghanem/laravel-smsmisr

Send SMS and SMS Notification via SMS Misr for Laravel

194.8k](/packages/ghanem-laravel-smsmisr)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)