download
Article

horoscope: a use case to illustrate how to create a plus SMS campaign (also called premium SMS campaign)

27 August 2010 17:44

horoscope-thumb-100x157-3950.gif

After testing the sending of SMS messages in mass, I suggest you test the receiveSMS method with a use case for which we have provided detailed code which we have developed with you in mind.


What is the receiveSMS method?

 

It is the answer you have been waiting for.  The receiveSMS method allows your application to receive an SMS sent from anywhere in the world.

To use the receiveSMS method your need to configure the SMS API in the personal area section of the orange api website and provide the users of your application with the short code which the will use when sending SMS to your application.

 

 

Why use the receiveSMS method?

 

To interact with your present and prospective customers.

According to the mobile marketing guide of the Association of French Mobile Multimedia (AFMM) 21% of mobile customers (33% of mobile users) have sent an SMS to access a service.

Of this 33%, 21% does this at least once a week.

It is important to act now as these figures show that we must act now as these users (SMS+, MMS+) are an increasing important source of revenue.

 

With SMS+ you can:

1.       announce:  promotions, alerts, etc...

2.       inform:  of the delivery of content, and services

3.       interact:  surveys, competitions, etc.

Let your creative side loose and discover ways to communicate and interact with your existing and prospective customers.

 

In this tutorial, we consider a use case which we call:  Inform or deliver the daily Horoscope using Premium SMS+.  We aim to show you just how simple the receiveSMS method is to use.

 

Here are the steps:

 

1.       log into the orange api website (it is necessary to register to use our API)

2.       set your keyword (up to 5) which will allow us to redirect the SMS sent to your application

3.       set your reception method:  email or URL (script) or both

4.       download, unzip the file and open the PHP file (

receiveSMS_horoscope.zip

) for this tutorial

5.       load the file on your web server

6.       specify the URL for this in your personal space> my API> configure my API> SMS API

7.       the web application launches

8.       test:  send your keyword and your astrological sign to 51244* or 71244**

9.       receive the first 160 characters*** of the daily horoscope for that star sign

 

In this example we have look at an example of the premium SMS+ using short codes to demonstrate how this works in its entirety.  When using premium rate short codes (51244, 71244), a response from the application is mandatory once the SMS sent is received.  It is good practice to always encode a response as part of the way your application works.  We have done this in this example; see the php file.  This obligation is imposed as it is possible to be rewarded when using the premium short codes.

 

 

3 points to remember:

 

download the file to your server and set the URL pointing to it in your personal space on the orange api website
provide users of the application the short codes to use when sending SMS to you

create application responses.  This is necessary in order to be rewarded when you application is used.

 

 

The use case would be for example:

 

            "Your HOROSCOPE by SMS.  First thought every morning would be to send to HOROS to 51244"

           You can trace the API calls on the orange api website (api.orange.com) in your personal space and then going to the activity report section.

            And of course, if you encounter difficulties we have a technical team ready to assist and guide you.

            So feel free to ask questions

 

* premium rate number.  Multi mobile operator coverage in France.  Cost:  €0.20 per SMS

**  premium rate number.  Multi mobile operator coverage in France.  Cost:  €0.20 per SMS + €0.50

*** SMS message limited to 160 characters (including the key word)


 

 

Soraya, orange api Community Manager