Microsoft Teams Bot：无需endOfConversation清除对话状态的方法

既然Teams不支持endOfConversation活动类型，我们可以用以下几种更兼容的方式来实现对话结束时清除状态的需求：

方案1：在对话结束逻辑中直接清除状态 #

最直接的方式是，当Bot判断对话应该结束时（比如收到用户的结束指令，或者完成了预定的任务流程），在发送结束提示消息后直接调用状态清除方法，不需要依赖特殊的活动类型。

示例代码：

protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
    var userInput = turnContext.Activity.Text?.Trim().ToLower();

    // 示例：当用户发送"结束对话"时触发结束流程
    if (userInput == "结束对话")
    {
        // 先发送对话结束的提示消息
        await turnContext.SendActivityAsync("对话已结束，感谢你的使用！", cancellationToken: cancellationToken);
        
        // 清除对话状态并保存更改
        await _conversationState.ClearStateAsync(turnContext, cancellationToken);
        await _conversationState.SaveChangesAsync(turnContext, false, cancellationToken);
        
        return;
    }

    // 处理其他正常对话逻辑...
    await turnContext.SendActivityAsync($"你说的是：{turnContext.Activity.Text}", cancellationToken: cancellationToken);
}

方案2：通过自定义标记触发中间件清除状态 #

如果你还是希望通过发送活动的方式统一触发状态清除，可以给普通消息添加自定义ChannelData标记，然后在你的中间件里识别这个标记来执行清除逻辑，完全避开不兼容的endOfConversation类型。

步骤1：发送带自定义标记的结束消息 #

// 构建结束消息并添加自定义标记
var endMessage = MessageFactory.Text("任务已完成，对话结束！");
endMessage.ChannelData = new Dictionary<string, object>
{
    { "IsConversationEnd", true }
};

// 发送消息
await turnContext.SendActivityAsync(endMessage, cancellationToken);

步骤2：修改中间件监听自定义标记 #

private async Task<ResourceResponse[]> OnSendActivitiesHandlerAsync(ITurnContext turnContext, List<Activity> activities, Func<Task<ResourceResponse[]>> next)
{
    foreach (Activity activity in activities)
    {
        // 检查消息是否带有结束对话的自定义标记
        if (activity.ChannelData is Dictionary<string, object> channelData &&
            channelData.TryGetValue("IsConversationEnd", out var isEndValue) &&
            isEndValue is bool isEnd && isEnd)
        {
            // 清除对话状态
            await _conversationState.ClearStateAsync(turnContext);
            await _conversationState.SaveChangesAsync(turnContext, false);
        }
    }
    return await next();
}

方案3：基于任务流程的自动清除 #

如果你的Bot有明确的任务结束节点（比如用户完成了表单填写、查询流程结束），可以在该节点的代码分支里直接调用状态清除方法，不需要额外的触发标记。比如：

// 假设这是任务完成的逻辑分支
if (taskIsCompleted)
{
    await turnContext.SendActivityAsync($"任务已完成：{taskResult}", cancellationToken);
    
    // 清除状态
    await _conversationState.ClearStateAsync(turnContext);
    await _conversationState.SaveChangesAsync(turnContext, false);
}

注意事项 #

• 调用ClearStateAsync后，一定要调用SaveChangesAsync来确保状态的更改被持久化到存储中；
• 如果使用中间件，确保中间件的注册顺序正确，避免状态清除逻辑被其他中间件干扰；
• 自定义标记的方式可以统一管理结束逻辑，适合多个场景需要结束对话的Bot。

内容的提问来源于stack exchange，提问作者H. Pauwelyn