Curl
Shell-Program to do HTTP(s) POSTS and GET operations. The newest release can be downloaded from
http://freshmeat.net/projects/curl/.
senddemo.sh
Sends messages in demomode. Use this script to test your applications. Acts like sendsms.sh but will not send any SMS to the network.
Start the program with the following options:
./senddemo.sh account password destnumber "message" [origin]
account = Assigned username
password = Assigned password
destnumber = Destination number (004179.. )
message = "Messagetext 1 2 3" (max 160 characters)
Origin (optional) = Sender-ID (Can be alphanumerical up to 11 chars)
The server responds with:
01 SENT TESTMODE (TESTMODE would be MESSAGEID in real-mode)
11 SYNTAX ERROR (Rejected by provider)
90 INVALID ACCOUNT
91 INVALID PASSWORD
92 INVALID PARAMETERS
93 NO AMOUNT LEFT
94 UNTRUSTED HOST
95 INVALID DESTINATION NUMBER
sendsms.sh
Sends messages in real-mode.
Start the program with the following options:
./sendsms.sh account password destnumber "message" [origin]
account = Assigned username
password = Assigned password
destnumber = Destination number (004179.. )
message = "Messagetext 1 2 3" (max 160 characters)
Origin (optional) = Sender-ID (Can be alphanumerical up to 11 chars)
The server responds with:
01 SENT YYMMDDHHMMSS (YYMMDDHHMMSS = MESSAGEID)
11 SYNTAX ERROR (Rejected by provider)
90 INVALID ACCOUNT
91 INVALID PASSWORD
92 INVALID PARAMETERS
93 NO AMOUNT LEFT
94 UNTRUSTED HOST
95 INVALID DESTINATION NUMBER
Take advantage of the "MESSAGEID" to track your messages with tracksms.sh.
You may extend sendsms.sh with the option FLASH=ON. Messages with this option will be sent directly to the screen of the mobile phone.
tracksms.sh
Tracks messages and returns the delivery-status.
Start the program with the following options:
./tracksms.sh account password messageid [number]
account = Assigned username
password = Assigned password
messageid = YYMMDDHHMMSS (Messageid according to sendsms.sh)
Should you run a heavely loaded application it might be, that multiple messages carry the same messageid (if they have been sent exactly the same minute, same second.) For this occasion you may additonally specify the destination number. Both MESSAGEID and NUMBER must then match for tracking!
number (optional) = 004179..
The server responds with:
---
01 STATUS:"DELIVERED" [lf]
NUMBER:"004179..." [lf]
TIMESTAMP:"DD.MM.YYYY HH:MM:SS" [lf]
DESCRIPTION:"Message for 079..., with identification YYMMDDHHMMSS
has been delivered on YYYY-MM-DD at HH:MM:SS."
---
02 MESSAGEID NOT FOUND
90 INVALID ACCOUNT
91 INVALID PASSWORD
94 UNTRUSTED HOST
credits.sh
Displays remaining credits.
Start the program with the following options:
./credits.sh account password
account = Assigned username
password = Assigned password
The server responds with:
01 1234 (where 1234 are the remaining credits)
90 INVALID ACCOUNT
91 INVALID PASSWORD
94 UNTRUSTED HOST
What about security?
All our scripts will open a HTTPS connection as default. Account-Names and passwords will therefore be encrypted at 128bit SSL.
Should you want to switch to our non-secure server (for possible speed improvement on slow-links), adjust the script as follows:
Replace the line https://secure.simmcomm.ch/cgi-bin/smsgateway.cgi
with the line http://www.truesenses.com/cgi-bin/smsgateway.cgi.
Attention: WE DO NOT TAKE RESPONSIBILITY if someone fetches (sniffes) your Account-Name/Password during your transmission!
Always use SSL transmission if possible!
The ACCOUNT field matches your Account-Name