Raw Mobility | Bulk SMS Starts Here

HTTP GET / CURL

The HTTP GET API allows you to quickly and easily send messages from any application.

URL

http://apps.rawmobility.com/gateway/api/simple/MT

Parameters

Parameter	Mandatory	Description
USER_NAME	YES	Username used to login to the system
PASSWORD	YES	Password used to login to the system
ORIGINATOR	YES	Originator / Sender of the message. Valid originator strings are: MSISDN originators: i.e. numbers starting with 614xxxxxxxx Alphanumerics originators: Up to 11 characters, where at least one of the 11 must be a letter (Alpha)
RECIPIENT	YES	Phone number of the recipient (mobile phone) in international format (MSISDN). You can also specify a comma-separated list of mobile numbers. Examples: 61499123456 61499123000,61499123111,61499123222
MESSAGE_TEXT	YES	The SMS message to be delivered to the recipient. Make sure youURL Encode this text to ensure accurate interpretation of the message.
ROUTE	YES	UUID which identifies the route used for delivering the message. Each route allows access to different countries and at different p!rice points. You can use the following link to get your Route Id: http://reports.rawmobility.com/run?__report=routes
REFERENCE	No	Client reference, sent back to client with delivery receipts and used for correlation

Important notes

URL parameters must be URL (form) encoded
To send unicode messages, make sure you add the following header:
Content-Type: application/x-www-form-urlencoded; charset=UTF-8

Example

http://apps.rawmobility.com/gateway/api/simple/MT?USER_NAME=login&PASSWORD =demo&ORIGINATOR=test&RECIPIENT=61400000111&ROUTE =ab7c4a51-c48a-4ee4-12345&MESSAGE_TEXT=hello+there&REFERENCE=my-ref

PHP Client Library

The PHP library wraps our XML API and makes it even easier to get started with PHP. We offer a set of simple classes (no prerequisites or dependencies) to manage the interaction with our platrform.

Sample Code:

Send SMS to single recipient
Get Route ID
Send same message to multiple recipients
Send multiple messages to multiple recipients
Receive SMS
Receive Receipt

Single Recipient

require_once("bulksms/BulkSMS.php");
$bulksms = new Blender\Client\BulkSMS();
$bulksms->login($USERNAME, $PASSWORD);
                            
$response = $bulksms->singleRecipient("originator", "61400000000", "Test SMS", $ROUTE_ID, "my-reference");

Get Route ID

require_once("bulksms/BulkSMS.php");
$bulksms = new Blender\Client\BulkSMS();
$bulksms->login($USERNAME, $PASSWORD);

$ROUTE_ID = $bulksms->getRouteIdByCountry("Australia");

Send same message to multiple recipients

require_once("bulksms/BulkSMS.php");
$bulksms = new Blender\Client\BulkSMS();
$bulksms->login($USERNAME, $PASSWORD);

$batch = new Blender\Client\BatchMessageSingleBody();

# Set details for all recipients                            
$batch->setOriginator("test");
$batch->setRouteId($ROUTE_ID);
$batch->setBody("Batch unicode message with 漢語");

# Add Recipients 
$batch->addMSISDN("61000000001");
$batch->addMSISDN("61000000002");
$batch->addMSISDN("61000000003");

# Send message
$responseXml = $bulksms->sendBatch($batch);

Send multiple messages to multiple recipients

require_once("bulksms/BulkSMS.php");
$bulksms = new Blender\Client\BulkSMS();
$bulksms->login($USERNAME, $PASSWORD);
                            
$batch = new Blender\Client\BatchMessageMultiBody();

# Set default values (you can override per recipient)
$batch->setOriginator("test");
$batch->setRouteId($ROUTE_ID);
$batch->setBody("Batch unicode message with 漢語");

# Add Recipients
$batch->addRecipient1("61000000001");
$batch->addRecipient2("61000000002", "different message");
$batch->addRecipient2("61000000003", "different message with unicode טוקיו 東京(Tokyo)");
$longtext = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse auctor turpis at nunc rutrum, eget sodales turpis molestie. Nullam mattis sit amet urna et tristique. Vivamus nec justo et dui sed. 200+ chars";
$batch->addRecipient("orignew", "61000000004", $longtext);

# Send message
$responseXml = $bulksms->sendBatch($batch);

Receive SMS

require_once(dirname(__FILE__) . "/bulksms/DeliveryMessage.php");
$xml = $_POST['xml'];
$incomingMessage = new Blender\Client\DeliveryMessage($xml);
$originator = $incomingMessage->getOriginator();
$body = $incomingMessage->getBody();

Receive Receipt

require_once(dirname(__FILE__) . "/bulksms/DeliveryReceipt.php");
$xml = $_POST['xml'];
$receipt = new Blender\Client\DeliveryReceipt($xml);
$myref = $receipt->getClientReference();
$status = $receipt->getStatus();

SMPP Server

The Short Message Peer-to-Peer (SMPP) in the telecommunications industry is an open, industry standard protocol designed to provide a flexible data communication interface for the transfer of short message data.

For SMPP credentials and server details, please contact us and our support team would be happy to help.

Supported Features

Feature	Supported
Delivery Receipt	YES
7Bit SMS (standard port)	YES
7Bit SMS ( non-standard port)	NO
Concatenated 7Bit SMS	YES
UCS2 (16-Bits Unicode) SMS	YES
Concatenated UCS2 SMS	YES
8-Bits binaries SMS	NO
Concatenated binaries SMS	NO
Alert/Flash SMS	NO
Alphabetic Originating Address	YES
Numeric Originating Address	YES
Validity Period	NO

Supported TLVs

Description	Tag	Type	Usage
dest_subaddress	0x0203	OCTET	Specify Route Id for message

C# Setup

String url = "http://apps.rawmobility.com/gateway/ws/sendsms";
String routeId = "routeid-routeid-routeid";
String username = "USER_NAME";
String password = "PASS_WORD";
SendSMSService sendSms = new SendSMSService (url);

C# Send to Single Recipient

batchMessageMultiBody sendResult = sendSms.sendSms (username, password, "Test", "61000000000", "Hello this is a test", routeId);
String remoteId = sendResult.recipients [0].id;
Console.WriteLine ("Singlel SMS Sent, ID: " + remoteId);

C# Send to Multiple Recipients

// Create batch object, set default data
batchMessageMultiBody batch = new batchMessageMultiBody ();
// Request detailed response (ID per recipient)
batch.detailedResponse = true;
// Default route ids
batch.routeId = routeId;
// Default originator. Can be overridden in each recipient
batch.originator = "Default";
// Default body. Can be overridden in each recipient
batch.body = "Defulat Body";
// Schedule Time
batch.deliverySchedule = DateTime.Parse ("2015-09-16T13:49:00");
// Set to true for optional property
batch.deliveryScheduleSpecified = true;
// Schedule Timezone
batch.deliveryTimeZone = "Australia/Melbourne";
// Spread messages over XX hours
batch.messageSpread = 0;

// Create array of two recipients
batch.recipients = new batchRecipientMultiBody[2];

// Add first recipient
batchRecipientMultiBody recipient = new batchRecipientMultiBody ();
recipient.recipient = "61000000001";
batch.recipients [0] = recipient;

// Add second recipient
recipient = new batchRecipientMultiBody ();
// Override originator
recipient.originator = "Orig2";
recipient.recipient = "61000000002";
// Override body
recipient.body = "Test Message";
// Set reference
recipient.reference = "MyRef123";
batch.recipients [1] = recipient;

try {
    // Send message
    batchMessageMultiBody batchResult = sendSms.sendBatchMulti (username, password, batch);
    // Loop over result recipients and retrieve remote id
    foreach(batchRecipientMultiBody recipientResult in batchResult.recipients) {
        Console.WriteLine ("SMS To: " + recipientResult.recipient + ", ID: " + recipientResult.id);
    }
} catch (Exception e) {
    Console.WriteLine ("Error: " + e.Message);
}

XML API

The XML API allows customers to Send and Receive messages, in addition to controlling other system aspects

Available API's

Contact Management
Mailing List Management
Optouts Management
Send Batch Messages
Submit HLR Requests
Receive Delivery Receipts
Receive Incoming Messages
Routes and Pricing

Sample code for PHP, Java and C# can be found in the main API section.

Important notes

User-Agent header must be set for every API call
XML content (e.g. message body) must be either encoded according to syntax rules or embeded in a CDATA section
The XML itself must be URL (form) Encoded before POSTing
To send unicode messages, make sure you add the following header:
Content-Type: application/x-www-form-urlencoded; charset=UTF-8

Features

Worldwide Coverage

Message Scheduling

Link/URL Shortener

Message Spread

Reseller & Whitelabel

Receive Replies

Keyword Rules

Unicode & Long Messages

Custom Originator

API

CURL / HTTP GET

PHP Client

XML API

Web Service

SMPP

Java Client

Solutions

We provide a wide range of solutions for short messaging services, communications and marketing.

Business Communications

Mobile Marketing

Web Security

Contact Us

Sign up

Features

Worldwide Coverage

Message Scheduling

Link/URL Shortener

Message Spread

Reseller & Whitelabel

Receive Replies

Keyword Rules

Unicode & Long Messages

Custom Originator

API

CURL / HTTP GET

PHP Client

XML API

Web Service

SMPP

Java Client

Solutions

We provide a wide range of solutions for short messaging services, communications and marketing.

Business Communications

Mobile Marketing

Web Security

Contact Us