ibrahem-kamal/omni-messaging

An easy to use, consistent sms library for Laravel

2.2.0 2024-04-13 17:30 UTC

This package is auto-updated.

Last update: 2024-05-29 19:13:42 UTC


README

An easy to use, consistent sms library for Laravel

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Omni messaging is heavily inspired by the PHP OmniPay Library and is designed to be a simple and consistent interface for sending SMS messages in Laravel.

there are many SMS gateways out there, and they all have their own API's, and they all have their own way of doing things. Omni Messaging is designed to provide a consistent interface for sending SMS messages, regardless of the gateway you are using.

Currently supported gateways are (Many more will be added in the future either by me or the community):

Sms Gateway 1.x Composer Package Maintainer
Jawaly Sms ibrahem-kamal/omni-messaging-jawaly-sms-driver Ibrahem Kamal

Installation

You can install the package via composer:

composer require ibrahem-kamal/omni-messaging

You can publish and run the migrations with:

php artisan vendor:publish --tag="omni-messaging-migrations"

You can publish the config file with:

php artisan vendor:publish --tag="omni-messaging-config"

This is the contents of the published config file:

return [
    /**
     * Channels should be added in the following format:
     * 'channels' => [
     *     'channel_name' => [
     *        'driver' => 'driver_name',
     *       'options' => []
     *    ]
     * ]
     */
    'channels' => [],
    'webhook' => [
        'queue' => 'default',
    ],
];

Usage

  • Sending Sms
$sms = OmniMessaging::driver('jawaly')->send($message,$mobileNumber,$sender,$options = []);
    $sms->isSuccess(); //bool
    $sms->getErrorsString(); // errors as string
    $sms->getErrors(); // errors as array
    $sms->getData(); // array of data returned from the gateway
    $sms->toArray(); // array of all the above
  • Retrieving Balance
$balance = OmniMessaging::driver('jawaly')->getBalance();
    $balance->isSuccess(); //bool
    $balance->getErrorsString(); // errors as string
    $balance->getErrors(); // errors as array
    $balance->getData(); // array of data returned from the gateway
    $balance->toArray(); // array of all the above
  • Handling Sms Webhooks

by default this package will handle the incoming sms webhooks using the gateway logic and dispatch an event OmniMessagingWebhookUpdateEvent with the parsedWebhookData as payload. so for example to listen to incoming sms you can do the following:

// in your event service provider
     OmniMessagingWebhookUpdateEvent::class => [
            YourListener::class,
        ]

and within your listener you can access the parsed data as follows:

    public function handle(OmniMessagingWebhookUpdateEvent $event)
    {
          foreach ($event->parsedWebhookData as $parsedNumber) {
            $parsedNumber->getNumber(); // phone number string
            $parsedNumber->getFrom(); // sender string
            $parsedNumber->getReference(); // reference string such as message id
            $parsedNumber->isSuccess(); // bool
            $parsedNumber->getError(); // string
            $parsedNumber->toArray(); // array of all the above
        }
    }

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.

Roadmap

[❌] Create Log Driver for local development

[❌] Create Twilio Driver