The SMS Message Features¶

The section explains how to use Totalview 2017’s SMS features. SMS messages can be sent from mobile phones to the Totalview 2017 server, and can be used to set presence and query user information.

The mobile phone used to send SMS messages to the Totalview 2017 server must be registered as a mobile phone of one of the users in Totalview 2017.

Change current presence¶

The following commands can be used to change the current presence of a user. When sending a SMS message, a SMS response is sent back with the current presence.

SMS syntax: <State>:<Duration>:<Forwarding>:<Text>

<State>	The ID of the state that should be used in the new current presence, e.g. In, Busy or Out.
<Duration>	The expected duration of the new current presence. Can be minutes (m), hours (h) or days (d), e.g. 2h30m is 2 hours and 30 minutes. The duration can be omitted if state allows it. If omitted duration is set to one hour.
<Forwarding>	Forwarding is set by using the <Type><Phone Number> setting. If forwarding is omitted the current forwarding is used. <Type> can be E (External calls), I (Internal calls), A (All calls) or N (No forwarding) <Phone Number> is the number to forward to or the special number X. X is the mobile number that sent the SMS to the Totalview 2017 server. E.g. E4000 will forward all external calls to device 4000 while AX will forward all calls to the mobile phone.
<Text>	Text description of the new current presence. Can be omitted if the state allows it.

Examples of SMS messages

SMS message	SMS response	Description
bus:2h:a4000:Status meeting	Tina Townsend Busy fwd: a4000	Current state is set to busy for 2 hours. Forwarding all calls to device 4000.
bus:2h::Meeting	Tina Townsend Busy fwd: none	Current state is set to busy for 2 hours. Current forwarding is used.
pri:45m::Dentist	Tina Townsend Private fwd: none	Current state is set to private for 45 minutes. Current forwarding is used.
Hom	Tina Townsend Home fwd: none	Current state is set to home. Current forwarding is used.
pri:45m:ix:Doctor	Tina Townsend Private fwd: i2233445	Current state is set to private for 45 minutes. Internal calls are forwarded to mobile.

Request information about users¶

The following SMS commands can be used to query information about users.

Feature

Command

Response

Get user’s current state

u:<userid>

Example:

u:tt

A list of active States

Example:

Tina Townsend
In
fwd: e4000
(0 today, 1 tomorrow)
In

Get user’s appointments

u:<userid>+

Example:

u:tt+

A list of user’s appointments today and tomorrow

Example:

Tina Townsend
today:
[No Appointments]
tomorrow:
10.00 – 12.00 –
Busy
Meeting preparation

Get user’s appointments for a given day

u:<userid><DDMM>

Example:

u:tt1706

A list of user’s appointments selected day

Example:

Appointments for user:
Tina Townsend on 31. Jan
08.00 – 08.30 Busy

Get user’s contact information

u:<userid>?

Example:

u:tt?

A list of user’s contacts

Example:

Tina Townsend
Local: 4032
Mobile: 22334455
Home: 66778899

Other SMS message features¶

Feature

Command

Response

Request a list of States

States

Example:

States

A list of active States

State id:

The state to be used when registering

Parameters:

A list of parameters applicable for the state.

Possible parameters are
e : End (duration)
f : Forwarding
t : Text

State name:

The full name of the state

Example:

In (f) In
Hom (f) Home
Bus (eft) Busy in
Mee (eft) Meeting
Din (f) Dinner
Pri (eft) Private
Hol (ef) Holiday

Get Help

Help

Example:

Help

Gives a list of available commands

Example:

New State:
length([<x>d][<x>h][<x>m]):
fwd([n|i|e|a][x|<number>)):
text
Always use : to separate fields

states list states
u:<uid> state
u:<uid>? Details
u:<uid>+ calendar
u:<uid>:<DDMM> calendar
u:<char>..user list