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

Payload Parameters

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.

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.