如何使用Bot Framework SDK 4.18在Teams中回复线程消息

算力阿峰

2026-8-4

Teams机器人回复同线程消息问题解决

场景

用户在Teams应用中向机器人发送消息
机器人需要回复用户发起的同一线程

当前问题

机器人可发送新消息，但会创建独立对话（不符合预期）：
不符合预期的效果

预期效果

机器人回复需在用户发起的同一线程内：
预期效果

前期排查

查阅以下官方文档未找到明确的reply方法，使用continueConversation会创建新消息：

Bot Builder核心TurnContext类文档（JavaScript/TypeScript）
Teams机器人对话基础操作指南

解决方案

要实现同线程回复，核心是在发送消息时指定目标消息的ID（replyToId），以此关联到用户发起的线程。

在线回复（当前对话上下文）

直接在用户消息的TurnContext中提取消息ID，用sendActivity方法发送带replyToId的回复：

async onMessage(context: TurnContext) {
    // 获取用户当前消息的ID，作为回复的线程关联ID
    const targetMessageId = context.activity.id;

    // 构造回复内容
    const replyContent = MessageFactory.text("这是同一线程内的回复内容");
    
    // 指定回复目标线程
    replyContent.replyToId = targetMessageId;
    
    // 发送回复
    await context.sendActivity(replyContent);
}

离线回复（非实时对话上下文）

如果需要在当前TurnContext外回复线程，需同时指定会话ID和目标消息ID，通过适配器发起会话：

async sendThreadReply(adapter: BotFrameworkAdapter, conversationReference: Partial<ConversationReference>, targetMessageId: string) {
    await adapter.continueConversation(conversationReference, async (turnContext) => {
        const replyContent = MessageFactory.text("离线触发的同线程回复");
        replyContent.replyToId = targetMessageId;
        await turnContext.sendActivity(replyContent);
    });
}