# usersStatusesChanged
Description: Notification after a user status has changed.
To regularly update the status of any user, you need to add them to the address book.
Example:
{
"event": "usersStatusesChanged",
"usersStatuses": [
{
"isEditable" : true,
"peerId": "user2@some.server",
"peerDn": "John Doe",
"status": 1,
"extStatus": 4,
"lastOnlineTime": 0,
"additionalStatus": "at lunch"
}
],
"method": "event"
}
Parameter description:
isEditable
— ability to edit contact informationpeerId
— TrueConf ID, unique user identifierpeerDn
— User display namestatus
— User status. It can have one of the following values:-1
— Invalid user0
— Offline user1
— Available user2
— Busy user5
— the user is now taking part in a group conference
extStatus
- the extended user status, which can take one of the following values:-1
— Invalid user0
— Offline user1
- user is offline but was recently active2
— Available user3
- user is available on the phone4
- user is available from the terminal5
- user is available but has set the status to do not disturb6
- user is away7
— Busy user8
- user is busy on the phone9
- user is busy at the terminal10
— A user is in a group conference that they created and that can be joined at request.
lastOnlineTime
- time in Unix format indicating when the user was last available. If the user is currently available, then this parameter is equal to 0additionalStatus
- additional user status as a string
See also: