SMS API Integration

iSMS Malaysia now offers you to connect to our SMS gateway without any setup fees. By, using our SMS gateway you can automate your bulk text messaging and integrate iSMS service into any website or application using our iSMS API.


Our iSMS API (Application Programming Interface) has been specially designed by our group of innovative team of engineers, to provide a straightforward yet effective, method of integrating websites and software with our messaging platform. Making it perfectly suitable for both small and large corporate information systems.


In order to use iSMS API to send mass SMS, you have to initiate a HTTPS request (POST/GET method).


SMS API Quick Links

API Link Reference Description Code Example
URL Encode - -
Send SMS Send SMS via HTTPS
Server Response Return Values :- Upon message submission, iSMS's server platform will provide the user with a corresponding response value for each message. Server Response
Check Balance Check SMS Account's Balance
SMS Scheduler Set your SMS scheduler with HTTPS API

iSMS API - Send SMS

Parameter Details Example
*un Username of iSMS account isms
*pwd Password of iSMS account isms123
dstno Mobile number that you wish to send a message
(Append 00 for international numbers).
6012xxxxxxxx
*msg The message body (MAX limit : 700 char) Hi, John. How r u?
type Type of SMS
1 - ASCII (English, Bahasa Melayu, etc)
2 - Unicode (Chinese, Japanese, etc)
1
*agreedterm Agreed iSMS Term and Condition below:
https://www.isms.com.my/user-agreement.php
,API will filter your sms if you do not agreed with the agreement.
YES
*sendid
(Optional)
Sender ID to be displayed on recipient's mobile phone.
(Please notice that Malaysia Prefix does not support Sender ID)
61000
* MUST URL EncodedHTTP Response Result


*** We STRONGLY recommend our client set all the mirror link below into system to ensure high availablity.


Send SMS API via HTTPS:
https://www.isms.com.my/isms_send.php
Send SMS API via HTTPS(mirror 1):
https://ww2.isms.com.my/isms_send.php


Send SMS API via HTTPS(mirror 2):
https://www.vocotext.com/isms_send.php
Send SMS by Phone Number to Single Recipient via HTTPS:
https://www.isms.com.my/isms_send.php?un=isms&pwd=isms&dstno=60123456789&msg=Hello%20World&type=1&sendid=12345


Send SMS by Group ID via HTTPS:
https://www.isms.com.my/api_send_sms_by_group.php?un=isms&pwd=isms123&groupid=12345&msg=Hello%20World&type=1&sendid=12345
Send SMS by Recipient Name via HTTPS:
https://www.isms.com.my/api_send_sms_by_name.php?un=isms&pwd=isms&name=contact1&msg=Hello%20World&type=1



Multiple Recipient

Separate each recipient with semi-colon(;) maximum 300 number per push


Send SMS by Phone Number to Multiple Recipient via HTTPS:
https://www.isms.com.my/isms_send.php?un=isms&pwd=isms&dstno=60123456789;601254888999;6044478955&msg=Hello%20World&type=1&sendid=12345


Contact List

Get Contact List Group via HTTPS:
https://www.isms.com.my/api_list_of_contact_group.php?un=isms&pwd=isms123
Get Contact List Based on the Group ID via HTTPS:
https://www.isms.com.my/api_list_of_contact.php?un=isms&pwd=isms123&groupid=12345


Get All Contact List from Phone Book via HTTPS:
https://www.isms.com.my/api_list_of_contact.php?un=isms&pwd=isms123


Contact Group

Create New Group via HTTPS:
https://www.isms.com.my/api_add_contact_group.php?un=isms&pwd=isms123&name=group1
Update Group Name via HTTPS:
https://www.isms.com.my/api_edit_contact_group.php?un=isms&pwd=isms&name=mygroup&groupid=98765


Delete Group via HTTPS:
https://www.isms.com.my/api_delete_contact_group.php?un=isms&pwd=isms&groupid=98765


Server Response

Return Values :- Upon message submission, iSMS's server platform will provide the user with a corresponding response value for each message.

Error Code Error Description Details
2000 = SUCCESS or EMPTY/BLANK SUCCESS Message Sent.
-1000 UNKNOWN ERROR Unknown error. Please contact the administrator.
-1001 AUTHENTICATION FAILED Your username or password are incorrect.
-1002 ACCOUNT SUSPENDED / EXPIRED Your account has been expired or suspended.
Please contact the administrator.
-1003 IP NOT ALLOWED Your IP is not allowed to send SMS.
Please contact the administrator.
-1004 INSUFFICIENT CREDITS You have run out of credits.
Please reload your credits.
-1005 INVALID SMS TYPE Your SMS type is not supported.
-1006 INVALID BODY LENGTH (1-900) Your SMS body has exceed the length.
Max limit = 900
-1007 INVALID HEX BODY Your Hex body format is wrong.
-1008 MISSING PARAMETER One or more required parameters are missing.
     


API for Checking SMS Balance

In order to check balance API :-


Parameter Details Example
*un Username of iSMS account isms
*pwd Password of iSMS account isms123

https://www.isms.com.my/isms_balance.php?un=isms&pwd=isms123 Check Balance via HTTPS:
https://www.isms.com.my/isms_balance.php?un=isms&pwd=isms123



API for SMS Task Scheduler

List All Task Schedule via HTTPS:
https://www.isms.com.my/api_list_of_schedule.php?un=isms&pwd=isms123
Create New Task Schedule via HTTPS:
https://www.isms.com.my/isms_scheduler.php?un=isms&pwd=isms123&dstno=60123456789&msg=Hello%20World&det=Task1&tr=onetime&type=1&sendid=12345&date=2019-05-22&hour=08&min=15&week=1&month=1&day=1



System will return Scheduler ID after success.(Scheduler ID will use to Update and Delete)

Parameter Description Sample
*un Your iSMS Username isms
*pwd Your iSMS Password isms
*dstno Destination Number 60121234567,60191234567
*msg Message Hello ISMS
*det Task Description TEST
*tr Trigger(onetime, daily, weekly, monthly) onetime
*type 1 or 2 (1 = normal, 2 = unicode) 1
*sendid Sender ID isms
*date Start Date (YYYY-MM-DD) 2019-05-22
*hour Hour (00 - 23) 08
*min Minute (00, 15, 30, 45) 15
*week Day of week (1 - 7) 1
*month Month (1 - 12) 1
*day Day of month (1 - 31) 1


Update Task Schedule via HTTPS:
https://www.isms.com.my/isms_scheduler.php?un=isms&pwd=isms123&dstno=60123456789&msg=Hello%20World&det=My%2Task&tr=onetime&type=1&sendid=12345&date=2019-05-22&hour=08&min=15&week=1&month=1&day=1&scid=98765&action=update

Parameter Description Sample
*un Your iSMS Username isms
*pwd Your iSMS Password isms
*dstno Destination Number 60121234567,60191234567
*msg Message Hello ISMS
*det Task Description TEST
*tr Trigger(onetime, daily, weekly, monthly) onetime
*type 1 or 2 (1 = normal, 2 = unicode) 1
*sendid Sender ID isms
*date Start Date (YYYY-MM-DD) 2019-05-22
*hour Hour (00 - 23) 08
*min Minute (00, 15, 30, 45) 15
*week Day of week (1 - 7) Monday - Sunday 1
*month Month (1 - 12) 1
*day Day of month (1 - 31) 1
*scid Scheduler ID 123456
*action Action Parameter update


Delete Task Schedule via HTTPS:
https://www.isms.com.my/isms_scheduler.php?un=isms&pwd=isms123&scid=98765&action=delete

Parameter Description Sample
*un Your iSMS Username isms
*pwd Your iSMS Password isms
*scid Scheduler ID - return value from create new task scheduler 123456
*action Action Parameter delete


URL Encoding Reference

ASCII Character Description URL-encoding Remark
NUL null character %00  
CR carriage return %0D For Break Line used

Security

Bulk SMS Malaysia provides secure messaging using SSL encryption technology.


 

SMS Coverage for All Countries Worldwide

A B C D E F G H I J K L M N O P Q R S T U V Y Z
divider