Ultimate SMS API is build for Ultimate SMS - Bulk SMS Application For Marketing
Switch branches/tags
Nothing to show
Clone or download
Latest commit 86ca417 May 7, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Update SMS API regarding Version 2.0 Nov 25, 2017
.gitignore Update README.md Aug 25, 2017
README.md API update for Ultimate SMS V 2.3 Apr 27, 2018
composer.json Update composer.json May 7, 2018
composer.lock travis checking added Jun 3, 2017
example.php Unicode support added Jan 27, 2018

README.md

Latest Stable Version License GitHub issues GitHub stars

Ultimate SMS API

Ultimate SMS API is build for Ultimate SMS - Bulk SMS Application For Marketing

Prerequisites

To run Ultimate SMS API you have to install Ultimate SMS Application on your server. For more details please visit: Ultimate SMS

php >=5.6
Ultimate SMS - Bulk SMS Application For Markting

Installing

Via Composer

composer require shamim/ultimate-sms-api 

And Via Bash

git clone https://github.com/akasham67/ultimate-sms-api.git

Usage

Step 1:

If install Ultimate SMS API using Git Clone then load your Ultimate SMS API Class file and Use namespace.

require_once 'src/Class_Ultimate_SMS_API.php';
use UltimateSMS\UltimateSMSAPI;

If install Ultimate SMS API using Composer then Require/Include autoload.php file in the index.php of your project or whatever file you need to use Ultimate SMS API classes:.

require 'vendor/autoload.php';
use UltimateSMS\UltimateSMSAPI;

Step 2:

set your API_KEY from https://mywebhost.com/sms-api/info (your application install url)

$api_key = 'YWRtaW46YWRtaW4ucGFzc3dvcmQ=';

Step 3:

Change the from number below. It can be a valid phone number or a String

$from = '8801721000000';

Step 4:

the number we are sending to - Any phone number

$destination = '8801810000000';

You have to must include Country code at beginning of the phone number.

Step 5:

Replace your Install URL like https://mywebhost.com/sms/api with https://ultimatesms.coderpixel.com/demo/ sms/api is mandatory on your install url

$url = 'https://ultimatesms.coderpixel.com/demo/sms/api';

// SMS Body

$sms = 'test message from Ultimate SMS';

// Unicode SMS

$unicode = '1'; //For Unicode message

// Voice SMS

$voice = '1'; //For voice message

// MMS SMS

$mms = '1'; //For mms message
$media_url = 'https://yourmediaurl.com'; //Insert your media url

// Schedule SMS

$schedule_date = '09/17/2018 10:20 AM'; //Date like this format: m/d/Y h:i A

// Create Plain/text SMS Body for request

$sms_body = array(
    'api_key' => $api_key,
    'to' => $destination,
    'from' => $from,
    'sms' => $sms
);

// Create Unicode SMS Body for request

$sms_body = array(
    'api_key' => $api_key,
    'to' => $destination,
    'from' => $from,
    'sms' => $sms,
    'unicode' => $unicode,
);

// Create Voice SMS Body for request

$sms_body = array(
    'api_key' => $api_key,
    'to' => $destination,
    'from' => $from,
    'sms' => $sms,
    'voice' => $voice,
);

// Create MMS SMS Body for request

$sms_body = array(
    'api_key' => $api_key,
    'to' => $destination,
    'from' => $from,
    'sms' => $sms, //optional
    'mms' => $mms,
    'media_url' => $media_url,
);

// Create Schedule SMS Body for request

$sms_body = array(
    'api_key' => $api_key,
    'to' => $destination,
    'from' => $from,
    'sms' => $sms,
    'schedule' => $schedule_date,
);

Step 6:

Instantiate a new Ultimate SMS API request

$client = new UltimateSMSAPI();

Send SMS

Finally send your sms through Ultimate SMS API

$response = $client->send_sms($sms_body, $url);

Get Inbox

Get your all message

$get_inbox=$client->get_inbox($api_key,$url);

Get Balance

Get your account balance

$get_balance=$client->check_balance($api_key,$url);

Response

Ultimate SMS API return response with json format, like:

{"code":"ok","message":"Successfully Send"}

Status Code

Status Message
ok Successfully Send
100 Bad gateway requested
101 Wrong action
102 Authentication failed
103 Invalid phone number
104 Phone coverage not active
105 Insufficient balance
106 Invalid Sender ID
107 Invalid SMS Type
108 SMS Gateway not active
109 Invalid Schedule Time
110 Media url required
111 SMS contain spam word. Wait for approval

Authors

  • Abul Kashem Shamim - Initial work - akasham67