调用Graph API委托权限修改Teams状态时遇403 Forbidden错误

核心问题排查与修复步骤 #

• 确认权限配置是否正确
  调用SetPresence接口的委托权限必须是Presence.ReadWrite，且该权限需要全局管理员同意——普通用户自行授权无法生效。即使你在应用注册中添加了这个权限，也要确保管理员已在Azure AD企业应用中完成权限同意操作。

• 修正SessionId的取值错误
  你用appId作为SessionId是错误的，SessionId需要是唯一字符串，用于标识你的应用设置的状态会话（比如每次调用生成一个新的Guid），和应用ID无关。正确做法是生成随机唯一值，比如Guid.NewGuid().ToString()。

• 验证身份验证上下文
  确保graphClient使用的是当前登录用户的AccessToken，因为委托权限要求必须代表用户发起请求。如果使用的是应用权限的token，哪怕权限配置正确也会报错——SetPresence仅支持委托权限。

• 检查Token的权限范围
  把AccessToken拿到jwt.ms解码，查看scp字段是否包含Presence.ReadWrite。如果没有，说明权限未正确授予，需重新走授权流程或让管理员重新同意权限。

修正后的代码示例 #

// 生成唯一会话ID
var sessionId = Guid.NewGuid().ToString();
var requestBody = new SetPresencePostRequestBody
{
    SessionId = sessionId,
    Availability = "Available",
    Activity = "Available"
};

// 使用Me端点更直接，确保token属于当前操作的用户
await graphClient.Me.Presence.SetPresence.PostAsync(requestBody);

额外注意事项 #

• 若使用Users[user.Id]调用，需确保user.Id是当前登录用户的Object ID。委托权限下默认只能修改自己的状态，不能修改他人状态（除非有额外管理员权限，而上下班打卡场景通常是修改自身状态，用Me更合适）。
• 状态值需符合Graph API规范，比如Availability可选值有Available、Away、Busy等，Activity要与Availability匹配，例如Busy可对应InACall或InAConferenceCall。

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