TITBITS URL Integration
for Data collection and return of a unique response
Titbits can automatically fetch your service information
This is an example of the URL of your data that you enter in the Titbits control panel:
http://myserver.com/titbits/incoming.cgi
Titbits appends the following info to the arriving SMS when it sends the HTTP GET request to your server:
param = smstext e.g. "ODO 10000"
uniqid = unique id (to help ignore duplicates)
msisdn = cell number e.g. 27831234567
The Titbits server replies to your server with a HTTP GET request -
Example GET
http://myserver.com/titbits/incoming.cgi¶m=ODO%2010000&uniqid=jwfi3j2ifj32&msisdn=27831234567
and
http://abcdefg.co.za/titbits.aspx?pw=xyz361847&shortcode=34010¶m=CASH&uniqid=12892156234cd7de8735f39&msisdn=27839871234
Your ReplySMS to the cgi will be in the body of the webpage i.e. the body of the response from the HTTP GET request.
This must contain the reply info in our (psuedo) XML format.
| < |
sms> |
|
| < |
smstext> |
|
|
Hello and thank you for your enquiry ....etc ...
|
|
| < |
smstext> |
|
| < |
/sms> |
|
- To deliver info from an existing Titbits URL service - go to "Parse URL" option and enter COPY:Surfa in the box.
- To deliver info from a webpage - go to "Parse URL" option and enter the URL for the infopage in the box. You will need to setup the info, to be fetched, in a special way.
Here is an example for a daily temperature report:
| < |
sms> |
|
| < |
var name="id"value="1043244000"> |
|
| < |
var name="temperature" value="16.4"> |
|
| < |
smstext> |
|
|
Today's Temperature: 16.4 degC |
|
| < |
smstext> |
|
| < |
/sms> |
|
This Displays as
Today's Temperature: 16.4 degC
The id variable is used to test if the information has been updated since the last posting or not. This must be unique.
This example has one attribute, called temperature. If you define this attribute in your service setup, then your subscribers will be able to set up filters based on this information.
Example of STATIC INFO
This is how we can collect the info from Newmetals.co.za
They make the text file available on their server - using this url
www.newmetals.co.za/titbits.txt
Create the data in the file as per below example between our (psuedo) XML tags
You can do this manually on a daily basis or have a script to update the info every hour.
| < |
sms> |
|
| < |
smstext> |
|
|
www.newmetals.co.za
011-799-1234
10 Aug 2010 9am
Cr R15-63
Mn R15-63
Fe R15-63
Ni R15-63
Cu R15-63
Sn R15-63
Pb R15-63
Zn R15-63
|
|
| < |
/smstext> |
|
| < |
/sms> |
|
We will poll your server every 5 mins and collect the data in the file.
SMS is a maximum of 160 characters.
When the public SMS the code BASE to 35010 we deliver this info.
Please us for more information on ParseURL.
