Skip to content

Laravel and PHP adapter for sending SMS using Movesms (Movetech Solutions Bulk SMS)

License

Notifications You must be signed in to change notification settings

savannabits/movesms

Repository files navigation

Laravel / PHP Movesms

Latest Version on Packagist GitHub code size in bytes Travis (.com) Build Scrutinizer code quality Scrutinizer build Total Downloads

The Laravel / PHP SDK for Movetech Solutions' Bulk SMS API (Movesms). See their Bulk SMS API for more details.

Installation

You can install the package via composer:

composer require savannabits/movesms

Usage

Required API Params:

  • username - Your account Username
  • api_key - Your API Key
  • sender - Your Sender ID
  • to - Your Recipients separated by commas
  • message - Your Text Message
  • msgtype - Type of the message (use 5 for plain sms)
  • dlr - Type of Delivery Report(use 0 for no delivery Report)

Send Bulk SMS:

$username = "YOUR MOVETECH USERNAME"; 
$senderId = "YOUR MOVETECH SENDER ID";
$apiKey = "YOUR MOVETECH API KEY";

$recipients = ["+254xxxxxx"]; //Array of recipient phone numbers in international format
$message = "Hello World! Here is my message.";

$res =  Savannabits\Movesms\Movesms::init($username,$apiKey, $senderId)
            ->to($recipients)
            ->message($message)
            ->send();
                        
// Returns a php object with the following format:
$res = [
    "success" => true, //boolean
    "message" => "Message Sent:1701" // Or the error in case success = false
];

Schedule SMS to send Later

$scheduleAt = '2021-04-24 14:04:00'; // Time in the format Y-m-d H:i:s
$res =  Savannabits\Movesms\Movesms::init($username,$apiKey, $senderId)
            ->to($recipients)
            ->message($message)
            ->sendLater($scheduleAt);

Check credit Balance

$res = Savannabits\Movesms\Movesms::checkBalance($apiKey);

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email maosa.sam@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.