aungpyaekyaw/telenor-sms

TelenorBulkSms

This package makes it easy to send sms notification using Telenor Myanmar Business SMS service with laravel. You can access Telenor Myanmar Developer Portal from here.

Installation

Via Composer

$ composer require solvecase/telenorbulksms

Setting Up

Open up .env file and add the following:

TELENOR_API_BASE_URL=https://prod-apigw.mytelenor.com.mm/
TELENOR_SMS_CALLBACK_URL=oauth2/telenorsms/callback
TELENOR_SMS_CLIENT_ID=
TELENOR_SMS_CLIENT_SECRET=
TELENOR_SMS_SENDER=
TELENOR_SMS_USERNAME=
TELENOR_SMS_PASSWORD=

Open up config/app.php and find the providers key.

'providers' => [
    ...
    SolveCase\TelenorBulkSms\TelenorBulkSmsServiceProvider::class,
]

Laravel Task Scheduling is used to request bearer access token every hour and save it in cache. So, add the following Cron entry to your server interval every minute.

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

Usage

Using Laravel Notification

<?php

namespace App;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class User extends Authenticatable
{
    use Notifiable;

    /**
     * Route notifications for the telenor sms channel.
     *
     * @param  \Illuminate\Notifications\Notification  $notification
     * @return string
     */
    public function routeNotificationForTelenorSms($notification)
    {
        return $this->mobile_no; // 959xxxxxxxx
    }
}

<?php

namespace App\Notifications;

use Illuminate\Notifications\Notification;
use SolveCase\TelenorBulkSms\TelenorMessage;
use SolveCase\TelenorBulkSms\TelenorSmsChannel;

class InvoicePaid extends Notification
{

    /**
     * Get the notification channels.
     *
     * @param  mixed  $notifiable
     * @return array|string
     */
    public function via($notifiable)
    {
        return [TelenorSmsChannel::class];
    }

    /**
     * Get the sms representation of the notification.
     *
     * @param  mixed  $notifiable
     * @return TelenorMessage
     */
    public function toTelenorSms($notifiable)
    {
        return TelenorMessage::create()
			->content($notifiable->inovice->id . ' has been paid!');
    }
}

$user->notify(new InvoicePaid($invoice));

Using The Notification Facade

Notification::send($users, new InvoicePaid($invoice));

Sending Sms using TelenorSmsClient

<?php

namespace App\Http\Controllers;

use SolveCase\TelenorBulkSms\TelenorSmsClient;
use SolveCase\TelenorBulkSms\TelenorMessage;

class SmsController extends Controller{

	public function sendsms(){
		try{
			$message = TelenorMessage::create('Hello, Good Morning!')
				->to(959xxxxxxxx)->toArray();
			$client = new TelenorSmsClient();
			$response = $client->send($message)->getBody();
		}catch(\Exception $ex){
			return back()->withErrors('Something went wrong.');
		}
	}

}

Change log

Please see the changelog for more information on what has changed recently.

Contributing

Please see contributing.md for details and a todolist.

Security

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

Credits

• SolveCase
• All Contributors

License

license. Please see the license file for more information.