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><Parameters><State name>

 

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

Last edited on September 18th, 2017