Home

Awesome

Latest Stable Version License GitHub issues GitHub stars Scrutinizer Code Quality Code Intelligence Status Build Status

Cyn SMS API

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

Prerequisites

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

Installing

Via Composer

composer require cynojine/cynsms-api 

And Via Bash

git clone https://github.com/cynojine/cynsms-api.git

Usage

Step 1:

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

require_once 'src/Class_Cyn_SMS_API.php';
use CynSMS\CynSMSAPI;

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

require 'vendor/autoload.php';
use CynSMS\CynSMSAPI;

Step 2:

set your API_KEY from http://sms.cynojine.com/sms-api/info (user panel)

$api_key = 'YWRtaW46YWRtaW4ucGFzc3dvcmQ=';

Step 3:

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

$from = '2699655847554';

Step 4:

the number we are sending to - Any phone number

$destination = '2699655847554';

the number we are sending to - Any phone number

$destination = '2699655847554';

For multiple number please use Comma (,) after every single number.

$destination = '2699655847554,2699655847556,2699655847557,2699655847558';

You can insert maximum 100 numbers using comma in single api request.

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

Step 5:

Replace your Install URL like http://mywebhost.com/sms/api with http://sms.cynojine.com/ sms/api is mandatory on your install url

$url = 'https://sms.cynojine.com/sms/api';

// SMS Body

$sms = 'test message from Cyn SMS';

// Unicode SMS

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

// Voice SMS

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

// MMS SMS

$mms = '1'; //For mms message
$media_url = 'http://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 Cyn SMS API request

$client = new CynSMSAPI();

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);

Get Delivery Reports

Get your all message

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

Response

Cyn SMS API return response with json format, like:

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

Status Code

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

New PHP Library

CynSMS PHP Library

Authors