BotFramework-WebChat

把 Azure Bot 快速变成网页聊天框，还能深度改皮肤

开源 🏷️完全免费 ✅ 目前可打开对话助手 🍴 复刻 1600 🐛 待处理 385 👀 关注 116

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1786

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源MIT协议，可自由使用和定制，无收费版本。

项目预览

BotFramework-WebChat 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类对话助手

开发团队microsoft

官网地址https://www.botframework.com

GitHubhttps://github.com/microsoft/BotFramework-WebChat

定价模式🏷️完全免费

价格说明开源MIT协议，可自由使用和定制，无收费版本。

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言HTML

技术栈/模型adaptive-cards,azure-bot-services,bot,bot-framework,chat,chatbot,conversational-ai,conversational-ui

GitHub 星标★ 1786

上线时间2016-07-07 00:00:00

代码更新2026-11-08

仓库体积564.8 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

BotFramework-WebChat 是微软推出的开源 Web 聊天客户端，专为 Azure Bot Services 设计，用于在网页中快速嵌入智能对话界面。它解决了开发者从零构建聊天 UI 的重复劳动问题，提供高度可定制的组件和主题系统，支持自适应卡片（Adaptive Cards）渲染富媒体交互内容，并内置活动流、附件上传、语音输入等能力。核心能力包括：通过 Direct Line API 与 Bot 无缝通信，支持 Web Chat 通道的完整协议；提供丰富的 React 组件和 Redux 状态管理，便于深度定制消息样式、输入框和菜单；兼容主流浏览器和移动端，支持国际化。项目采用 HTML/TypeScript 编写，社区活跃，文档完善，适合需要快速集成、深度品牌化或复杂交互场景的对话应用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1786

技术标签

bot bot-framework chat chatbot conversational-ai

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：进阶约 10 分钟部署方式：云服务 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Azure 订阅
Azure Bot Service 中已创建的 bot
从 Azure 门户获取的 Web Chat secret
可嵌入 Web Chat 组件的网页环境

安装与启动步骤

1创建 Azure Bot

登录 Azure 门户，通过 Azure Bot Service 创建机器人资源，作为 Web Chat 对话后端。
2获取 Web Chat 密钥

在 Azure 门户中获取该 bot 的 Web Chat secret，用于后续生成 Direct Line token。
3生成 Direct Line Token

使用 Web Chat secret 调用 Direct Line 认证接口生成 token，避免在前端暴露 secret。
4传入 Token 初始化

在网页中初始化 Web Chat 组件时传入生成的 token，即可与 bot 建立对话连接。

关键配置

配置项	必填	说明	示例
`Web Chat secret`	是	Azure 门户获取的 Web Chat 密钥，用于生成 Direct Line token	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
`Direct Line token`	是	用 secret 生成后传给 Web Chat 的令牌，用于建立对话	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxx`