gitwtfhub

wtf is botbuilder-samples?

microsoft/botbuilder-samples — explained in plain English

Analysis updated 2026-06-26

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

TL;DR

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

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

C#JavaScriptTypeScriptPythonBot Framework

How it stacks up

microsoft/botbuilder-samplessarabander/sicpdavidarroyo1234/instagramunfollowers
Stars4,5094,5104,514
LanguageHTMLHTMLHTML
Setup difficultymoderateeasyeasy
Complexity3/51/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

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.

Wtf does this do

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.

Yoink these 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.

Frequently asked questions

wtf is botbuilder-samples?

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.

What language is botbuilder-samples written in?

Mainly HTML. The stack also includes C#, JavaScript, TypeScript.

How hard is botbuilder-samples to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is botbuilder-samples for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane