This package makes it easy to send SMS notifications using Gammu SMSD with Laravel 5.3.
Please see this issue for more infomation.
This channel was deprecated in Oct 2019 due to lack of a maintainer.
If you'd like to take over maintaince, feel free to open an PR to bring the package up to date & we can transfer the package.
Make sure your Gammu SMSD has properly configured and able to send SMS. For more info to install and configure Gammu SMSD, read the Gammu SMSD documentation.
This is optional if you want to use Gammu Api. Make sure Gammu Api has properly configured and able to send SMS using this API.
Under the hood, Gammu Api is using gammu sendsms command line.
You can install the package via composer:
composer require laravel-notification-channels/gammuYou must install the service provider:
// config/app.php
'providers' => [
...
NotificationChannels\Gammu\GammuServiceProvider::class,
],There are two methods to send SMS using Gammu. First method is using native Gammu SMSD method, by inserting data directly to Gammu SMSD database. The second method is using Gammu Api.
Make sure your Gammu SMSD has properly configured and able to send SMS by inserting data to outbox table. The Gammu SMSD and database can be installed in the same machine or in different machine.
Add this settings in config/services.php to send SMS using native Gammu method.
...
'gammu' => [
'method' => env('GAMMU_METHOD', 'db'),
'sender' => env('GAMMU_SENDER', null),
],
...Set the database setting to point Gammu SMSD database in config/database.php by adding this settings below.
// config/database.php
...
'connections' => [
...
'gammu' => [
'driver' => 'mysql',
'host' => env('DB_GAMMU_HOST', 'localhost'),
'port' => env('DB_GAMMU_PORT', '3306'),
'database' => env('DB_GAMMU_DATABASE', 'forge'),
'username' => env('DB_GAMMU_USERNAME', 'forge'),
'password' => env('DB_GAMMU_PASSWORD', ''),
'charset' => 'utf8',
'collation' => 'utf8_unicode_ci',
'prefix' => '',
'strict' => true,
'engine' => null,
],
...
],
...The sender is the default sender name defined in phones table. If it's not set, it will automatically select the first data from phones table. This setting is useful if you have multiple sender.
Make sure your Gammu Api has properly configured and able to send SMS via it's API. The Gammu Api can be installed in the same machine or in different machine.
Add these settings in config/services.php to send SMS.
...
'gammu' => [
'method' => env('GAMMU_METHOD', 'api'),
'auth' => env('GAMMU_AUTH', 'gammu-api-key'),
'url' => env('GAMMU_URL', 'http://gammu.api/')
],
...Make sure, that your Redis server is running and it's able to communicate with your application and gammu api. You are also able to specify ->channel('name-channel') for using multiple Gammu Api's or have it on a non-default channel.
...
'gammu' => [
'method' => env('GAMMU_METHOD', 'redis')
],
...You can now use the channel in your via() method inside the Notification class.
namespace App\Notifications;
use NotificationChannels\Gammu\GammuChannel;
use NotificationChannels\Gammu\GammuMessage;
use Illuminate\Notifications\Notification;
class SendNotificationToSms extends Notification
{
public function via($notifiable)
{
return [GammuChannel::class];
}
public function toGammu($notifiable)
{
return (new GammuMessage())
->to($phoneNumber)
->content($content);
}
}If you have multiple senders, you can set the sender by passing sender method. If sender is not set, it will use one of sender from phones table. This method is only available if you're using native Gammu SMSD method.
public function toGammu($notifiable)
{
return (new GammuMessage())
->to($phoneNumber)
->sender($sender)
->content($content);
}You can either send the notification by providing with the phone number of the recipient to the to($phoneNumber) method like shown in the above example or add a routeNotificationForGammu() method in your notifiable model.
...
/**
* Route notifications for the Gammu channel.
*
* @return string
*/
public function routeNotificationForGammu()
{
return $this->phone;
}
...to($phoneNumber):(string)Receiver phone number. Using international phone number (+62XXXXXXXXXX) format is highly suggested.content($message):(string)The SMS content. If content length is more than 160 characters, it will be sent as long SMS automatically.sender($sender):(string)Phone sender ID set in Gammuphonestable. This method is only available if you're using native Gammu method.callback($callbackText):(string)Callback text for Gammu Api gives you function to pass text and when the Api will send your message it will be sent back to your callback url specified in your Gammu Api. Please setup callback properly on your Gammu Api.channel($redisChannelName):(string)Channel to publish to Redis. Default channel isgammu-channel.
Please see CHANGELOG for more information what has changed recently.
$ composer testIf you discover any security related issues, please email [email protected] or [email protected] instead of using the issue tracker.
Please see CONTRIBUTING for details.
The MIT License (MIT). Please see License File for more information.