如何在MSTeams Bot被安装到团队时获取用户本地时间戳

在Teams Bot的OnInstallationUpdateAddAsync事件中，确实无法直接从IInstallationUpdateActivity上下文获取用户的localTimestamp和时区信息——因为这是Teams平台触发的系统事件，并非用户主动发起的交互消息，所以不会携带这类用户上下文数据。以下是两种可行的解决方案：

方法一：通过Graph API获取用户时区并计算本地时间戳 #

利用Microsoft Graph API查询用户的时区配置，再基于UTC时间转换出用户的本地时间：

1. 从安装事件的上下文里提取用户的AAD对象ID：context.Activity.From.Id
2. 使用Graph SDK调用接口获取用户的时区信息
3. 基于UTC时间和时区计算出对应的本地时间戳

代码示例：

using Microsoft.Graph;
using Microsoft.Identity.Client;
using System.Threading.Tasks;

public async Task OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity> context, CancellationToken cancellationToken)
{
    var userId = context.Activity.From.Id;
    
    // 初始化Graph客户端（需提前配置应用权限和认证信息）
    var clientId = "你的Bot应用ID";
    var tenantId = "租户ID";
    var clientSecret = "应用密钥";
    var scopes = new[] { "https://graph.microsoft.com/.default" };
    
    var confidentialClient = ConfidentialClientApplicationBuilder
        .Create(clientId)
        .WithTenantId(tenantId)
        .WithClientSecret(clientSecret)
        .Build();
    
    var authResult = await confidentialClient.AcquireTokenForClient(scopes).ExecuteAsync(cancellationToken);
    var graphClient = new GraphServiceClient(new DelegateAuthenticationProvider((requestMessage) =>
    {
        requestMessage.Headers.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", authResult.AccessToken);
        return Task.CompletedTask;
    }));
    
    // 获取用户时区
    var user = await graphClient.Users[userId]
        .Request()
        .Select(u => new { u.TimeZone })
        .GetAsync(cancellationToken);
    
    if (!string.IsNullOrEmpty(user.TimeZone))
    {
        var utcNow = DateTime.UtcNow;
        var timeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(user.TimeZone);
        var localTimestamp = TimeZoneInfo.ConvertTimeFromUtc(utcNow, timeZoneInfo);
        // 这里可以保存或使用localTimestamp
    }
}

注意：需要给Bot在Azure AD中配置User.Read的应用权限，并完成管理员同意。

方法二：引导用户回复获取上下文 #

在安装完成后主动给用户发送欢迎消息，引导用户回复任意内容，在后续的OnMessageActivityAsync事件中获取localTimestamp和时区：

1. 在OnInstallationUpdateAddAsync中发送引导消息
2. 在OnMessageActivityAsync中判断是否是安装后的首次回复，提取并保存相关信息

代码示例：

// OnInstallationUpdateAddAsync内
public async Task OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity> context, CancellationToken cancellationToken)
{
    // 可以记录安装事件的用户ID和时间，用于后续关联
    await context.SendActivityAsync("欢迎安装本Bot！请回复任意消息完成初始化~", cancellationToken: cancellationToken);
}

// OnMessageActivityAsync内
public async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> context, CancellationToken cancellationToken)
{
    // 判断是否是安装后的首次回复（可通过缓存或数据库标记）
    var userId = context.Activity.From.Id;
    if (IsFirstReplyAfterInstallation(userId))
    {
        var localTimestamp = context.Activity.LocalTimestamp;
        var timeZone = context.Activity.LocalTimezone;
        // 保存localTimestamp和时区到数据库或缓存
        MarkReplyAsProcessed(userId);
    }
    
    // 其他消息处理逻辑
    await context.SendActivityAsync($"收到你的消息啦，你的本地时间是：{localTimestamp}", cancellationToken: cancellationToken);
}

这种方法无需额外配置权限，实现简单，但需要用户主动配合回复。

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