README.md

December 23, 2025 · View on GitHub

ARCHIVE NOTICE:

We are in the process of archiving the Bot Framework SDK Samples repository on GitHub. This means that this project will no longer be updated or maintained. Customers using this tool will not be disrupted. However, the tool will no longer be supported through service tickets in the Azure portal and will not receive product updates.

To build agents with your choice of AI services, orchestration, and knowledge, consider using the Microsoft 365 Agents SDK. The Agents SDK is GA and has support for C#, JavaScript or Python. You can learn more about the Agents SDK at aka.ms/agents. If you're looking for a SaaS-based agent platform, consider Microsoft Copilot Studio. If you have an existing bot built with the Bot Framework SDK, you can update your bot to the Agents SDK. You can review the core changes and updates at Bot Framework SDK to Agents SDK migration guidance here. Support tickets for the Bot Framework SDK will no longer be serviced as of December 31, 2025.

We plan to archive this project no later than end of December of 2025.

Click here to find out what's new with Bot Framework

Overview

This branch contains samples for the released version of the Microsoft Bot Framework V4 SDK for .NET, JS and Python.

Getting the samples

To use the samples, clone this GitHub repository using Git.

    git clone https://github.com/Microsoft/BotBuilder-Samples.git
    cd BotBuilder-Samples

Sample lists

Samples are designed to illustrate functionality you'll need to implement to build great bots!

!Bot Framework Samples

Bot essentials

	Sample Name	Description	.NET	JavaScript	Python
2	Echo bot	Demonstrates how to receive and send messages.	.NET Core	JavaScript, TypeScript	Python
3	Welcome user	Introduces activity types and provides a welcome message on conversation update activity.	.NET Core	JavaScript, TypeScript	Python
5	Multi turn prompts	Demonstrates how to use waterfall dialog, prompts, and component dialog to create a simple interaction that asks the user for name, age, and prints back that information.	.NET Core	JavaScript, TypeScript	Python
6	Using cards	Introduces all card types including thumbnail, audio, media etc. Builds on Welcoming user + multi-prompt bot by presenting a card with buttons in welcome message that route to appropriate dialog.	.NET Core	JavaScript, TypeScript	Python
7	Adaptive cards	Demonstrates how the multi-turn dialog can use a card to get user input for name and age.	.NET Core	JavaScript	Python
8	Suggested actions	Demonstrates how to enable your bot to present buttons that the user can tap to provide input.	.NET Core	JavaScript	Python
15	Handling attachments	Demonstrates how to listen for/handle user provided attachments.	.NET Core	JavaScript	Python
40	TIMEX resolution	Demonstrates various ways to parse and manipulate the TIMEX expressions you get from LUIS and the DateTimeRecognizer used by the DateTimePrompt.	.NET Core	JavaScript	Python
43	Complex dialogs	Demonstrates different ways for composing dialogs.	.NET Core	JavaScript	Python
45	State management	Demonstrates how to use state management and storage objects to manage and persist state.	.NET Core	JavaScript	Python

Advanced bots

	Sample Name	Description	.NET	JavaScript	Python
1	Console echo bot	Introduces the concept of adapter and demonstrates a simple echo bot on console adapter and how to send a reply and access the incoming message.	.NET Core	JavaScript, TypeScript	Python
1	Browser echo bot	Demonstrates how to host a bot in the browser using Web Chat and a custom Web Chat Adapter.		ECMAScript 6
16	Proactive messages	Demonstrates how to send proactive messages to users.	.NET Core	JavaScript, TypeScript	Python
17	Multilingual bot	Using translate middleware to support a multi-lingual bot. Demonstrates custom middleware.	.NET Core	JavaScript	Python
19	Custom dialogs	Demonstrates complex conversation flow using the Dialogs library.	.NET Core	JavaScript	Python
23	Facebook events	Integrate and consume Facebook specific payloads, such as post-backs, quick replies and opt-in events.	.NET Core	JavaScript	Python
42	Scale out	Demonstrates how you can build your own state solution from the ground up that supports scaled out deployment with ETag based optimistic locking.	.NET Core		Python
44	Basic custom prompts	Demonstrates how to implement your own basic prompts to ask the user for information.	.NET Core	JavaScript	Python
47	Inspection middleware	Demonstrates how to use middleware to allow the Bot Framework Emulator to debug traffic into and out of the bot in addition to looking at the current state of the bot.	.NET Core	JavaScript	Python
49	Proxy echo bot	Demonstrates how to configure the bot to use it behind a corporative proxy.		JavaScript
70	Styling webchat	This sample shows how to create a web page with custom Web Chat component.		ECMAScript 6

Authentication samples

	Sample Name	Description	.NET	JavaScript	Python
18	OAuth authentication	Bot that demonstrates how to integrate OAuth providers.	.NET Core	JavaScript	Python
24	MSGraph authentication	Demonstrates bot authentication capabilities of Azure Bot Service. Demonstrates utilizing the Microsoft Graph API to retrieve data about the user.	.NET Core	JavaScript	Python
46	Teams authentication	Demonstrates how to use authentication for a bot running in Microsoft Teams.	.NET Core	JavaScript	Python
84	Certificate authentication	Demonstrates how to use Certificates to authenticate the bot	.NET Core	JavaScript
85	Subject name/issuer authentication	Demonstrates how to use the subject name/issuer authentication in a bot	.NET Core	JavaScript
86	Federated Credentials authentication	Demonstrates how to use the FIC in a bot authentication	.NET Core	JavaScript

Custom question answering samples

	Sample Name	Description	.NET	JavaScript	Python
12	Custom question answering (simple)	Demonstrates how to use Custom question answering to have simple single-turn conversations	.NET Core	JavaScript
48	Custom question answering (advanced)	Demonstrates how to integrate Multiturn and Active learning in a Custom question answering bot	.NET Core	JavaScript

Skills samples

	Sample Name	Description	.NET Core	JavaScript	Python
80	Skills - simple bot to bot	This sample shows how to connect a skill to a skill consumer.	.NET Core	JavaScript	Python
81	Skills - skill dialog	This sample shows how to connect a skill to a skill dialog consumer.	.NET Core	JavaScript	Python
82	Skills - SSO with CloudAdapter	This sample shows how to use SSO with skills and CloudAdapter.	.NET Core	JavaScript	NA

Experimental / preview samples

A collection of experimental samples exist, intended to provide samples for features currently in preview or as a way to solicit feedback on a given design, approach, or technology being considered by the Bot Framework Team.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Reporting security issues

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.