Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arif98741/laravelbdsms
Xenon\LaravelBDSms is a laravel based multi sms gateway package for sending text message to Bangladeshi mobile numbers using several gateways like sslsms, greenweb, dianahost, metronet, boomcast, bulksmsbd, adn, mobireach, tense, banglalink. You can see installation from https://youtu.be/i2wjLNoIvIo
https://github.com/arif98741/laravelbdsms
alpha-sms bangladeshi-sms-gateway bd-sms-gateway boomcast bulksms-api bulksmsbd gateway-api infobip infobip-api laravel-sms laravel-sms-gateway onnorokom-sms-service php php-sms-gateway sms sms-gateway sms-gateway-package sslcommerz sslcommerz-api-laravel
Last synced: 22 days ago
JSON representation
Xenon\LaravelBDSms is a laravel based multi sms gateway package for sending text message to Bangladeshi mobile numbers using several gateways like sslsms, greenweb, dianahost, metronet, boomcast, bulksmsbd, adn, mobireach, tense, banglalink. You can see installation from https://youtu.be/i2wjLNoIvIo
- Host: GitHub
- URL: https://github.com/arif98741/laravelbdsms
- Owner: arif98741
- License: mit
- Created: 2021-06-28T09:54:42.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-05-21T12:41:56.000Z (6 months ago)
- Last Synced: 2024-05-22T08:14:51.620Z (6 months ago)
- Topics: alpha-sms, bangladeshi-sms-gateway, bd-sms-gateway, boomcast, bulksms-api, bulksmsbd, gateway-api, infobip, infobip-api, laravel-sms, laravel-sms-gateway, onnorokom-sms-service, php, php-sms-gateway, sms, sms-gateway, sms-gateway-package, sslcommerz, sslcommerz-api-laravel
- Language: PHP
- Homepage:
- Size: 3.05 MB
- Stars: 133
- Watchers: 5
- Forks: 45
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Xenon\LaravelBDSms is a sms gateway package for sending text message to Bangladeshi mobile numbers using several
gateways for Laravel Framework. You can watch installation process [from youtube](https://youtu.be/i2wjLNoIvIo).
* [Installation](#installation)
* [Step 1:](#step-1)
* [Step 2:](#step-2)
* [Step 3:](#step-3)
* [Step 4:](#step-4)
* [Usage](#usage)
* [Simply use the facade](#simply-use-the-facade)
* [Or, with facade alias](#or-with-facade-alias)
* [Or, if you need to change the default provider on the fly](#or-if-you-need-to-change-the-default-provider-on-the-fly)
* [Or, you can send message with queue. This queue will be added in your jobs table. Message will be sent as soon as job is run.](#or-you-can-send-message-with-queue-this-queue-will-be-added-in-your-jobs-table-message-will-be-sent-as-soon-as-job-is-run-)
* [Log Generate](#log-generate)
* [Sample Code](#sample-code)
* [SSLCommerz](#sslcommerz)
* [MimSms](#mimsms)
* [Sms Send Using Custom Gateway](#sms-send-using-custom-gateway)
* [Currently Supported Sms Gateways](#currently-supported-sms-gateways)
* [Stargazers](#stargazers)
* [Forkers](#forkers)
* [Contributors](#contributors)
# Installation
## Step 1:
```
composer require xenon/laravelbdsms
```
## Step 2:
Publish the package using command
```
php artisan vendor:publish --provider=Xenon\LaravelBDSms\LaravelBDSmsServiceProvider --tag="migrations"
php artisan vendor:publish --provider=Xenon\LaravelBDSms\LaravelBDSmsServiceProvider --tag="config"
php artisan migrate
```
## Step 3:
Select Vendor From Console
## Step 4:
```
php artisan config:cache && php artisan migrate
```
[//]: # (This will create a `sms.php` in the `config/` directory and also table in your database. Set your desired provider as `default_provider` and fill up the)
[//]: # (necessary environment variable of that provider.)
## Usage
### Simply use the facade
`Note: For sending message using facade you must have to set .env credentials and set default provider; Find .env credentials for different providers from inside config/sms.php)`
use Xenon\LaravelBDSms\Facades\SMS;
SMS::shoot('017XXYYZZAA', 'helloooooooo boss!');
SMS::shoot(['017XXYYZZAA','018XXYYZZAA'], 'helloooooooo boss!');
### Or, with facade alias
use LaravelBDSms, SMS;
LaravelBDSms::shoot('017XXYYZZAA', 'helloooooooo boss!');
SMS::shoot('017XXYYZZAA', 'helloooooooo boss!');
### Or, if you need to change the default provider on the fly
use Xenon\LaravelBDSms\Facades\SMS;
use Xenon\LaravelBDSms\Provider\Ssl;
$response = SMS::via(Ssl::class)->shoot('017XXYYZZAA', 'helloooooooo boss!');
### Or, you can send message with queue. This queue will be added in your jobs table. Message will be sent as soon as job is run.
Make sure you have **jobs** table and other jobs related functionalities enabled
use Xenon\LaravelBDSms\Facades\SMS;
use Xenon\LaravelBDSms\Provider\Ssl;
SMS::shootWithQueue("01XXXXXXXXX",'test sms');
SMS::via(Ssl::class)->shootWithQueue("01XXXXXXXXX",'test sms');
# Log Generate
You can generate log for every sms api request and save in database or file. For doing this. Follow below points
1. Laravelbdsms stores log in two drivers(`database, file`). `database` is default. You can change it from _config/sms.php_
2. Find and make true `'sms_log' => true,`
3. Be confirm you have completed **step-2** and **step-3**
4. For `database` driver
1. Change log driver to `log_driver =>'database'` from `config/sms.php`
2. Run command `php artisan migrate`. This will create `lbs_log` table in your database
5. For `file` driver
1. Change log driver to `log_driver =>'file'` from `config/sms.php`
Otherwise, if you want more control, you can use the underlying sender object. This will not touch any laravel facade or
service provider.
# Sample Code
## SSLCommerz
use Xenon\LaravelBDSms\Provider\Ssl;
use Xenon\LaravelBDSms\Sender;
$sender = Sender::getInstance();
$sender->setProvider(Ssl::class); //change this provider class according to need
$sender->setMobile('017XXYYZZAA');
//$sender->setMobile(['017XXYYZZAA','018XXYYZZAA']);
$sender->setMessage('helloooooooo boss!');
$sender->setQueue(true); //if you want to sent sms from queue
$sender->setConfig(
[
'api_token' => 'api token goes here',
'sid' => 'text',
'csms_id' => 'sender_id'
]
);
$status = $sender->send();
----------Demo Response Using SSL-------------
array:6 [▼
"status" => "response"
"response" => "{"status":"FAILED","status_code":4003,"error_message":"IP Blacklisted"}"
"provider" => "Xenon\LaravelBDSms\Provider\Ssl"
"send_time" => "2021-07-06 08:03:23"
"mobile" => "017XXYYZZAA"
"message" => "helloooooooo boss!"
]
--------------------------------------------------
## Sms Send Using Custom Gateway
We have tried to added most of the gateways of Bangladesh in this package as much as possible. But still if you don't find your expected gateway in this list, then use Custom Gateway using following code snippet.
use Xenon\LaravelBDSms\Provider\CustomGateway;
use Xenon\LaravelBDSms\Sender;
$sender = Sender::getInstance();
$sender->setProvider(CustomGateway::class);
$sender->setUrl('https://your_cusom_gateway_provider_url_here')
->setMethod('post')
->setHeaders([
'Content-Type: application/json',
'Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
], false);
$sender->setMobile('017XXYYZZAA');
$sender->setMessage('text message goes here');
$sender->setQueue(false);
//use required parameters based on your sms gateway. This will be changed according to need
$sender->setConfig(
[
'MsgType' => 'TEXT',
'masking' => 'sample',
'userName' => 'test_user',
'message' => 'test message',
'receiver' => '017xxxxxxxxxx',
]
);
echo $status = $sender->send();
# Currently Supported Sms Gateways
| Provider | Credentials Required
For Sending SMS | Support Multiple | Status | Comment | Contact |
|---------------------|-------------------------------------------------------------------|------------------|----------------|----------------------------------------------------------|---------|
| AjuraTech | apikey, secretkey , callerID | - | Done | - | - |
| Adn | api_key, type, senderid | - | Done | - | - |
| Alpha | api_key | Yes | Done | - | - |
| Banglalink | userID, passwd , sender | - | Done | - | - |
| BDBulkSMS | token | - | Done | - | - |
| BoomCast | masking , userName , password | - | Done | - | - |
| BulksmsBD | api_key,senderid | - | Done | - | - |
| CustomGateway | provide necessary token/api_key/others based on requirements | - | Done | Be careful using this and test based on several scenario | - |
| DhorolaSms | apikey, sender | - | Done | - | - |
| DianaHost | api_key, type, senderid | - | Done | - | - |
| DianaSMS | ApiKey, ClientId, SenderId | - | Done | - | - |
| DurjoySoft | ApiKey, SenderID | - | Done | - | - |
| ElitBuzz | api_key, type, senderid, type | - | Done | not tested yet in live | - |
| Esms | api_token, sender_id | - | Done | - | - |
| Grameenphone | username, password, messagetype | - | Done | not tested yet in live | - |
| Infobip | user, password | - | Done | not tested yet in live | - |
| Lpeek | acode, apiKey, requestID, masking | - | Done | - | - |
| MDL | api_key, type, senderid | - | Done | not tested yet in live | - |
| Metronet | api_key, mask | | Done | - | - |
| MimSms | api_key, type, senderid | - | Done | - | - |
| Mobireach | Username,Password, From | - | Done | - | - |
| Muthofun | sender_id | Yes | Done | - | - |
| NovocomBD | ApiKey , ClientId , SenderId | - | Done | - | - |
| OnnoRokomSMS | userName, userPassword, type, maskName, campaignName | - | Done | not tested yet in live | - |
| QuickSms | api_key, senderid, type,scheduledDateTime | - | Done | not tested yet in live | - |
| RedmoITSms | api_token, sender_id | - | Support closed | - |
| SendMySms | user, closed | - | Done | tested in live |
| SmartLabSMS | user, password, sender | - | Done | - | - |
| Sms4BD | publickey, privatekey, type,sender, delay | - | Done | - | - |
| SmsBangladesh | user, password, from | - | Done | - | - |
| SmsinBD | api_token, senderid | - | Done | | - |
| SMS.net.bd | api_key | - | Done | | - |
| SmsQ | sender_id, client_id, api_key | - | Done | | - |
| SMSNet24 | user_id, user_password, route_id(optional), sms_type_id(optional) | - | Done | - | |
| SmsNoc | sender_id, bearer_token | - | Done | - | |
| SongBird | apikey, secretkey, callerID | - | Done | - | |
| Sslsms | api_token, sid, csms_id | Yes | Done | - | - |
| Tense | user, password, campaign, masking | - | Done | - | - |
| Twenty4BulkSms | api_key, sender_id,user_email | - | Done | - | - |
| TwentyFourBulkSmsBD | customer_id, api_key | - | Done | - | - |
| Trubosms | api_token, sender_id | - | Done | - | - |
| Viatech | api_key, mask | - | Done | - | - |
| WinText | token, messagetype, ismasking, masking | - | Done | - | - |
| ZamanIT | api_key, senderid,type | - | Done | - | - |
### Stargazers
[](https://github.com/arif98741/laravelbdsms/stargazers)
### Forkers
[](https://github.com/arif98741/laravelbdsms/network/members)
### Contributors
We are continuously working in this open source library for adding more Bangladeshi sms gateway. If you feel something
is missing then make a issue regarding that. If you want to contribute in this library, then you are highly welcome to
do that....
For clear documentation read this blog
in [Medium!](https://send-sms-using-laravelbdsms.medium.com/laravel-sms-gateway-package-for-bangladesh-e70af99f2060)
and also you can download several sms providers documentations as pdf from [this link!](https://github.com/arif98741/laravelbdsms/archive/refs/heads/doc.zip)
Special thanks to
[tusharkhan](https://github.com/tusharkhan)
[tusher9352](https://github.com/tusher9352)