# 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

Last Updated: 09/12/2025