BotFramework-DirectLine JS 初始化连接后未收到初始欢迎消息问题咨询

问题根因 #

默认Direct Line渠道不会在会话创建后立即推送conversationUpdate（成员加入）事件给机器人，只有当会话中产生第一条用户消息时，才会触发成员加入事件，这就是为什么你要等用户发第一条消息才能收到欢迎消息。Web Chat、模拟器等内置渠道做了兼容处理，会在连接建立后主动发送初始化事件触发欢迎逻辑，自定义DirectLineJS客户端需要手动实现这个逻辑。

具体解决步骤 #

• 步骤1：客户端静默发送初始化事件 #

  创建DirectLine实例后，先订阅activity$消息流，再主动发送一个自定义事件类型的活动，无需用户触发，后台静默执行，参考代码：

  import { DirectLine } from 'botframework-directlinejs';
  
  const directLine = new DirectLine({
    token: '你的Direct Line令牌'
  });
  
  // 先订阅活动流，确保不会漏收机器人返回的欢迎消息
  directLine.activity$.subscribe(activity => {
    if (activity.type === 'message') {
      // 此处写你自己的消息渲染逻辑
      console.log('收到机器人消息:', activity.text);
    }
  });
  
  // 连接成功后静默发送初始化事件，无感知触发欢迎消息
  directLine.postActivity({
    type: 'event',
    name: 'conversationStart', // 事件名可自定义，和机器人端统一即可
    value: {}
  }).subscribe(
    id => console.log('初始化事件发送成功'),
    error => console.error('初始化事件发送失败:', error)
  );
  

• 步骤2：调整机器人端欢迎消息触发逻辑 #

  不要只依赖MembersAdded（成员加入）事件触发欢迎消息，新增对自定义初始化事件的监听，同时保留原有逻辑兼容其他渠道，参考Node.js SDK代码示例：

  // 监听自定义初始化事件，适配Direct Line自定义客户端场景
  this.onEvent(async (context, next) => {
    if (context.activity.name === 'conversationStart') {
      await context.sendActivity('你好，欢迎使用本机器人！');
    }
    await next();
  });
  
  // 保留原有成员加入监听逻辑，兼容模拟器、Web Chat等其他渠道
  this.onMembersAdded(async (context, next) => {
    const membersAdded = context.activity.membersAdded;
    for (const member of membersAdded) {
      // 排除机器人自身加入的事件
      if (member.id !== context.activity.recipient.id) {
        await context.sendActivity('你好，欢迎使用本机器人！');
      }
    }
    await next();
  });
  

• 注意事项 #

  • 初始化事件使用event类型即可，不要使用message类型，避免该事件出现在用户的聊天记录中
  • 必须先完成activity$的订阅逻辑，再发送初始化事件，避免消息漏收
  • 不需要额外修改Azure机器人或Direct Line的渠道配置，只要调整两端业务逻辑即可

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