Receive SMS / Incoming / Pull / MO (Mobile Originated)

Shortcode

Shortcode is four digit number to which user can send SMS from any telecom. Benefits of Shortcodes are:
1. Easy to remember
2. Provides direct connectivity to Telecom
3. Shortcode can have different tarrifs like (Rs. 1-5)

Keyword

First word of SMS sent by user is Keyword, it is used to identify the action / service requested.

Sub Keyword

Second Keyword of SMS sent by user is called Sub Keyword. Its optional and depends upon the campaign

Parameters

Settings


    URL           : Public URL where the incoming SMS has to be forwarded.
    Keyword       : Keyword that has to be forwarded.
    Shortcode     : Shortcode to which, user has to send SMS.
    Default Reply : Default response that has to be sent to user, 
                    incase request to url fail.

Request


    GET request is sent to the URL provided with following arguments:

    from    : Subscribers number sending SMS.
    to      : Shortcode to which subscriber has sent SMS.
    text    : Complete SMS sent by user.
    keyword : Keyword of SMS sent.


Response

URL must process the request and send text response of maximum 160 characters with status code 200 or 202. Incase of any other response code, default reply will be sent to user as SMS reply.

Proceed to examples