Bulk360 SMS API V1.3

Video Guide

Last Update: 11th Oct 2019

Developer Guide

Introduction

360 makes sending and receiving SMS easy. With Bulk360 SMS APIs, an enterprise level SMS Gateway capable to handle millions of transactions daily. Start creating your amazing application and leverage on our Digital Marketing Tools!

This document will cover the following areas of connectivity:

Summary Changes

This version aims to minimize changes for Bulk360 SMS API V1.2 user who wants to migrate from our obsoleted system into this new platform

New features in V1.3:
Enhanced Securty
Only whitelisted IPs can trigger transaction request
Default Subscription
In this new platform, users are capable to send traffic to any country without submitting request to 360
Longer Text
For Malaysia traffic, the new platform embed only 4 characters: 'RM0 ' prefix in the SMS Content. (Compares to the obsoleted system 153 characters,) you can now send up to 156 characters in a single SMS
Concatenated Text
You can now send up to 960 characters long text SMS, and message will deliver to your recipient in 1 long text SMS (vary by Telco)
Unicode Content
You no longer required to incidate sending SMS in Roman Characters or Unicode SMS Content. It's all handled by the new platform
For User in V1.2 Steps to migrate to V1.3:
  1. Sign up new account in here
  2. Enable SMS API in My Configurations > APIs tab, Whitelist your Server IP in My Configurations > Whitelist IPs tab
  3. Change your API submission to https://sms.360.my/gw/bulk360/v1.3
  4. Amend new changes in the API to enjoy the new features
  5. Contact 360 to migrate your account balance to new platform

Overview of One Way SMS Flow

Below figure shows One Way SMS call flow
  1. Client request send SMS via Bulk360 SMS API [MT].
  2. Bulk360 acknowledge upon MT received, and return a Unique Reference ID. The returning values as specified in Delivery Notification.
    Noted that the MT Status here is not final
  3. Bulk360 transmit the MT to the recipient's Telco, Acknowledgement and Reference ID return from Telco
  4. Delivery Notification [DN] return from Telco
  5. Bulk360 return DN with Final Status of the MT Sent, refers to Delivery Notification for returned values.

Sending Normal Text Messages

Our HTTP API is designed for developers with instructions to integrate Bulk360 SMS services into various solutions. This guide will bring you through the process of sending messages by simply submitting your information either a POST or GET form to request to our API.

However, the POST method is recommended as opposed to the GET method due to the limitation of size and exposure of the HTTP request being exposed in the HTTP address bar.

To send SMS, all POST / GET request shall be submitted to following URL:
Actual working example with mandatory parameters:
Below table explanation for all Parameters:
# Parameter Description Mandatory Example
1 user Your registered email shall be used here. Yes mark@360.my
2 pass Your account password, the same password you used registering in the Bulk360 platform. Note that you shall change the password in your API after you change the account password in sms.360.my. Yes pass001
3 type This parameters is not needed in V1.3, however, it won't cause any problem even if you post No 0
4 to Recipient's mobile number in international format (without the "+" sign) Yes 60123240066
5 from The source name of the SMS, it accepts Maximum of 11 alphanumeric characters. [Not applicable in Malaysia] No AEONSales
6 text The SMS content. When sending MT to Malaysia prefix (60) is concerned, the system will auto append “RM0.00 ” at the beginning of the SMS. This will consume 7 characters from the total characters count of the message & credits will be deducted accordingly. Yes Message from Bulk360 Gateway
7 servid The service ID, set as 'Bulk360' No Bulk360
* All parameters shall be encoded in URL format if API triggered via GET Request
Following sample source code in different languages:

The API will return 3 values as specified in HTTP Response.

Sending UNICODE (UCS2) messages (Multi lingual)

You are able to send Unicode SMS such as Chinese, Hindi or Thai with ease. Simply encode your Double Characters content into URL format, and tunning the SMS type to 5.

Actual working example with mandatory parameters:

The API will return 3 values as specified in HTTP Response.

HTTP Response

Upon the Bulk360 SMS API is called, the API will return 3 values:
  • status - The real-time delivery status, refer to following table Response Code
  • msisdn - Recipient mobile number
  • msgid - Reference ID returned by 360
Response Code Description
200 OK
400 Missing parameters or invalid field type
401 Invalid Username or password
402 Insufficient SMS credit
403 SMS API not enabled, requested IP not whitelisted or not enabled
405 Invalid Msg Type
412 Account suspended / Terminated / Not activated
500 Internal server error
DELIVERED Message successfully delivered to the mobile handset
UNDELIVERED Message failed to be delivered to the mobile handset
Example of HTTP response returning:

Delivery Notification (DN)

Delivery Notification is the final status of your SMS sent.

If Delivery Notification is required, please fill in the Delivery Notification Hook located at My Configurations > APIs tab. DNs will then be forwarded to your DN URL in real time in following format:

Three parameters returns as below:
# Parameter Description Example
1 status Real-time DN Status DELIVERED or UNDELIVERED
2 msisdn MT recipient mobile number 60123240066
3 msgid The Reference ID enables client to tie the DN with the MT sent 5515023

Note:
- The total number of DNs returned will be based on the number of SMS broadcasted. E.g.: if a Group of broadcast consists of 10 MSISDNs, there will be 10 DNs returned. If there were more than 1 DN returned for the same SMS (might happen for concatenated SMS), always consider the last DN received as the final DN.
- Depending on Telcos' configuration, retries attempt might be prolonged for 36 to 48 hours if cell phone is unreachable.