If you are working on telephone solutions, please check
out the Ozeki VoIP SIP SDK.
It can be used to create VoIP client and server software. |
|
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>
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’);
Next page:
Bookmark
|