Video Guide
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
- Sign up new account in here
- Enable SMS API in My Configurations > APIs tab, Whitelist your Server IP in My Configurations > Whitelist IPs tab
- Change your API submission to https://sms.360.my/gw/bulk360/v1.3
- Amend new changes in the API to enjoy the new features
- Contact 360 to migrate your account balance to new platform
Overview of One Way SMS Flow
Below figure shows One Way SMS call flow- Client request send SMS via Bulk360 SMS API [MT].
-
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 - Bulk360 transmit the MT to the recipient's Telco, Acknowledgement and Reference ID return from Telco
- Delivery Notification [DN] return from Telco
- 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 |
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 | Email or Mobile Number not verify, message 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 |
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.