能否通过Graph API设置Teams用户状态?代码问题及同步方案求助
问题解决:Graph API设置Teams状态Out of Office不生效及BambooHR同步方案
一、Out of Office设置不生效的修复方案
你的请求存在三个关键问题,调整后即可正常生效:
- 字段拼写错误:
isOutofoffice需修正为驼峰格式的isOutOfOffice(注意字母O的大写) - JSON格式错误:原代码中键值对之间缺少逗号分隔,正确的JSON必须保证每个字段(除最后一个)后添加逗号
- API权限与端点验证:
- 确认调用的是正确端点:当前用户用
PATCH https://graph.microsoft.com/v1.0/me/presence,其他用户用PATCH https://graph.microsoft.com/v1.0/users/{user-id}/presence - 必须持有
Presence.ReadWrite权限(委派或应用权限均可)
- 确认调用的是正确端点:当前用户用
修正后的标准请求体示例:
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('f599db41-7474-416a-acb1-88f9e')/presence/$entity", "availability": "OutOfOffice", "activity": "OutOfOffice", "outOfOfficeSettings": { "message": "oof mes", "isOutOfOffice": true } }
额外提示:设置isOutOfOffice: true时,建议将availability和activity设为OutOfOffice,避免Teams状态显示逻辑冲突。
二、BambooHR状态同步至Teams的实现方案
完全可以通过Graph API实现同步,核心是搭建一个中间服务完成以下流程:
- 调用BambooHR的API拉取用户的休假状态或自定义状态消息(需提前获取BambooHR的API密钥及对应权限)
- 将BambooHR返回的状态内容转换为Teams Presence API要求的字段格式(如把休假说明映射到
outOfOfficeSettings.message,休假状态对应availability) - 调用Graph API的Presence PATCH接口,将转换后的内容同步到Teams状态
可选优化:
- 设置定时任务定期触发同步,或监听BambooHR的webhook事件实现实时同步
- 若同步批量用户,需申请
Presence.ReadWrite.All应用权限
内容的提问来源于stack exchange,提问作者az_mhb
相关产品推荐
相关产品推荐

