SMS – Sending short messages to a phone

Developers – SMS

Do you know that sending an SMS was actually the first API that Speakup offered publicly? Any Speakup user can utilize his/her basic SIP registrar/passport account to send text messages either via an XML API or via a basic webpage. It works like this:

https://service.speakup.nl/msgbroker/?username=[username]&password=[password]&originator=[originator]&recipients=[recipients]&message=[message]

Where:
Username: SIP trunk username
Password: SIP trunk password
Originator: Message sender (any phone number associated with the SIP trunk or 11 character textual)
Recipients: One or more recipients of the message, comma separated
Message: The message (if the message length exceed one SMS it will be split up over multiple SMS messages)

After submitting a message the following result structure is returned:

<?xml version=”1.0″?>
<response>
<item type=”sms”>
<recipients>1</recipients>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Message succesfully sent.</resultmessage>
</item>
</response>

The recipient’s field will return the amount of recipients that we were able to deliver to. Numbers that are not recognized as phone numbers will be filtered out.
The success field will simply indicate if the message was successfully send or not. More elaborate results are given in the resultcode field:
10 – sent successfully
20 – no ‘username’ given
21 – no ‘password’ given
22 – no or invalid ‘originator’ given
23 – no ‘recipients’ given
24 – no ‘message’ given
25 – no valid ‘recipients’ given
26 – no valid ‘originator’ given
27 – no valid ‘message’ given
29 – other parameter faults
30 – incorrect ‘username’ or ‘password’
31 – insufficient credit to send the message
98 – gateway unreachable
99 – unknown error