PHPackages                             ashik/adn-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. [API Development](/categories/api)
4. /
5. ashik/adn-sms

ActiveLibrary[API Development](/categories/api)

ashik/adn-sms
=============

Laravel Adn SMS Services

v1.0.0(1y ago)014MITPHPPHP ^7.1|^8.0

Since Aug 4Pushed 1y ago1 watchersCompare

[ Source](https://github.com/ashikahmed-bd/Laravel-AdnSms)[ Packagist](https://packagist.org/packages/ashik/adn-sms)[ RSS](/packages/ashik-adn-sms/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

ADN SMS Laravel
===============

[](#adn-sms-laravel)

ADN SMS gateway API package for Laravel.

Installation
------------

[](#installation)

You can install the package via composer in your Laravel or Lumen application.

```
composer require ashik/adn-sms
```

### Laravel

[](#laravel)

Publish the configuration file `config/adn-sms.php` where you can tweak some default options.

```
php artisan vendor:publish --tag=adn-sms-config
```

Define your `ADN_SMS_KEY` and `ADN_SMS_SECRET` in the `.env` file or update the `config/adn-sms.php` file of your application.

Configuration
-------------

[](#configuration)

First have a look at the `./config/adn-sms.php` to know about all the options available out of the box. Some important ones are mentioned below.

**Service Enable/Disable**

You can easily turn off the whole service and any API calls from the config file. Comes in handy if the APIs are down or ongoing maintenance. Remember, if you set `enabled` to `false` in the configuration file, response body will always be empty string `$response->body() = ""`.

Usage
-----

[](#usage)

### Single SMS

[](#single-sms)

**Send single SMS to single recipient.**

```
use Ashik\AdnSms\Facades\AdnSms;

class SmsController
{
    /**
     * Make request and return response
     *
     * @return \Illuminate\Http\Client\Response
     * @throws \Throwable
     */
    public function send()
    {
        $response = AdnSms::to('01XXXXXXXXX')
            ->message('Send SMS Test.')
            ->send();

        return $response->json();
    }
}
```

### OTP SMS

[](#otp-sms)

**Send OTP SMS to single recipient.**

```
use Ashik\AdnSms\Facades\AdnSms;

class SmsController
{
    /**
     * Make request and return response
     *
     * @return \Illuminate\Http\Client\Response
     * @throws \Throwable
     */
    public function otp()
    {
        $response = AdnSms::otp('01XXXXXXXXX')
            ->message('Send OTP SMS Test.')
            ->send();

        return $response->json();
    }
}
```

### Bulk SMS

[](#bulk-sms)

**Send single SMS to multiple recipients.**

Bulk SMS sending requires `campaignTitle()` as mandatory.

```
use Ashik\AdnSms\Facades\AdnSms;

class SmsController
{
    /**
     * Make request and return response
     *
     * @return \Illuminate\Http\Client\Response
     * @throws \Throwable
     */
    public function bulk()
    {
        $response = AdnSms::bulk(['019XXXXXXXX', '015XXXXXXXX'])
            ->campaignTitle('Bulk SMS Test')
            ->message('Send Bulk SMS Test.')
            ->send();

        return $response->json();
    }
}
```

### Queue SMS Sending (Laravel)

[](#queue-sms-sending-laravel)

You can also queue SMS sending. You can pass a callback function in the `queue()` method to receive the `$response` from the API call and process it further. It is really useful if you want to save the response in the database after queue executes. See example for finer detail.

```
use Ashik\AdnSms\Facades\AdnSms;
use Illuminate\Http\Client\Response;
use App\Models\Table;

class SmsController
{
    public function bulk()
    {
        AdnSms::bulk(['019XXXXXXXXX', '02XXXXXXXXX'])
            ->campaignTitle('Bulk SMS Test')
            ->message('Send Bulk SMS Test.')
            ->queue(function (Response $response) {
                // Check if the response body is empty
                if ($response->body() != "") {
                    // Store the $response in the database
                    $model = new Table();
                    $model->data = $response->body();
                    $model->save();
                }
            });
    }
}
```

Do not forget to run `php artisan queue:work`.

**IMPORTANT:** `queue()` method is not available in Lumen as it does not supports queueable closer. However, you can create a queueable job in your Lumen application to do something similar. Call the `send()` method from your job and process the returned response further.

### Check Balance

[](#check-balance)

```
use Ashik\AdnSms\Facades\AdnSms;

class SmsController
{
    /**
     * Make request and return response
     *
     * @return \Illuminate\Http\Client\Response
     * @throws \Throwable
     */
    public function someFunction()
    {
        $response = AdnSms::checkBalance();

        return $response->json();
    }
}
```

### Check SMS Status

[](#check-sms-status)

To check already sent SMS status, simply call the `checkSmsStatus()` method with SMS UID.

```
use Ashik\AdnSms\Facades\AdnSms;

class SmsController
{
    /**
     * Make request and return response
     *
     * @return \Illuminate\Http\Client\Response
     * @throws \Throwable
     */
    public function smsStatus()
    {
        $response = AdnSms::checkSmsStatus('SXXXXXXXXXXXXXXXX');

        return $response->json();
    }
}
```

### Check Campaign Status

[](#check-campaign-status)

To check already sent SMS campaign status, simply call the `checkCampaignStatus()` method with campaign UID.

```
use Ashik\AdnSms\Facades\AdnSms;

class SmsController
{
    /**
     * Make request and return response
     *
     * @return \Illuminate\Http\Client\Response
     * @throws \Throwable
     */
    public function campaignStatus()
    {
        $response = AdnSms::checkCampaignStatus('CXXXXXXXXXXXXXXXX');

        return $response->json();
    }
}
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

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

Unknown

Total

1

Last Release

650d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dc0cd81a3c8572afcd33e9efb934e419981ebd1d815b75fe9dc070e072ef81a7?d=identicon)[ashikahmedbd](/maintainers/ashikahmedbd)

---

Top Contributors

[![ashik-ahmed-bd](https://avatars.githubusercontent.com/u/108466148?v=4)](https://github.com/ashik-ahmed-bd "ashik-ahmed-bd (4 commits)")

### Embed Badge

![Health badge](/badges/ashik-adn-sms/health.svg)

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

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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