Skip to content

Commit 78ef2e2

Browse files
DanipocketDanipocket
authored
Merge pull request #28691 from garchiro7/AttendanceRecord_Engagement_Beta
AttendanceRecord Engagement report
2 parents 26eb97d + d4b3f90 commit 78ef2e2

6 files changed

Lines changed: 173 additions & 1 deletion

File tree

‎api-reference/beta/api/attendancerecord-list.md‎

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,33 @@ Content-Type: application/json
159159
"leaveDateTime": "2021-10-05T04:43:49.7702391Z",
160160
"durationInSeconds": 322
161161
}
162+
],
163+
"engagements": [
164+
{
165+
"engagementType": "reaction",
166+
"engagementSubType": "like",
167+
"dateTime": "2026-04-02T22:10:30Z"
168+
},
169+
{
170+
"engagementType": "reaction",
171+
"engagementSubType": "applause",
172+
"dateTime": "2026-04-02T22:15:00Z"
173+
},
174+
{
175+
"engagementType": "hand",
176+
"engagementSubType": "raiseHand",
177+
"dateTime": "2026-04-02T22:20:00Z"
178+
},
179+
{
180+
"engagementType": "camera",
181+
"engagementSubType": "cameraOn",
182+
"dateTime": "2026-04-02T22:25:00Z"
183+
},
184+
{
185+
"engagementType": "microphone",
186+
"engagementSubType": "unmute",
187+
"dateTime": "2026-04-02T22:30:00Z"
188+
}
162189
]
163190
},
164191
{
@@ -177,6 +204,23 @@ Content-Type: application/json
177204
"leaveDateTime": "2021-10-04T23:18:57.5639338Z",
178205
"durationInSeconds": 314
179206
}
207+
],
208+
"engagements": [
209+
{
210+
"engagementType": "reaction",
211+
"engagementSubType": "like",
212+
"dateTime": "2026-04-02T22:10:30Z"
213+
},
214+
{
215+
"engagementType": "reaction",
216+
"engagementSubType": "applause",
217+
"dateTime": "2026-04-02T22:15:00Z"
218+
},
219+
{
220+
"engagementType": "microphone",
221+
"engagementSubType": "unmute",
222+
"dateTime": "2026-04-02T22:30:00Z"
223+
}
180224
]
181225
}
182226
]
@@ -282,6 +326,33 @@ Content-Type: application/json
282326
"leaveDateTime": "2022-06-29T22:59:18.5180137Z",
283327
"durationInSeconds": 209
284328
}
329+
],
330+
"engagements": [
331+
{
332+
"engagementType": "reaction",
333+
"engagementSubType": "like",
334+
"dateTime": "2026-04-02T22:10:30Z"
335+
},
336+
{
337+
"engagementType": "reaction",
338+
"engagementSubType": "applause",
339+
"dateTime": "2026-04-02T22:15:00Z"
340+
},
341+
{
342+
"engagementType": "hand",
343+
"engagementSubType": "raiseHand",
344+
"dateTime": "2026-04-02T22:20:00Z"
345+
},
346+
{
347+
"engagementType": "camera",
348+
"engagementSubType": "cameraOn",
349+
"dateTime": "2026-04-02T22:25:00Z"
350+
},
351+
{
352+
"engagementType": "microphone",
353+
"engagementSubType": "unmute",
354+
"dateTime": "2026-04-02T22:30:00Z"
355+
}
285356
]
286357
}
287358
]

‎api-reference/beta/resources/attendancerecord.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ Contains information associated with an attendance record in a [meetingAttendanc
2828
|:--------------------|:--------|:-----------|
2929
| attendanceIntervals | [attendanceInterval](attendanceinterval.md) collection | List of time periods between joining and leaving a meeting. |
3030
| emailAddress | String | Email address of the user associated with this attendance record. |
31+
| engagements | [meetingEngagement](meetingengagement.md) collection | The list of real-time participant interaction behaviors during a meeting. |
3132
| externalRegistrationInformation | [virtualEventExternalRegistrationInformation](../resources/virtualeventexternalregistrationinformation.md) | The external information for a virtual event registration. |
3233
| identity | [identity](identity.md) | Identity of the user associated with this attendance record. The specific type will be one of the following derived types of [identity](identity.md), depending on the type of the user: [communicationsUserIdentity](communicationsUserIdentity.md), [azureCommunicationServicesUserIdentity](azureCommunicationServicesUserIdentity.md). |
3334
| role | String | Role of the attendee. The possible values are: `None`, `Attendee`, `Presenter`, and `Organizer`. |
@@ -73,6 +74,11 @@ The following JSON representation shows the resource type.
7374
"@odata.type": "#microsoft.graph.virtualEventExternalRegistrationInformation",
7475
"referrer": "String",
7576
"registrationId": "String"
76-
}
77+
},
78+
"engagements": [
79+
{
80+
"@odata.type": "#microsoft.graph.meetingEngagement"
81+
}
82+
]
7783
}
7884
```

‎api-reference/beta/resources/enums.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,16 @@ ms.custom: sfi-ropc-nochange
1313

1414
Namespace: microsoft.graph
1515

16+
### meetingEngagementType values
17+
18+
|Member|
19+
|:---|
20+
|reaction|
21+
|hand|
22+
|camera|
23+
|microphone|
24+
|unknownFutureValue|
25+
1626
### notifyMembers values
1727

1828
|Member|

‎api-reference/beta/resources/meetingengagement.md‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: "meetingEngagement resource type"
3+
description: "Contains information associated with a meeting participant interaction in an attendanceRecord."
4+
author: "garchiro7"
5+
ms.localizationpriority: medium
6+
ms.subservice: "cloud-communications"
7+
doc_type: resourcePageType
8+
ms.date: 09/11/2024
9+
---
10+
11+
# meetingEngagement resource type
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Contains information associated with real-time participant interaction behaviors during a meeting, including reactions (like, love, applause, etc.), hand raises, camera toggles, and microphone mute/unmute events in an [attendanceRecord](attendancerecord.md).
18+
19+
## Properties
20+
21+
| Property | Type | Description |
22+
| ---------- | --------------------------------------- | ----------- |
23+
| `engagementType` | microsoft.graph.meetingEngagementType | The category of the engagement event. Required, non-nullable. |
24+
| `engagementSubType` | String | The specific engagement action within the type (e.g., `like`, `love`, `applause`, `laugh`, `surprised` for reactions; `raiseHand` for hand; `cameraOn` for camera; `unmute`, `mute` for microphone). |
25+
| `dateTime` | DateTimeOffset | The UTC date and time when the engagement event occurred, in ISO 8601 format. |
26+
27+
## Relationships
28+
None.
29+
30+
## JSON representation
31+
32+
The following JSON representation shows the resource type.
33+
34+
<!-- {
35+
"blockType": "resource",
36+
"optionalProperties": [
37+
],
38+
"@odata.type": "microsoft.graph.meetingEngagement"
39+
}-->
40+
41+
```json
42+
{
43+
"engagementType": "String(reaction, hand, camera, microphone, unknownFutureValue)",
44+
"engagementSubType": "String",
45+
"dateTime": "DateTimeOffset"
46+
}
47+
```

‎changelog/Microsoft.Skype.Calling.json‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,39 @@
11
{
22
"changelog": [
3+
{
4+
"ChangeList": [
5+
{
6+
"Id": "bd16e1cf-95de-4af4-b71c-0be1d682b4ef",
7+
"ApiChange": "Enumeration",
8+
"ChangedApiName": "meetingEngagementType",
9+
"ChangeType": "Addition",
10+
"Description": "Added the **meetingEngagementType** enumeration type.",
11+
"Target": "meetingEngagementType"
12+
},
13+
{
14+
"Id": "bd16e1cf-95de-4af4-b71c-0be1d682b4ef",
15+
"ApiChange": "Resource",
16+
"ChangedApiName": "meetingEngagement",
17+
"ChangeType": "Addition",
18+
"Description": "Added the [meetingEngagement](https://learn.microsoft.com/en-us/graph/api/resources/meetingEngagement?view=graph-rest-beta) resource.",
19+
"Target": "meetingEngagement"
20+
},
21+
{
22+
"Id": "bd16e1cf-95de-4af4-b71c-0be1d682b4ef",
23+
"ApiChange": "Property",
24+
"ChangedApiName": "engagements",
25+
"ChangeType": "Addition",
26+
"Description": "Added the **engagements** property to the [attendanceRecord](https://learn.microsoft.com/en-us/graph/api/resources/attendanceRecord?view=graph-rest-beta) resource.",
27+
"Target": "attendanceRecord"
28+
}
29+
],
30+
"Id": "bd16e1cf-95de-4af4-b71c-0be1d682b4ef",
31+
"Cloud": "Prod",
32+
"Version": "beta",
33+
"CreatedDateTime": "2026-05-05T20:46:26.7145941Z",
34+
"WorkloadArea": "Cloud communications",
35+
"SubArea": "Call"
36+
},
337
{
438
"ChangeList": [
539
{

‎concepts/whats-new-overview.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,10 @@ Updated the capabilities of the [auditLogQuery](/graph/api/resources/security-au
163163

164164
Use the **sensorTypes** property on [sensorCandidate](/graph/api/resources/security-sensorcandidate?view=graph-rest-beta&preserve-view=true) to get the list of device types for the sensor.
165165

166+
### Cloud communications | Call
167+
168+
Added [meeting engagement data](/graph/api/resources/meetingengagement?view=graph-rest-beta&preserve-view=true) to capture real-time participant interaction behaviors during a meeting, including reactions (like, love, applause, and so on), hand raises, camera toggles, and microphone mute/unmute events. This data is collected as part of the attendance report.
169+
166170
### Teamwork and communications | Messaging
167171

168172
- Use the targeted messages APIs to manage messages in Microsoft Teams that are visible only to specified recipients within group chats or channels:

0 commit comments

Comments
 (0)