Contents | Search

Mobile message type specification - Message waiting indication SMS
(SMS message type, SMS message format)

Introduction

You can use this message type to notify the recipient about the arrival of a voice mail, a fax, an e-mail or a video message. The respective icon will be displayed on the recipient's phone. This icon can also be deleted using a message of this type.

Why it is convenient

If you run a mobile phone network, you can use this message type, for example, to notify a customer that someone has left them a message in their voicemail box (then, the voicemail icon will show up on the display of their phone). Later, when the customer has listened to their message, the icon can be removed using a voicemail indication message with the action="CLEAR" setting.

Message type

For voice mail: SMS:INDICATION:VOICEMAIL
For e-mail: SMS:INDICATION:EMAIL
For fax: SMS:INDICATION:FAX
For video: SMS:INDICATION:VIDEO

If they are combined: SMS:INDICATION:COMBINED

The format of the message data is:

<Indication action="...">
    <MessageCount>...</MessageCount>
    <MessageText>...</MessageText>
</Indication>

Take a look at an example:

Sending a notification about the arrival of 3 messages (their type is defined
by the message type of the indication SMS):

<Indication action="SET">
    <MessageCount>3</MessageCount>
    <MessageText>You have 3 new messages.</MessageText>
</Indication>

Once you have been notified that the recipient has checked out their messages,
you will send out the message to delete (clear) the icon (from the recipient's
phone):


<Indication action="CLEAR">
    <MessageCount></MessageCount>
    <MessageText></MessageText>
</Indication>

<Indications>
    <Indication action="SET">
        <MessageCount>2</MessageCount>
        <MessageText></MessageText>
    </Indication>
    <Indication action="">
        <MessageCount></MessageCount>
        <MessageText></MessageText>
    </Indication>
    <Indication action="CLEAR">
        <MessageCount>0</MessageCount>
        <MessageText></MessageText>
    </Indication>
    <Indication action="">
        <MessageCount></MessageCount>
        <MessageText>2 new voice mails.</MessageText>
    </Indication>
</Indications>

The first one is for the voice mail, the second for the fax,
the third for the email, and the fourth is for the video. For the
one you do not want to send out, you do not have to write anything, but
you have to include the XML.

SQL example:

E.g., a voice mail indication message:

insert into ozekimessageout (receiver,msgtype,msg,status) values (’+36205222245’,
    ’SMS:INDICATION:VOICEMAIL’,’<Indication action="SET"><MessageCount>3</MessageCount>
                 <MessageText>You have 3 new messages.</MessageText></Indication>’,’send’);

Video indication message:

insert into ozekimessageout (receiver,msgtype,msg,status) values (’+36205222245’,
    ’SMS:INDICATION:VIDEO’,’<Indication action="SET"><MessageCount>3</MessageCount>
                 <MessageText>You have 3 new messages.</MessageText></Indication>’,’send’);

Clear e-mail indication message:

insert into ozekimessageout (receiver,msgtype,msg,status) values (’+36205222245’,
    ’SMS:INDICATION:EMAIL’,’<Indication action="CLEAR"><MessageCount></MessageCount>
                 <MessageText></MessageText></Indication>’,’send’);