This package provides functionality to Send Single and Bulk Sms using TextLocal API and it stores the result in MySQL Database. It also supports multiple TextLocal Accounts.

Add the following code in the composer to install this package into your Laravel Project

Add the package name in the composer require

"goapptiv/textlocal": "1.0.0"

"repositories": [
    {
        "type": "git",
        "url": "https://github.com/GoApptiv/textlocal-package-laravel"
    }
]

Add the following keys in your environment variables.

TEXTLOCAL_API=https://api.textlocal.in

Add your own Encryption Key and IV to encrypt the username, token and working key in the database

TEXTLOCAL_CRYPTO_KEY=KEY
TEXTLOCAL_CRYPTO_IV=RANDOM_IV

Use the following commands to run the migrations in the SQL Database

php artisan vendor:publish --tag=textlocal-migrations
php aritsan migrate

Before you start using the package or placing orders, you need to configure your account in the database.

Use the following Php artisan command to register the account token in the textlocal_accounts table

php artisan textlocal:add-account

Use the following Php artisan command to replace the API Key for the account.

php artisan textlocal:replace-apikey

The Send Sms method will Send SMS to the requested mobile number. This method supports multiple mobile numbers for same message.

use GoApptiv\TextLocal\Facades\TextLocal;


$message = 'SMS MESSAGE';
// Message should be registered in TextLocal and DLT

$mobileNumbers = collect([]);
$mobileNumbers->push(new TextLocalMessage("9999955555", 'UNIQUE_REFERENCE_ID');
$mobileNumbers->push(new TextLocalMessage("9999944444", 'UNIQUE_REFERENCE_ID_2');

$sms = new TextLocalSms($mobileNumbers, 'SENDER_NAME', $message);

TextLocal::sendSMS($sms, 1));

// For Scheduling the message
TextLocal::sendSMS($sms, 1, now()->addMinutes(30));

The Send Bulk Sms method will Send SMS to the requested mobile number. This method supports multiple mobile numbers and multiple messages.

use GoApptiv\TextLocal\Facades\TextLocal;

$message1 = 'FIRST MESSAGE';
$message2 = 'SECOND MESSAGE';

$messages = collect([]);
$messages->push(new TextLocalMessage("9999955555", 'UNIQUE_REFERENCE_ID', $message));
$messages->push(new TextLocalMessage("9999944444", 'UNIQUE_REFERENCE_ID', $message2));

$bulk = new TextLocalBulkSms($messages, 'SENDER');

TextLocal::sendBulkSms($bulk, 1);

// For Scheduling the message
TextLocal::sendBulkSms($bulk, 1, now()->addMinutes(30));