如何通过MS Graph获取Teams用户的实际通话可用状态

Teams的在线状态（presence）是多状态源按优先级覆盖后的展示结果，日历会议状态的展示优先级高于活跃通话状态，会覆盖顶层availability字段的返回值，因此直接读取该字段无法准确判断接听权限，和你观察到的现象一致。
可通过以下组合查询实现和客户端一致的判断逻辑：

前置规则校验 #

首先调用GET /users/{user-id}/teamwork/callingSettings获取用户通话配置，满足任意一条即判定为无法接听来电：

• blockIncomingCalls值为true：用户开启了全局来电拦截
• callForwardingSettings.immediateCallForwardTarget不为空：用户配置了所有来电立即转接，来电不会推送到用户客户端

租户策略校验 #

调用GET /communications/callingPolicies?$filter=id eq '{assigned-policy-id}'查询分配给该用户的通话策略，如果busyOnBusyEnabled值为false，则用户不会触发“通话中拒接新来电”规则，只要不触发前置拦截规则，无论处于什么状态都可以接听新来电。

实际通话状态判断 #

调用GET /users/{user-id}/presence获取用户状态详情，注意不要使用顶层availability的展示值判断，需结合activity字段判断：

• 若availability值为DoNotDisturb，用户默认开启勿扰模式拦截来电，无法接听（用户手动修改勿扰允许来电的自定义配置暂不支持Graph查询）
• 在busyOnBusyEnabled为true的前提下：
  • 若activity字段包含inACall标记，说明用户当前有活跃通话，无法接听新来电
  • 若activity字段仅为inAMeeting、无inACall标记，说明用户仅处于日历会议时段、无活跃通话，可以正常接听新来电

批量查询优化 #

可使用Graph批量接口一次拉取所有所需数据，降低请求开销：

POST /$batch
Content-Type: application/json
{
  "requests": [
    {"id": "1", "method": "GET", "url": "/users/{user-id}/presence"},
    {"id": "2", "method": "GET", "url": "/users/{user-id}/teamwork/callingSettings"}
  ]
}

调用上述接口需提前申请对应权限，至少需要Presence.Read.All、User.Read.All权限，涉及通话策略查询还需Policy.Read.All权限。

内容的提问来源于stack exchange，提问作者user3454389