如何通过Microsoft Graph API检测并同步Outlook会议室签到状态至外部系统？

阿华AIGC实验室

2026-6-12

关于通过Microsoft Graph API检测Outlook会议室签到状态的方案

目前Microsoft Graph API（包括v5.80.0 Java SDK）没有提供直接标识会议室签到状态的属性，且用户执行签到操作时，不会触发Event/Calendar资源的Webhook变更通知——这是因为签到操作在Outlook底层逻辑中并未被定义为修改Event实体核心属性的操作，所以不会触发标准的变更事件。

可行的替代同步方案

1. 定期轮询Event实体的`responseStatus`属性

用户签到后，其会议响应状态通常会从tentativelyAccepted转为accepted，且responseTime会更新。你可以通过定期轮询目标会议室日历的事件，结合时间范围筛选正在进行的会议，重点追踪参会者的响应状态：

用start/dateTime和end/dateTime筛选出当前时段的会议，减少轮询数据量
检查参会者的responseStatus.response字段确认接受状态，responseStatus.time字段判断状态变更的时间点

以下是Kotlin结合Graph SDK的示例代码：

val graphClient = GraphServiceClient.builder()
    .authenticationProvider(yourAuthProvider)
    .buildClient()

// 筛选当前前后3小时内的会议室事件
val currentTime = LocalDateTime.now()
val filter = "start/dateTime ge '${currentTime.minusHours(3).format(DateTimeFormatter.ISO_DATE_TIME)}' " +
             "and end/dateTime le '${currentTime.plusHours(3).format(DateTimeFormatter.ISO_DATE_TIME)}'"

val events = graphClient.users(roomEmail).calendar.events()
    .filter(filter)
    .select("id,subject,start,end,attendees")
    .buildRequest()
    .get()

// 遍历检查目标用户的签到状态
events.forEach { event ->
    event.attendees?.forEach { attendee ->
        if (attendee.emailAddress?.address == targetUserEmail) {
            attendee.responseStatus?.let { status ->
                if (status.response == ResponseStatusType.ACCEPTED 
                    && status.time?.isAfter(event.start?.dateTime?.minusMinutes(15)) == true) {
                    // 判定为近期签到，同步至自有系统
                    syncCheckInStatus(event.id, targetUserEmail, true)
                }
            }
        }
    }
}