On_usersStatusesChanged

TrueConf7/5/26About 2 min

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