# microsoft/BotFramework-WebChat

A highly-customizable web-based client for Azure Bot Services.

Repository: https://github.com/microsoft/BotFramework-WebChat
Canonical: https://ross.abutalabs.com/products/botframework-webchat
Homepage: https://www.botframework.com/
Language: HTML
License: MIT
License Family: permissive
Topics: bot-framework, adaptive-cards, azure-bot-services, chat, conversational-ui, conversational-ai, bot, chatbot
Last push: 2026-07-14T21:23:02+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 62, longevity 100
- inputs: {"age_days": 3709, "days_push": 50, "days_rel": 99, "gap_med": 152.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1785, forks 1601 (observed 2026-08-28T04:05:35.997065+00:00)

## What it is
Bot Framework Web Chat is a highly-customizable web-based chat client component for Microsoft's Bot Framework v4 SDK and Azure Bot Services. It is distributed as an npm package that developers embed in websites to render conversations with bots, including support for Adaptive Cards, livestreaming responses, and Content Security Policy.

## Use cases
- embed a chatbot widget on my website
- build a custom chat UI for an Azure Bot Service bot
- render adaptive cards in a web chat client
- customize the look and feel of a bot conversation interface
- add a support chatbot to a web app
- stream bot responses progressively in the browser
- connect a web frontend to a Bot Framework v4 bot

## When to choose
- you are building bots on Microsoft Bot Framework v4 or Azure Bot Services
- you need a customizable, embeddable web chat widget with React support
- you want Adaptive Cards rendering and livestreaming responses out of the box

## When to avoid
- your bots run on non-Microsoft frameworks or channels without the Direct Line protocol
- you need a native mobile chat SDK rather than a web component
- you want a fully hosted turnkey chat solution with no frontend development

## Facets
- artifact type: library
- maturity: active
- function: chat-interface, ui-components, frontend-framework, websocket
- domain: chatbots, web-development, frontend, artificial-intelligence
- platform: browser, cross-platform
- tags: azure-bot-services, bot-framework, conversational-ui, adaptive-cards, react, microsoft, chat-widget, conversational-ai, natural-language-processing, web-server, nodejs

## Member repositories
- microsoft/BotFramework-WebChat (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:35.997065+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:24:13.388570+00:00, confidence not recorded.
  - readme: https://github.com/microsoft/BotFramework-WebChat (fetched 2026-08-28T04:05:35.997065+00:00, sha faae2ee23340)
  - homepage: https://www.botframework.com/ (fetched 2026-08-29T11:02:36.753850+00:00, sha 046d335adfe3)
- Data as of 2026-08-30T08:39:29.467469+00:00.
