zgabievi/sms

Several Georgian SMS APIs Integration

laravel-georgian-sms

, _(*1)

Georgian SMS providers service integration for Laravel 5.* :sunglasses: Trying to make it perfect, easy to use and awesome package :tada: Pull requests are welcome., _(*2)

Table of Contents

• Installation
• Methods
• Config
• ENV
• License

Installation

Composer

Run composer command in your terminal., _(*3)

composer require zgabievi/sms

Laravel

For Laravel 5.5

If you are using Laravel 5.5, than installation is done. Otherwise follow next steps., _(*4)

For Laravel <= 5.4

Open config/app.php, find the providers and add SMSServiceProvider to the array., _(*5)

'providers' => [
    // ...
    Gabievi\SMS\SMSServiceProvider::class,
],

Find the aliases and add Facade to the array., _(*6)

'aliases' => [
    // ...
    'SMS' => Gabievi\SMS\Facades\SMS::class,
],

Methods

• $numbers - comma separated numbers or number, with format: 9955XXXXXXXX
• $message - Text message which will be sent to the numbers.
• $params - Array of key => values that will be used as http query. (Use this only if you know what you are doing)
• $datetime - Datetime in format Y-m-d H:i:s.
• $msg_id - Message ID, which you will get from provider, to check status in future.

Allowed symbols to use in message:

Config

Publish SMS config file using command:, _(*7)

php artisan vendor:publish

This will create file config\sms.php:, _(*8)

Default SMS Provider

You can specify any allowed sms service provider from list below:, _(*9)

Allowed providers are: 'magti', 'smsoffice', 'smsco', _(*10)

'default' => env('SMS_GATEWAY', 'margti'),

SMS Provider Credentials

Here you must specify credentials required from provider, _(*11)

This credentials will be used in protocol, _(*12)

'providers' => [

    'smsoffice' => [
        'key' => env('SMS_PASSWORD', 'SECRET_KEY'),
        'brand' => env('SMS_USERNAME', 'BRAND_NAME'),
    ],

    'smsco' => [
        'username' => env('SMS_USERNAME', 'USERNAME'),
        'password' => env('SMS_PASSWORD', 'PASSWORD'),
    ],

    'magti' => [
        'username' => env('SMS_USERNAME', 'USERNAME'),
        'password' => env('SMS_PASSWORD', 'PASSWORD'),
        'client_id' => env('SMS_CLIENT_ID', 'CLIENT_ID'),
        'service_id' => env('SMS_SERVICE_ID', 'SERVICE_ID'),
    ],

],

.ENV

You can configure provider credentials in your config or .env file, _(*13)

License

laravel-georgian-sms is licensed under a MIT License., _(*14)