{"id":5036,"date":"2020-07-07T15:01:24","date_gmt":"2020-07-07T22:01:24","guid":{"rendered":"https:\/\/officedevblogs.wpengine.com\/?p=5036"},"modified":"2020-07-07T15:01:24","modified_gmt":"2020-07-07T22:01:24","slug":"get-notified-of-presence-changes-the-microsoft-graph-presence-subscription-api-is-now-available-in-public-preview","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/get-notified-of-presence-changes-the-microsoft-graph-presence-subscription-api-is-now-available-in-public-preview\/","title":{"rendered":"Get notified of presence changes – the Microsoft Graph presence subscription API is now available in public preview"},"content":{"rendered":"

We\u2019re excited to announce that our presence subscription API is now in Microsoft Graph beta! As part of our Cloud communications API set<\/a>, this API is used to subscribe to the Teams presence information of other users. Use webhooks<\/a> to receive notifications when a user\u2019s presence changes.<\/p>\n

This is an alternative<\/strong> to polling for presence by using the GET presence<\/a> and POST getPresencesByUserId<\/a> APIs.<\/p>\n

This API uses the Presence.Read.All delegated permission. A signed-in user is required. Follow these steps to set up a webhook<\/a> and retrieve these notifications:<\/p>\n

    \n
  1. Subscribe to a single user’s presence through the \/communications\/presences\/{id}<\/code> path.<\/li>\n
  2. Subscribe to a maximum number of 650 users by using \/communications\/presences?$filter=id in ({id},{id}...)<\/code>. <\/em>The {id} represents a user ID GUID.<\/li>\n<\/ol>\n

    Subscriptions expire every hour and must be renewed.<\/p>\n

    Presence overview<\/h3>\n

    Presence refers to the status of the user. This information allows users to see which users are active and likely to engage with them. It adds a new level of transparency to how we communicate with each other.<\/p>\n

    The APIs return two key properties that make up presence:<\/p>\n

      \n
    1. The availability<\/strong>, or base presence information (Available, Away, Busy)<\/li>\n
    2. The activity<\/strong>, or information that\u2019s supplemental to the availability (InAMeeting, InACall)<\/li>\n<\/ol>\n

      Note that the availability and activity can be the same value.<\/p>\n

      Sample use cases<\/h3>\n