laravel-notification-channels/jet-sms

Sends SMS using JetSms API

JetSms Notification Channel For Laravel 5.3+

, _(*1)

This package makes it easy to send notifications using JetSms with Laravel 5.5+, 6.x and 7.x., _(*2)

Contents

• Installation
  • Setting up the JetSms service
• Usage
  • Available methods
  • Available events
• Changelog
• Testing
• Security
• Contributing
• Credits
• License

Installation

You can install this package via composer:, _(*3)

``` bash composer require laravel-notification-channels/jet-sms, <sub>(*4)</sub>

### Setting up the JetSms service

Add your desired client, username, password, originator (outbox name, sender name) and request timeout
configuration to your `config/services.php` file:

```php
...
    'JetSms' => [
        'client'     => 'http', // or xml
        'http'       => [
            'endpoint' => 'https://service.jetsms.com.tr/SMS-Web/HttpSmsSend',
        ],
        'xml'        => [
            'endpoint' => 'www.biotekno.biz:8080/SMS-Web/xmlsms',
        ],
        'username'   => '',
        'password'   => '',
        'originator' => "", // Sender name.
        'timeout'    => 60,
    ],
...

Usage

Now you can use the channel in your via() method inside the notification:, <sub>(*5)</sub>

use NotificationChannels\JetSms\JetSmsChannel;
use NotificationChannels\JetSms\JetSmsMessage;

class ResetPasswordWasRequested extends Notification
{
    /**
     * Get the notification's delivery channels.
     *
     * @param  mixed  $notifiable
     * @return array
     */
    public function via($notifiable)
    {
        return [JetSmsChannel::class];
    }

    /**
     * Get the JetSms representation of the notification.
     *
     * @param  mixed  $notifiable
     * @return string|\NotificationChannels\JetSms\JetSmsMessage
     */
    public function toJetSms($notifiable) {
        return "Test notification";
        // Or
        return new ShortMessage($notifiable->phone_number, 'Test notification');
    }
}

Don't forget to place the dedicated method for JetSms inside your notifiables. (e.g. User), <sub>(*6)</sub>

class User extends Authenticatable
{
    use Notifiable;

    public function routeNotificationForJetSms()
    {
        return "905123456789";
    }
}

Available methods

JetSms can also be used directly to send short messages., <sub>(*7)</sub>

Examples:, <sub>(*8)</sub>

JetSms::sendShortMessage($to, $message);
JetSms::sendShortMessages([[
    'recipient' => $to,
    'message'   => $message,
], [
    'recipient' => $anotherTo,
    'message'   => $anotherMessage,
]]);

see: jet-sms-php documentation for more information., <sub>(*9)</sub>

Available events

JetSms Notification channel comes with handy events which provides the required information about the SMS messages., <sub>(*10)</sub>

1. Message Was Sent (NotificationChannels\JetSms\Events\MessageWasSent)
2. Messages Were Sent (NotificationChannels\JetSms\Events\MessageWasSent)
3. Sending Message (NotificationChannels\JetSms\Events\SendingMessage)
4. Sending Messages (NotificationChannels\JetSms\Events\SendingMessages)

Example:, <sub>(*11)</sub>

namespace App\Listeners;

use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use NotificationChannels\JetSms\Events\MessageWasSent;

class SentMessageHandler
{
    /**
     * Handle the event.
     *
     * @param  MessageWasSent  $event
     * @return void
     */
    public function handle(MessageWasSent $event)
    {
        $response = $event->response;
        $message = $event->message;
    }
}

Notes

$response->groupId() will throw BadMethodCallException if the client is set to 'http'. $response->messageReportIdentifiers() will throw BadMethodCallException if the client is set to 'xml'., <sub>(*12)</sub>

change client configuration with caution., <sub>(*13)</sub>

Changelog

Please see CHANGELOG for more information what has changed recently., <sub>(*14)</sub>

Testing

bash $ composer test, <sub>(*15)</sub>

Security

If you discover any security related issues, please email erdemkeren@gmail.com instead of using the issue tracker., <sub>(*16)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*17)</sub>

Credits

• Hilmi Erdem KEREN
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*18)</sub>