PHPackages                             toneflix-code/kudisms-notification - 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 &amp; Notifications](/categories/mail)
4. /
5. toneflix-code/kudisms-notification

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

toneflix-code/kudisms-notification
==================================

KUDI SMS Notifications Driver for Laravel.

1.1.1(8mo ago)01.5k↓100%MITPHPPHP &gt;= 8.1CI passing

Since Feb 6Pushed 8mo agoCompare

[ Source](https://github.com/toneflix/kudisms-notification)[ Packagist](https://packagist.org/packages/toneflix-code/kudisms-notification)[ Docs](https://github.com/toneflix-code/kudi-notification)[ RSS](/packages/toneflix-code-kudisms-notification/feed)WikiDiscussions main Synced today

READMEChangelog (4)Dependencies (10)Versions (5)Used By (0)

KUDI SMS Notifications channel for Laravel
==========================================

[](#kudi-sms-notifications-channel-for-laravel)

[![Test & Lint](https://github.com/toneflix/kudisms-notification/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/toneflix/kudisms-notification/actions/workflows/run-tests.yml)[![Latest Stable Version](https://camo.githubusercontent.com/fea4d8d395d7d697ce769ae8aa520b6741919a2fe6a0d4d2060daf627474d532/687474703a2f2f706f7365722e707567782e6f72672f746f6e65666c69782d636f64652f6b756469736d732d6e6f74696669636174696f6e2f76)](https://packagist.org/packages/toneflix-code/kudisms-notification) [![Total Downloads](https://camo.githubusercontent.com/e2a90671e6641cfe2fcf637c20f8366bb637341e7a5deca69b36ab8326bd96b8/687474703a2f2f706f7365722e707567782e6f72672f746f6e65666c69782d636f64652f6b756469736d732d6e6f74696669636174696f6e2f646f776e6c6f616473)](https://packagist.org/packages/toneflix-code/kudisms-notification) [![Latest Unstable Version](https://camo.githubusercontent.com/fb358890812c983d699444ea90a671b09b70e86bb1b390e7af144e0ec5b4affa/687474703a2f2f706f7365722e707567782e6f72672f746f6e65666c69782d636f64652f6b756469736d732d6e6f74696669636174696f6e2f762f756e737461626c65)](https://packagist.org/packages/toneflix-code/kudisms-notification) [![License](https://camo.githubusercontent.com/54469bb7551a1148c8df476db3681dc1658d008a369dd7dde9c6d7233557a95a/687474703a2f2f706f7365722e707567782e6f72672f746f6e65666c69782d636f64652f6b756469736d732d6e6f74696669636174696f6e2f6c6963656e7365)](https://packagist.org/packages/toneflix-code/kudisms-notification) [![PHP Version Require](https://camo.githubusercontent.com/7352f5ba3c08aee587eedd386be2caf8373c362d2530dfa2a1a92b4b65f57e95/687474703a2f2f706f7365722e707567782e6f72672f746f6e65666c69782d636f64652f6b756469736d732d6e6f74696669636174696f6e2f726571756972652f706870)](https://packagist.org/packages/toneflix-code/kudisms-notification)[![codecov](https://camo.githubusercontent.com/d9e60951487de2e1d381b3fbf5d13fbe3f68793f9cb1f45179236582c266aca7/68747470733a2f2f636f6465636f762e696f2f67682f746f6e65666c69782f6b756469736d732d6e6f74696669636174696f6e2f67726170682f62616467652e7376673f746f6b656e3d324f376146756c513950)](https://codecov.io/gh/toneflix/kudisms-notification)

This package makes it easy to send [KudiSMS notifications](https://kudisms.net) with Laravel 8.x, 9.x, 10.x, 11.x &amp; 12.x

Contents
--------

[](#contents)

- [Installation](#installation)
- [Usage](#usage)
    - [Available Message methods](#available-message-methods)
- [Changelog](#changelog)
- [Testing](#testing)
- [Security](#security)
- [Contributing](#contributing)
- [Credits](#credits)
- [License](#license)

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

[](#installation)

You can install the package via composer:

```
composer require toneflix-code/kudisms-notification
```

### Configuration

[](#configuration)

Add your KudiSMS Account token, SenderId, and CallerId (optional) to your `.env`:

```
KUDISMS_GATEWAY= # optional
KUDISMS_API_KEY=ZYX # always required
KUDISMS_SENDER_ID=ABCD # always required
KUDISMS_CALLER_ID=ABCD # optional when sender id is set
KUDISMS_TEST_NUMBERS=23423423423,12312312312 # Comma separated list of numbers to send messages to when running tests
```

### Advanced configuration

[](#advanced-configuration)

Run `php artisan vendor:publish --provider="ToneflixCode\KudiSmsNotification\KudiSmsProvider"`

```
/config/kudi-notification.php

```

Usage
-----

[](#usage)

Now you can use the channel in your `via()` method inside the notification:

```
use ToneflixCode\KudiSmsNotification\KudiSmsChannel;
use ToneflixCode\KudiSmsNotification\KudiSmsMessage;
use Illuminate\Notifications\Notification;

class AccountApproved extends Notification
{
    public function via($notifiable)
    {
        return [KudiSmsChannel::class];
    }

    public function toKudiSms($notifiable)
    {
        return (new KudiSmsMessage())
            ->message("Your {$notifiable->service} account was approved!");
    }
}
```

You can also create a Kudi voice call:

```
use ToneflixCode\KudiSmsNotification\KudiSmsChannel;
use ToneflixCode\KudiSmsNotification\KudiSmsVoiceMessage;
use Illuminate\Notifications\Notification;

class AccountApproved extends Notification
{
    public function via($notifiable)
    {
        return [KudiSmsChannel::class];
    }

    public function toKudiSms($notifiable)
    {
        return (new KudiSmsVoiceMessage())
            ->url("https://download.samplelib.com/mp3/sample-3s.mp3");
    }
}
```

Or create a Kudi Text To Speach call:

```
use ToneflixCode\KudiSmsNotification\KudiSmsChannel;
use ToneflixCode\KudiSmsNotification\KudiSmsTTSMessage;
use Illuminate\Notifications\Notification;

class AccountApproved extends Notification
{
    public function via($notifiable)
    {
        return [KudiSmsChannel::class];
    }

    public function toKudiSms($notifiable)
    {
        return (new KudiSmsTTSMessage())
            ->message("Hello {$notifiable->name}, how are you today?");
    }
}
```

In order to let your Notification know which phone are you sending/calling to, the channel will look for the `phone_number` attribute of the Notifiable model. If you want to override this behaviour, add the `routeNotificationForKudiSms` method to your Notifiable model.

```
public function routeNotificationForKudiSms()
{
    return '+2349034567890';
}
```

### Available Message methods

[](#available-message-methods)

#### KudiSmsMessage

[](#kudismsmessage)

- `senderId('')`: Accepts a registered SenderId to use as the notification sender.
- `message('')`: Accepts a string value for the notification body.

#### KudiSmsVoiceMessage

[](#kudismsvoicemessage)

- `callerId('')`: Accepts a registered CallerId to use as the notification sender.
- `url('')`: Accepts a url of a publicly available audio file.

#### KudiSmsTTSMessage

[](#kudismsttsmessage)

- `callerId('')`: Accepts a registered CallerId to use as the notification sender.
- `message('')`: Accepts a string value for the notification body.

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Testing
-------

[](#testing)

```
$ composer test
```

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Credits
-------

[](#credits)

- [Legacy](https://github.com/3m1n3nc3)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

37

—

LowBetter than 84% of packages

Maintenance60

Regular maintenance activity

Popularity18

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity53

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 ~174 days

Total

4

Last Release

252d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4638f9de973d94753ebff641af3009e1049064f9a6bd76fe87e58d0d8ddd7ca7?d=identicon)[3m1n3nc3](/maintainers/3m1n3nc3)

---

Top Contributors

[![3m1n3nc3](https://avatars.githubusercontent.com/u/52163001?v=4)](https://github.com/3m1n3nc3 "3m1n3nc3 (29 commits)")

---

Tags

laravelsmslegacykudismsKudikudisms-notification

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/toneflix-code-kudisms-notification/health.svg)

```
[![Health](https://phpackages.com/badges/toneflix-code-kudisms-notification/health.svg)](https://phpackages.com/packages/toneflix-code-kudisms-notification)
```

###  Alternatives

[hooman-mirghasemi/laravel-iran-sms

Laravel Sms

241.8k](/packages/hooman-mirghasemi-laravel-iran-sms)

PHPackages © 2026

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