PHPackages                             dsilva01/ombala-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. [Queues &amp; Workers](/categories/queues)
4. /
5. dsilva01/ombala-sms

ActiveLibrary[Queues &amp; Workers](/categories/queues)

dsilva01/ombala-sms
===================

Ombala Notifications channel for Laravel 9.x and 10.x.

V1.0.1(3mo ago)037MITPHPPHP ^8.1

Since Oct 29Pushed 3mo agoCompare

[ Source](https://github.com/dsilva01/ombala-sms)[ Packagist](https://packagist.org/packages/dsilva01/ombala-sms)[ Docs](https://github.com/dsilva01/ombala-sms)[ RSS](/packages/dsilva01-ombala-sms/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (12)Versions (3)Used By (0)

Ombala Notifications Channel for Laravel
========================================

[](#ombala-notifications-channel-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/fd856ffa4f76a6ed662ef01f10b08f8ba9a5a937d125a2c458572a82829a94c4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6473696c766130312f6f6d62616c612d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/dsilva01/ombala)[![Total Downloads](https://camo.githubusercontent.com/8109dacd7a9e8ad4d8c65661d62cfa6d751b6ccfab12c6bafecfac0c213db312/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6473696c766130312f6f6d62616c612d736d732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/dsilva01/ombala)[![GitHub Tests Action Status](https://camo.githubusercontent.com/1899a2d9e1f556e13489d94afe6fa39daf3c4e9d40af2d951d62bf47385be895/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6473696c766130312f6f6d62616c612d736d732f72756e2d74657374732e796d6c3f7374796c653d666c61742d737175617265)](https://github.com/dsilva01/ombala-sms/actions/workflows/run-tests.yml)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

This package makes it easy to send notifications using [Ombala](https://www.useombala.ao/) with Laravel and 9.x and 10.x.

Contents
--------

[](#contents)

- [Installation](#installation)
    - [Setting up the ombala](#setting-up-the-ombala-service)
- [Usage](#usage)
    - [Available Message methods](#available-message-methods)
    - [ On-Demand Notifications](#on-demand-notifications)
- [Changelog](#changelog)
- [Testing](#testing)
- [Security](#security)
- [Contributing](#contributing)
- [Credits](#credits)
- [License](#license)

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

[](#installation)

You can install this package via composer:

```
composer require dsilva01/ombala-sms
```

### Setting up the Ombala service

[](#setting-up-the-ombala-service)

Add your Ombala token, default from name (or phone number) to your config/services.php:

```
// config/services.php
...
'ombala' => [
    'endpoint' => env('OMBALA_ENDPOINT', 'https://api.useombala.ao/v1/messages'),
    'token' => env('OMBALA_TOKEN', 'YOUR OMBALA TOKEN HERE'),
    'from' => env('OMBALA_SENDER', 'YOUR OMBALA SENDER HERE')
],
...
```

Usage
-----

[](#usage)

You can use the channel in your via() method inside the notification:

```
use Illuminate\Notifications\Notification;
use NotificationChannels\Ombala\OmbalaMessage;

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

    public function toOmbala($notifiable)
    {
        return (new OmbalaMessage)->content("Your account was approved!");
    }
}
```

In your notifiable model, make sure to include a routeNotificationForOmbala() method, which returns a phone number or an array of phone numbers.

```
public function routeNotificationForOmbala()
{
    return $this->phone;
}
```

### On-Demand Notifications

[](#on-demand-notifications)

Sometimes you may need to send a notification to someone who is not stored as a "user" of your application. Using the Notification::route method, you may specify ad-hoc notification routing information before sending the notification:

```
Notification::route('ombala', '9123123321')
            ->notify(new InvoicePaid($invoice));
```

### Available Message methods

[](#available-message-methods)

`from()`: Sets the from's name. *Make sure to register the from name at you Ombala dashboard.*

`content()`: Set a content of the notification message. This parameter should be no longer than 918 char(6 message parts),

`test()`: Send a test message to specific mobile number or not. This parameter should be boolean and default value is `true`.

Testing
-------

[](#testing)

```
$ composer test
```

Changelog
---------

[](#changelog)

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

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

[](#contributing)

Please see [CONTRIBUTING](https://github.com/dsilva01/ombala-sms/blob/master/.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Desiderio Silva](https://github.com/dsilva01)
- [Tint Naing Win](https://github.com/tintnaingwinn)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance80

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 57.1% 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 ~451 days

Total

2

Last Release

105d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/36a3172bc3404b8212457ee74cec9a66a0d45d9b5d7d602d6afeeabe5758d64d?d=identicon)[dsilva01](/maintainers/dsilva01)

---

Top Contributors

[![dsilva01](https://avatars.githubusercontent.com/u/65828956?v=4)](https://github.com/dsilva01 "dsilva01 (4 commits)")[![atymic](https://avatars.githubusercontent.com/u/50683531?v=4)](https://github.com/atymic "atymic (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

messagelaravelnotificationssmsMyanmarMPTOoredooMyTeltelenorombala

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/dsilva01-ombala-sms/health.svg)

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

###  Alternatives

[laravel/slack-notification-channel

Slack Notification Channel for laravel.

89069.7M111](/packages/laravel-slack-notification-channel)[tzsk/sms

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

320244.3k6](/packages/tzsk-sms)[rinvex/laravel-authy

Rinvex Authy is a simple wrapper for Authy TOTP, the best rated Two-Factor Authentication service for consumers, simplest 2fa Rest API for developers and a strong authentication platform for the enterprise.

3376.7k1](/packages/rinvex-laravel-authy)

PHPackages © 2026

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