...back                                   InteractiveStars.com Content Services

SMS Horoscope integration FAQ

Integrating our SMS horoscope xml content feeds is easy.

The information below is based on our preferred methods of integration. We can also integrate using your API / DTD.

Frequently Asked Questions:

1. What data do you require to calculate a SMS horoscope?
2. What other information do you require from us?
3. How do you format your SMS content?
4. How do we test this system?
5. I still have some questions to ask regarding Integration.

1. What data do you require to calculate a SMS horoscope?

A: To be able to calculate any daily horoscope you must *always* pass in the request:

dob = the users date of birth
msisdn = the mobile phone number OR any userID you want to use.

An example of a single daily SMS horoscope request via a SMS Pull / HTTP Get:

http://www.interactivestars.com/SMS/COMPANY/YourCompany.asp?&msisdn=user000123&dob=29.06.1969

We then return the horoscope xml - see below for xml example

In the above SMS Pull request you can also add other parameters to control what we pass back.

For example, you can add the 'dof' (date of horoscope forecast) parameter to request a SMS horoscope for any day in the future.

Here is an example for a horoscope for New Years Eve 2005 for the date of birth 29.06.1969:

...same as above.../Company.asp?&msisdn=user000123&dob=29.06.1969&dof=31.12.2005

You can also request a SMS horoscope in non-English languages by using the
'lng' (horoscope language) parameter.

Here is an example for a Spanish horoscope (lng=esp) for the date of birth 29.06.1969:

...same as above.../Company.asp?&msisdn=user000123&dob=29.06.1969&lng=esp

Please contact us for a full list of parameters you can add to your SMS horoscope request.

All the above can also be done using 'SMS Push' instead of 'SMS Pull'.

For SMS Push - you simply upload the each horoscope subscribers data and we Push each days xml SMS horoscopes to your SMS gateway at a set time each morning.

Example to add a subscriber:

http://www.interactivestars.com/SMS/COMPANY/?action=register&msisdn=user0001232&dob=29.06.1969

To delete a subscriber from our system you make the request:

http://www.interactivestars.com/SMS/COMPANY/?action=cancel&msisdn=user0001232&dob=29.06.1969

Please refer to your SMS horoscope service url page for a full list of options.

2. What other information do you require from us?

A: Before you can start to receive our daily SMS horoscopes we require from you:

For SMS Pull:
Nothing. Simply request each SMS horoscope whenever you want !

For SMS Push:
1. Your POST back url where we Post our horoscope xml packets to:

example - SMS SERVER = http://www.Company.com/SMS/test/sms.asp

2. When you are ready for testing, we need back a response such as "ok" included in your SMS server response to verify a successful SMS xml packet delivery.

example:

strOK = "OK"
OR
strOK = "SMS DELIVERED"

3. Firewall's/Proxies:

Firewall's/Proxies must be open for our IP-address space:

from 83.137.66.241 to 83.137.66.246

3. How do you format your SMS content?

SMS formatting:

A:We are flexible in how we present our SMS content to your server. We need to discuss with you your exact requirements.

For SMS Pull:
Example response:

<?xml version="1.0" ?>
<astro>
  <content-response>
  <content>You have a real sixth sense for how to handle others now. Go out and socialise. You    could meet someone who can help you get ahead.</content>
   </content-response>
</astro>

For SMS Push:
We can send back each SMS horoscope in a XML document according to your API / DTD.

4. How do we test this system?

A: Please contact us when you are ready to test and we will set this up with you. You can also start testing by using a SMS Pull request and other options on your service url page.

5. I still have some questions to ask regarding Integration.

A: No problem !

Please do not hesitate to contact us at anytime - we are here to help.

...back