BotBuilder-Samples

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. If you need samples for the Bot Framework V3 SDK, go here.

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	Java
2	Echo bot	Demonstrates how to receive and send messages.	[.NET Core][cs#2]	[JavaScript][js#2], [TypeScript][ts#2]	[Python][py#2]	[Java][java#2]
3	Welcome user	Introduces activity types and provides a welcome message on conversation update activity.	[.NET Core][cs#3]	[JavaScript][js#3], [TypeScript][ts#3]	[Python][py#3]	[Java][java#3]
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][cs#5]	[JavaScript][js#5], [TypeScript][ts#5]	[Python][py#5]	[Java][java#5]
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][cs#6]	[JavaScript][js#6], [TypeScript][ts#6]	[Python][py#6]	[Java][java#6]
7	Adaptive cards	Demonstrates how the multi-turn dialog can use a card to get user input for name and age.	[.NET Core][cs#7]	[JavaScript][js#7]	[Python][py#7]	[Java][java#7]
8	Suggested actions	Demonstrates how to enable your bot to present buttons that the user can tap to provide input.	[.NET Core][cs#8]	[JavaScript][js#8]	[Python][py#8]	[Java][java#8]
13	Core bot	Core bot shows how to use cards, dialog, and Language Understanding (LUIS).	[.NET Core][cs#13], [.NET Web][wa#13]	[JavaScript][js#13], [TypeScript][ts#13]	[Python][py#13]	[Java][java#13]
15	Handling attachments	Demonstrates how to listen for/handle user provided attachments.	[.NET Core][cs#15]	[JavaScript][js#15]	[Python][py#15]	[Java][java#15]
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][cs#40]	[JavaScript][js#40]	[Python][py#40]	[Java][java#40]
43	Complex dialogs	Demonstrates different ways for composing dialogs.	[.NET Core][cs#43]	[JavaScript][js#43]	[Python][py#43]	[Java][java#43]
45	State management	Demonstrates how to use state management and storage objects to manage and persist state.	[.NET Core][cs#45]	[JavaScript][js#45]	[Python][py#45]	[Java][java#45]

Advanced bots

	Sample Name	Description	.NET	JavaScript	Python	Java
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][cs#1]	[JavaScript][js#1], [TypeScript][ts#1]	[Python][py#1]
1	Browser echo bot	Demonstrates how to host a bot in the browser using Web Chat and a custom Web Chat Adapter.		[ECMAScript 6][es#1]
16	Proactive messages	Demonstrates how to send proactive messages to users.	[.NET Core][cs#16]	[JavaScript][js#16], [TypeScript][ts#16]	[Python][py#16]	[Java][java#16]
17	Multilingual bot	Using translate middleware to support a multi-lingual bot. Demonstrates custom middleware.	[.NET Core][cs#17]	[JavaScript][js#17]	[Python][py#17]	[Java][java#17]
19	Custom dialogs	Demonstrates complex conversation flow using the Dialogs library.	[.NET Core][cs#19]	[JavaScript][js#19]	[Python][py#19]	[Java][java#19]
21	Application Insights	Demonstrates how to add telemetry logging to your bot, storing telemetry within Application Insights.	[.NET Core][cs#21]	[JavaScript][js#21]		[Java][java#21]
23	Facebook events	Integrate and consume Facebook specific payloads, such as post-backs, quick replies and opt-in events.	[.NET Core][cs#23]	[JavaScript][js#23]	[Python][py#23]	[Java][java#23]
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][cs#42]		[Python][py#42]	[Java][java#42]
44	Basic custom prompts	Demonstrates how to implement your own basic prompts to ask the user for information.	[.NET Core][cs#44]	[JavaScript][js#44]	[Python][py#44]	[Java][java#44]
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][cs#47]	[JavaScript][js#47]	[Python][py#47]	[Java][java#47]
70	Styling webchat	This sample shows how to create a web page with custom Web Chat component.		[ECMAScript 6][es#70]

Authentication samples

	Sample Name	Description	.NET	JavaScript	Python	Java
18	OAuth authentication	Bot that demonstrates how to integrate OAuth providers.	[.NET Core][cs#18]	[JavaScript][js#18]	[Python][py#18]	[Java][java#18]
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][cs#24]	[JavaScript][js#24]	[Python][py#24]	[Java][java#24]
46	Teams authentication	Demonstrates how to use authentication for a bot running in Microsoft Teams.	.NET Core	JavaScript	Python	Java
84	Certificate authentication	Demonstrates how to use Certificates to authenticate the bot	[.NET Core][cs#84]	[JavaScript][js#84]
85	Subject name/issuer authentication	Demonstrates how to use the subject name/issuer authentication in a bot	[.NET Core][cs#85]	[JavaScript][js#85]

Custom question answering samples

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

Teams samples

	Sample Name	Description	.NET	JavaScript	Python	Java
25	Message Reactions	Demonstrates how to create a simple bot that responds to Message Reactions	.NET Core	JavaScript		Java
46	Authentication	Demonstrates how to use authentication for a bot running in Microsoft Teams.	.NET Core	JavaScript	Python	Java
50	Messaging extensions - search	A Messaging Extension that accepts search requests and returns results.	.NET Core	JavaScript	Python	Java
51	Messaging extensions - action	A Messaging Extension that accepts parameters and returns a card. Also, how to receive a forwarded message as a parameter in a Messaging Extension.	.NET Core	JavaScript	Python	Java
52	Messaging extensions - auth and config	A Messaging Extension that has a configuration page, accepts search requests and returns results after the user has signed in.	.NET Core	JavaScript
53	Messaging extensions - action preview	Demonstrates how to create a Preview and Edit flow for a Messaging Extension.	.NET Core	JavaScript	Python	Java
54	Task module	Demonstrates how to retrieve a Task Module, and values from cards in the Task Module, for a Messaging Extension.	.NET Core	JavaScript	Python	Java
55	Link unfurling	A Messaging Extension that performs link unfurling.	.NET Core)	JavaScript	Python	Java
56	File upload	Demonstrates how to obtain file consent, and upload files to Teams from a bot. Also, how to receive a file sent to a bot.	.NET Core	JavaScript	Python	Java
57	Conversation bot	Demonstrates various features of bots on Teams: message all members in a Team or Channel, @mention a user from a bot, update previously sent messages, etc.	.NET Core	JavaScript	Python	Java
58	Start new thread in a channel	Demonstrates creating a new thread in a channel.	.NET Core	JavaScript	Python