BotFramework-WebChat

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

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

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1782

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队microsoft

所属国家

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

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

定价模式free

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

访问状态

是否开源是

开源协议MIT

主要语言HTML

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

GitHub 星标★ 1782

30天Star增速

HF 下载量

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

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：进阶约 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`

如何确认成功

网页中 Web Chat 成功显示并能与 bot 收发消息，表示 token 传入正确。

常见问题

Q：需要自己先搭建 bot 吗？

A：是的，README 要求先通过 Azure Bot Service 创建 bot，然后获取 Web Chat secret。

Q：前端可以直接使用 Web Chat secret 吗？

A：不建议。应先用 secret 生成 token，再将 token 传给 Web Chat，避免密钥暴露。

Q：Web Chat 组件是否已归档？

A：Bot Framework SDK 已于 2025 年 12 月在 GitHub 归档，但 Web Chat 组件本身未归档。

注意事项

Bot Framework SDK 已于 2025 年 12 月在 GitHub 归档，Web Chat 组件仍可用。
建议启用 CSP 以提升安全性，保护对话内容。
README 未提供具体安装命令，实际接入请参考官方文档。

核心亮点

基于 React 组件化架构，可逐层覆盖样式和逻辑，定制性极强
原生支持 Adaptive Cards，能渲染表单、图表等富交互消息
内置 Direct Line 协议和重连机制，与 Azure Bot 集成开箱即用

不足之处

重度依赖 Azure Bot Services，非 Azure 后端需额外适配
文档偏技术化，新手配置 Web Chat 通道有一定门槛

适用场景

企业官网嵌入智能客服对话窗口
SaaS 产品内集成 Bot 助手界面并定制品牌主题
需要展示自适应卡片（如订单确认、问卷）的对话应用

替代项目

Botpress Webchat、Rasa Web Chat、Landbot

项目介绍

BotFramework-WebChat 是对话助手领域的开源项目，由 microsoft 开发，2016 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,782）位列前 30%，在对话助手分类的 905 个项目里位列前 14%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。开源MIT协议，可自由使用和定制，无收费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：企业官网嵌入智能客服对话窗口。同类可对比的替代方案包括 Botpress Webchat、Rasa Web Chat、Landbot。

上一篇：dialoqbase

下一篇：alan-sdk-flutter