Set User Presence

Set the user presence status. By default, there are four different statuses available in your workspace:

  • online

  • busy

  • away

  • offline

Setting Default User Presence Status

NameRequires AuthPermissionSetting

UserPresence:setDefaultStatus

Yes

Payload Parameters

ArgumentExampleRequiredDescription

status

online

Required

The user presence status to be set as default.

Example Call

{
    "msg": "method",
    "method": "UserPresence:setDefaultStatus",
    "id": "42",
    "params": [ "online" ]
}

Example Response

{
    "msg": "result",
    "id": "42",
    "result": true
}

Setting Temporary User Presence Status

To set a temporary status, send a request to UserPresence:{status} with empty parameters. It only accepts either of these two status options: away and online. It is particularly useful when the client detects that the user is currently not actively using the application (thus "away") and when the user returns, indicating they are "online" again.

NameRequires AuthPermissionSetting

UserPresence:away

Yes

Example Call

{
    "msg": "method",
    "method": "UserPresence:away",
    "id": "47",
    "params":[]
}

Example Response

{
    "msg": "result",
    "id": "42",
    "result": true
}

Last updated

Rocket.Chat versions receive support for six months after release.