如何向Azure Bot正确传递channel data参数（附实现代码）

你现有代码存在4个会导致传参失败的问题：

• JS语法错误：object.assign拼写错误，标准API为大写开头的Object.assign
• 逻辑错误：直接全量覆盖channelData字段，会冲掉Web Chat原生携带的客户端元数据，部分场景下会导致消息发送异常
• 鲁棒性不足：服务端解析前未做ChannelData空值校验，非Web Chat渠道发消息时容易触发空引用异常
• 拼写隐患：你代码里@ViewBag.Tennatid变量名多写了一个n，和服务端读取的TenantId字段名不匹配，会导致取值为空

前端Web Chat侧改造 #

原有样式配置无需调整，重点修正DirectLine的postActivity拦截逻辑，合并原有channelData字段而非全量覆盖，正确代码如下：

// 原有样式配置可直接保留
const styleSet = window.WebChat.createStyleSet({
  bubbleBackground: '#99ccff',
  bubbleFromUserBackground: '#33adff',
  rootHeight: '100%',
  rootWidth: '100%'
});
styleSet.textContent = {
  ...styleSet.textContent,
  fontFamily: "'Arial','Helvetica',sans-serif",
  fontWeight: 'bold'
};

// 初始化DirectLine连接
const directLine = window.WebChat.createDirectLine({ token: 你的DirectLine密钥/令牌 });

// 包装postActivity方法注入自定义参数
const customDirectLine = Object.assign({}, directLine, {
  postActivity: activity => {
    // 合并原生activity属性、原有channelData字段、自定义参数
    const processedActivity = Object.assign({}, activity, {
      channelData: Object.assign({}, activity.channelData, {
        // 注意修正ViewBag变量名拼写，和服务端字段保持一致
        TenantId: "@ViewBag.TenantId"
      })
    });
    // 调试阶段可打开控制台看参数，上线可删除
    console.log('发送的活动数据:', processedActivity);
    // 调用原生方法发送处理后的活动
    return directLine.postActivity(processedActivity);
  }
});

// 渲染Web Chat组件
window.WebChat.renderWebChat({
  directLine: customDirectLine,
  userID: 'YOUR_USER_ID',
  username: 'Web Chat User',
  locale: 'en-US',
  styleSet
}, document.getElementById('webchat'));

注意：如果TenantId是接口异步返回的，需要等参数拿到之后再执行renderWebChat逻辑，避免传空值。

Bot服务端侧解析 #

原有解析逻辑调整为空值安全的写法，避免不同渠道ChannelData格式差异导致的解析失败，基于.NET Framework + Newtonsoft.Json的代码如下：

// 在消息Turn处理逻辑中添加
if (turnContext.Activity.ChannelData != null)
{
    // 直接将ChannelData转为JObject，不要直接ToString()避免拿到类型全名
    var channelData = JObject.FromObject(turnContext.Activity.ChannelData);
    // 安全取值，字段不存在时不抛异常
    if (channelData.TryGetValue("TenantId", out var tenantIdToken))
    {
        string customTenantId = tenantIdToken.ToString();
        // 这里写自定义TenantId对应的业务逻辑
    }
}

验证方法 #

• 打开浏览器开发者工具，在Network面板筛选DirectLine对应的conversations/{conversationId}/activities请求，检查请求体中channelData字段是否携带正确的TenantId
• 服务端在消息处理入口打断点，检查收到的Activity对象中ChannelData是否包含对应自定义字段

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