explaingit

microsoft/botbuilder-samples

★ 4,509HTMLAudience · developerComplexity · 3/5Setup · moderate

TLDR

A collection of example chat bot projects in C#, JavaScript, and Python using Microsoft's Bot Framework SDK, covering features from simple echo bots to multi-step conversations, note: this repository is archived and no longer maintained as of late 2025.

Mindmap

mindmap
  root((BotBuilder Samples))
    What it is
      Bot Framework examples
      Topic-based samples
      Three languages
    Sample topics
      Echo and welcome bots
      Cards and attachments
      Auth flows
      QA integration
    Languages
      C sharp
      JavaScript TypeScript
      Python
    Status
      Archived late 2025
      Migrate to Agents SDK
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Study working Bot Framework SDK code examples in your language of choice to learn how bots handle conversation state

USE CASE 2

Copy a sample as a starting point for a bot that sends welcome messages, handles file attachments, or runs an auth flow

USE CASE 3

Understand how multi-step conversations and dialog flows work before starting a real bot project

USE CASE 4

Follow Microsoft's migration guidance to move an existing Bot Framework bot to the newer Microsoft 365 Agents SDK

Tech stack

C#JavaScriptTypeScriptPythonBot Framework

Getting it running

Difficulty · moderate Time to first run · 30min

This repository is archived and no longer maintained, Microsoft recommends migrating to the Microsoft 365 Agents SDK instead.

In plain English

BotBuilder-Samples is a collection of example projects for Microsoft's Bot Framework SDK, which is a toolkit for building chat bots and conversational applications. The samples are organized by topic and each one demonstrates a specific capability, such as sending welcome messages, using buttons and cards, handling file attachments, managing conversation state, or connecting to a language understanding service. Each sample is available in three programming languages: C#, JavaScript and TypeScript, and Python. This means developers can study the same concept in whichever language they work with. The samples range from a simple echo bot that just repeats back what the user types, to more complex examples involving multi-step conversations, authentication flows, and connecting to external services like question answering systems. The Bot Framework SDK itself handles the underlying plumbing of a chat bot, including receiving messages from channels like Microsoft Teams or a web chat widget, managing conversational state across multiple turns, and sending responses. The samples show how to use these features in practice. This repository is archived and is no longer being updated or maintained. Microsoft announced the archive as of late 2025 and directed developers to a newer project called the Microsoft 365 Agents SDK, which is the current supported path for building conversational agents. Existing bots built with the Bot Framework SDK can be migrated to the Agents SDK using migration guidance Microsoft published separately. Support tickets for the Bot Framework SDK stopped being serviced at the end of December 2025.

Copy-paste prompts

Prompt 1
I'm learning the Bot Framework SDK in JavaScript. Walk me through the echo bot sample and explain how each part handles an incoming message and sends a reply.
Prompt 2
How do I add a welcome message to my Bot Framework bot that fires only when a new user joins the conversation, based on the botbuilder-samples pattern?
Prompt 3
I'm building a bot that needs to ask the user a series of questions and remember answers across turns. Which botbuilder-samples example shows how to manage multi-turn dialog state?
Prompt 4
This repository is archived. How do I migrate my existing Bot Framework SDK bot to the Microsoft 365 Agents SDK?
Prompt 5
Show me the Bot Framework sample for connecting a bot to a question-answering service so it can answer FAQs from a knowledge base.
Open on GitHub → Explain another repo

← microsoft on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.