Skip to content

Commit 31d5ccd

Browse files
authored
Merge pull request #25383 from microsoftgraph/blee/Update-rich-change-notifications-presence-online-meetings
Updates for information
2 parents c612d39 + 1cf3277 commit 31d5ccd

File tree

3 files changed

+6
-6
lines changed

3 files changed

+6
-6
lines changed

concepts/changenotifications-for-presence.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Change notifications in Microsoft Graph enable you to subscribe to changes in [u
1414
Use webhooks to subscribe to users' presence information and get notifications when changes occur. For general information on webhooks, see [Microsoft Graph API change notifications](/graph/api/resources/change-notifications-api-overview).
1515

1616
> [!NOTE]
17-
> Effective June 30 2024, to get changes that occurred to an active meeting call, we recommend that you subscribe to [rich notifications](#rich-notifications).
17+
> Effective June 30 2024, to get changes that occurred to an active meeting call, we recommend that you subscribe to [rich notifications](#rich-presence-notifications).
1818
1919
## Permissions
2020

@@ -26,7 +26,7 @@ Use webhooks to subscribe to users' presence information and get notifications w
2626

2727
## Supported resources for presence
2828

29-
Subscriptions have a maximum expiration time of an hour. A subscription can be renewed via the [Update subscription API](/graph/api/subscription-update) before it expires, or a new subscription can be created for the same resource after expiration. Presence subscriptions support notifications with resource data, allowing more detailed information to be delivered along with change notifications. For more information, see [Set up change notifications with resource data](change-notifications-with-resource-data.md).
29+
A single user can create one presence subscription per unique application with a maximum expiration time of an hour. A subscription can be renewed via the [Update subscription API](/graph/api/subscription-update) before it expires, or a new subscription can be created for the same resource after expiration. Presence subscriptions support notifications with resource data, allowing more detailed information to be delivered along with change notifications. For more information, see [Set up change notifications with resource data](change-notifications-with-resource-data.md).
3030

3131
The following table lists the types of presence changes you can subscribe to. For more information, see [Create subscription](/graph/api/subscription-post-subscriptions).
3232

concepts/includes/change-notifications-rich-notifications-supported-resources.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,8 @@ Rich notifications are available for the following resources.
2525
| Teams [chat][] | Changes to any chat in the tenant: `/chats`<br/><br/>Changes to a specific chat: `/chats/{id}` | - |
2626
| Teams [chatMessage][] | Changes to chat messages in all channels in all teams: `/teams/getAllMessages`<br/><br/>Changes to chat messages in a specific channel: `/teams/{id}/channels/{id}/messages`<br/><br/>Changes to chat messages in all chats: `/chats/getAllMessages`<br/><br/>Changes to chat messages in a specific chat: `/chats/{id}/messages`<br/><br/>Changes to chat messages in all chats a particular user is part of: `/users/{id}/chats/getAllMessages` | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. |
2727
| Teams [conversationMember][] | Changes to membership in a specific team: `/teams/{id}/members`<br/><br/><!-- Changes to membership in all channels under a specific team: `/teams/{id}/channels/getAllMembers` --><br/><br/>Changes to membership in a specific chat: `/chats/{id}/members`<!-- <br/><br/>Changes to membership for all Teams chats: `/chats/getAllMembers`<br/><br/>Changes to membership for all channels across the entire tenant: `/teams/getAllChannels/getAllMembers` * --> | - |
28-
| Teams [onlineMeeting][] * | Changes to an online meeting: `/communications/onlineMeetings/?$filter=JoinWebUrl eq '{joinWebUrl}` * | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. |
29-
| Teams [presence][] | Changes to a single user's presence: `/communications/presences/{id}` | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. |
28+
| Teams [onlineMeeting][] * | Changes to an online meeting: `/communications/onlineMeetings(joinWebUrl='{encodedJoinWebUrl}')/meetingCallEvents` * | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. One subscription allowed per application per online meeting. For more information, see [Get change notifications for Microsoft Teams meeting call event updates](/graph/changenotifications-for-onlinemeeting). |
29+
| Teams [presence][] | Changes to a single user's presence: `/communications/presences/{id}` <br><br> Changes to multiple users' presence: `/communications/presences?$filter=id in ({id},{id}...)` | The subscription for multiple users' presence is limited to 650 distinct users. Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. One subscription allowed per application per delegated user. For more information, see [Get change notifications for presence updates in Microsoft Teams](/graph/changenotifications-for-presence). |
3030
| Teams [team][] | Changes to any team in the tenant: `/teams`<br/><br/>Changes to a specific team: `/teams/{id}` | - |
3131

3232
[channel]: /graph/api/resources/channel

concepts/includes/change-notifications-supported-resources-expanded.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,8 @@ An app can subscribe to changes on the Microsoft Graph resources listed in the t
3535
| Teams [chatMessage][] | Changes to chat messages in all channels in all teams: `/teams/getAllMessages` <br><br> Changes to chat messages in a specific channel: `/teams/{id}/channels/{id}/messages` <br><br> Changes to chat messages in all chats: `/chats/getAllMessages` <br><br> Changes to chat messages in a specific chat: `/chats/{id}/messages` <br><br> Changes to chat messages in all chats a particular user is part of: `/users/{id}/chats/getAllMessages` <br><br> Changes to chat messages for all chats in an organization where a particular Teams app is installed: `/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages` | Maximum subscription quotas: <li> Per app and channel or chat combination: 1 subscription. <li> Per user (for subscriptions tracking chat messages in all chats the user is part of): 10 subscriptions. <li> Per organization: 10,000 total subscriptions. |
3636
| Teams [channel][] | Changes to channels in all teams: `/teams/getAllChannels` <br><br> Changes to channel in a specific team: `/teams/{id}/channels` | Maximum subscription quotas: <li> Per app and team combination: 1 subscription. <li> Per organization: 10,000 total subscriptions. |
3737
| Teams [conversationMember][] | Changes to membership in a specific team: `/teams/{id}/members` <br><br> Changes to membership in all channels under a specific team: `teams/{id}/channels/getAllMembers` <br><br> Changes to membership in a specific chat: `/chats/{id}/members` <br><br> Changes to membership for all chats in an organization where a particular Teams app is installed: `/appCatalogs/teamsApps/{id}/installedToChats/getAllMembers` <br><br> Changes to membership in all chats: `/chats/getAllMembers` | Maximum subscription quotas: <li> Per app and team combination: 1 subscription. <li> Per organization: 10,000 total subscriptions. |
38-
| Teams [onlineMeeting][] <sup>*<sup> | Changes to an online meeting: `/communications/onlineMeetings/?$filter=JoinWebUrl eq {joinWebUrl}` | |
39-
| Teams [presence][] | Changes to a single user's presence: `/communications/presences/{id}` <br><br> Changes to multiple user presences: `/communications/presences?$filter=id in ({id},{id}...)` | |
38+
| Teams [onlineMeeting][] <sup>*<sup> | Changes to an online meeting: `/communications/onlineMeetings(joinWebUrl='{encodedJoinWebUrl}')/meetingCallEvents` | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. One subscription allowed per application per online meeting. For more information, see [Get change notifications for Microsoft Teams meeting call event updates](/graph/changenotifications-for-onlinemeeting). |
39+
| Teams [presence][] | Changes to a single user's presence: `/communications/presences/{id}` <br><br> Changes to multiple users' presence: `/communications/presences?$filter=id in ({id},{id}...)` | The subscription for multiple users' presence is limited to 650 distinct users. Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. One subscription allowed per application per delegated user. For more information, see [Get change notifications for presence updates in Microsoft Teams](/graph/changenotifications-for-presence). |
4040
| Teams [team][] | Changes to any team in the tenant: `/teams` <br><br> Changes to a specific team: `/teams/{id}` | Maximum subscription quotas: <li> Per app and team combination: 1 subscription. <li> Per organization: 10,000 total subscriptions. |
4141
| Teams Shifts [offerShiftRequest][] | Changes to any offer shift request in a team: `/teams/{id}/schedule/offerShiftRequests` | Maximum subscription quotas: <li> Per app and resource path combination: 1 subscription per tenant.<li> Per resource path and user combination: 10 delegated user subscriptions per tenant. |
4242
| Teams Shifts [openShiftChangeRequest][] | Changes to any open shift request in a team: `/teams/{id}/schedule/openShiftChangeRequests` | Maximum subscription quotas:<li> Per app and resource path combination: 1 subscription per tenant.<li> Per user and resource path combination: 10 subscriptions.<li> Per organization: 10,000 total subscriptions. |

0 commit comments

Comments
 (0)