Determine the current presence status for a list of users

Facts

Works with

RTM

Write-only event

Ask the message server about the current presence status for the specified list of users.

Instead of receiving this event type, your app must post it into the websocket. Present an array labeled ids containing all of the user IDs you want presence status for, up to 500.

To use this event, you'll need to first connect with rtm.connect or rtm.start.

For instance, to query presence status for users U123456 and W123456, present JSON like so:

{
    "type": "presence_query",
    "ids": [
        "U061F7AUR",
        "W123456"
    ]
}

In response, you'll receive singular or batch presence_change events declaring the current presence status of each queried user ID.

{
    "type": "presence_change",
    "presence": "active",
    "user": "U061F7AUR"
}
{
    "type": "presence_change",
    "presence": "away",
    "user": "W123456"
}

presence_query is rate limited.

See presence for more information.

To subscribe to presence_change events, use presence_sub.

When an event occurs, we will send an HTTP POST request to your Request URL. The outer payload is uniform across all Events API methods, and contains fields like team_id and event. Learn more