Error Codes:
1701: Success, Message Submitted Successfully, In this case you will receive
the response 1701|<CELL_NO>|<MESSAGE ID>, The message Id can
then be used later to map the delivery reports to this message.
1702: Invalid URL Error, This means that one of the parameters was not
provided or left blank
1703: Invalid value in username or password field
1704: Invalid value in "type" field
1705: Invalid Message
1706: Invalid Destination
1707: Invalid Source (Sender)
1708: Invalid value for "dlr" field
1709: User validation failed
1710: Internal Error
1715: Response timeout
Note:-
● Along with the above errors codes, standard SMPP v3.4 error codes may also
be returned where applicable.
● Apart from 1709, Please DO NOT RETRY re-sending the message for
any other error code (including SMPP v3.4 Error codes ).
● For 1715,Do not re-submit the same message back again.
ACKED= Message submitted to SMSC end - Messages processed by our system to partner operator and waiting for delivery reports from them.
Delivered= Delivered to handset - Successfully delivered to handset.
EXPIRED=Absent subscriber/ retry time over - Message failed to deliver to handset due to expiration of Validity Period of message, this can be due to handset/network related issue.
UNDELIVERED=call barred/invalid number - Failed to deliver to handset.
API Details for Resellers
Parameters
No Field Name Example Value Description
1 user * Cliqsms The login name for you SMS account
2 password * 123456 The login password for your SMS account
3 mobile * 9999999999 The target mobile numbers separated with Comma
4 senderid * Cliqsms The sender name that will show as from address
5 message * Hello world The actual text message to send to the target mobile number
6 schedule 2016:01:31:14:20:10 This is to schedule the SMS in future date. The format should be yyyy:mm:dd:hh:mm:ss
7 unicode 1 or 2 This is used for send Unicode sms via SMS HTTP API.
Unicode = 1 (You can directly send the Unicode characters).
Unicode = 2 (You can send Unicode converted as hex)
8 group_id 1,2,3 Account holder Group id in Cliqsmssms.* are mandatory
Example [Sending to Mobile(s)]
http://cliqsms.com.ng/sendsms.php?user=xxx&password=yyy&mobile=9444XXXXXXX,9044XXXXXXX&senderid=Cliqsms&message=hello&unicode=1&schedule=yyyy:mm:dd:hh:mm:ss
Example [Sending to Group(s)]
http://cliqsms.com.ng/sendsms.php?user=xxx&password=yyy&group_id=1,2&senderid=Cliqsms&message=hello&unicode=1&schedule=yyyy:mm:dd:hh:mm:ss
Response Codes
1111:SUCCESS:SMS Submitted Successfully. (mobilecount=x, creditsused=y)
When all the mobile numbers are accepted for delivery.
1112:SUCCESS:SMS Submitted Successfully. (mobilecount=x, creditsused=y, failedcount=z)
When there are few numbers which are not accepted for delivery
1113:SUCCESS:SMS Scheduled Successfully
1001:ERROR:Invalid URL. User cannot be empty
1001:ERROR:Invalid URL. Password cannot be empty
1001:ERROR:Invalid URL. Mobile or Group id cannot be empty
1001:ERROR:Invalid URL. Message cannot be empty
1005:ERROR:Invalid value in username or password field
1030:ERROR:Account doesn't exist
1010:ERROR:Account expired
1015:ERROR:Your credits are Low
1020:ERROR:Invalid Sender
1032:ERROR:Do Not Disturb (DND) Number
1040:ERROR:You are not allowed to send Unicode Messages
1050:ERROR:Character count is greater than X
1060:ERROR:Invalid Group id Specified
1070:ERROR:Invalid schedule time
1080:ERROR:Unable to schedule message
1090:ERROR:Unable to send message
1100:ERROR:Message has been waitlisted (mobilecount=x)
