# On_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
EventHandler<string> On_usersStatusesChanged
Response example
{
"event": "usersStatusesChanged",
"usersStatuses": [
{
"isEditable" : true,
"peerId": "user2@some.server",
"peerDn": "John Doe",
"status": 1,
"extStatus": 4,
"lastOnlineTime": 0,
"additionalStatus": "at lunch"
}
],
"method": "event"
}
Response Parameters
Name | Description |
---|---|
isEditable | Ability to edit contact information |
peerId | TrueConf ID, unique user identifier |
peerDn | User display name |
status | User status. It can have one of the following values: • -1 - Invalid user • 0 - Offline user • 1 - Available user • 2 - Busy user • 5 - 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 user • 0 - Offline user • 1 - User is offline but was recently active • 2 - Available user • 3 - User is available on the phone • 4 - User is available from the terminal • 5 - User is available but has set the status to do not disturb • 6 - User is away • 7 - Busy user • 8 - User is busy on the phone • 9 - User is busy at the terminal • 10 - 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 0 |
additionalStatus | Additional user status as a string |
See also