iTexMo

iTexMo API for Laravel.

Installation

Install using Composer

$ composer require woenel/itexmo "^0.3"

Publish the config file named itexmo.php and set the iTexMo API code.

$ php artisan vendor:publish --provider="Woenel\Itexmo\ItexmoServiceProvider"

Usage

Send a Message

These are the three methods you can use to send a message:

1. Using facade

use Itexmo;

$res = Itexmo::to('09123456789')->message('Hello World!')->send();

if($res == '0') {
  // Success message or logic. Refer to the return codes below.
}

2. Instantiating class

use Woenel\Itexmo;

$itexmo = new Itexmo;

$res = $itexmo->to('09123456789')->message('Hello World!')->send();

if($res == '0') {
  // Success message or logic. Refer to the return codes below.
}

3. Instantiating class (one-by-one)

use Woenel\Itexmo;

$itexmo = new Itexmo;

$itexmo->to = '09123456789';
$itexmo->message = 'Hello World!';
$itexmo->send();

if($itexmo->result == '0') {
  // Success message or logic. Refer to the return codes below.
}

You can choose any of them. Either way should work.

Return codes

"0" = Success! Message is now on queue and will be sent soon.
"1" = Invalid number.
"2" = Number prefix not supported. Please contact us so we can add.
"3" = Invalid ApiCode.
"4" = Maximum Message per day reached. This will be reset every 12:00AM.
"5" = Maximum allowed characters for message reached.
"6" = System offline.
"7" = Expired ApiCode.
"8" = iTexMo Error. Please try again later.
"9" = Invalid function parameters.
"10" = Recipient's number is blocked due to flooding, message was ignored.
"11" = Recipient's number is blocked temporarily due to hard sending and the message was ignored.
"12" = Invalid request. You can't set message priorities on non corporate apicodes.
"13" = Invalid or not registered custom sender ID.

Features

Implemented features

Send a Message
Check API Service Status and your SMS Server Status (Not in Usage/Documentaion as of the moment, will provide soon)
Check ApiCode Info and Status (Not in Usage/Documentaion as of the moment, will provide soon)

Planned features

Show Pending or Outgoing SMS
Delete All Pending or Outgoing SMS
Queue a Message (Send a message by queueng)

woenel / itexmo