Introduction to SMS Message Indication

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>

If you want to send out several indication messages in 1 SMS message, the XML will look like this:
<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:

If you use the Database user to send and receive SMS messages with Ozeki NG - SMS Gateway, you can use the following SQL statement to send a Special SMS Message Indication message:
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');

More information