# 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 information

  • peerIdTrueConf 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: