Create your first Bot using Visual Studio 2017: Step by step guide

Original post here.

By looking at how fast the companies adopting the Bots, it is really the best time for you to start learning Bot framework and start adopting Bots for your business.

Some pain in the real world without the Bots:

• You have to read the whole FAQ to find some specific information for any website or any company
• You have to wait for next business day to start to get answers to your queries

• You have to send emails to get some information to send some information
• You have to do manual work to answer some repetitive questions
• More manpower would require if the number of questions increases suddenly:

This would eventually affect your business. Time to try the Bots.

Let us see what the Bots are:

An  Internet bot , also known as  web robot ,  WWW robot  or simply  bot , is a software application that runs automated tasks (scripts) over the Internet. Typically, bots perform tasks that are both simple and structurally repetitive, at a much higher rate than would be possible for a human alone.

In simple words, Bots are something that can be integrated with your website and they can answer the questions posted by the users without the need of the humans

Let us see how to create simple Bot application using Visual Studio 2017.

prerequisite:

Also if you want to have Bot Application as a template then as a workaround just download this  (download would start once you click on the link) project and put the extracted folder into below location:

C:\Users\YourName\Documents\Visual Studio 2015\Templates\ProjectTemplates\Visual C#

Once this is done, you can see Bot Application template as shown below:

Click on Bot Application and then it will create a sample project which has the structure as below:

Here MessagesController is created by default and it is the main entry point of the application.

If you open MessagesController, it will look blood red because it cannot find missing Nuget packages:

You just need to restore those missing Nuget packages by opening Nuget Manager:

You may encounter an error which would be as below:

CS0117 ‘Task’ does not contain a definition for ‘CompletedTask’ NeelBotDemo c:\users\NeelB\documents\visual studio 2017\Projects\NeelBotDemo\NeelBotDemo\Dialogs\RootDialog.cs 15 Active

This error comes because Task.CompletedTask is a static property added in .NET 4.6 and your application may have .NET 4.5

You need to change your application’s Target framework and make it 4.6.1 as below:

Your solution should build properly now.

Now we will make changes in the default code and will modify as per our need.

Open RootDialog.cs class which is in the Dialogs folder.

Replace the code of method with below code:

private async Task MessageReceivedAsync(IDialogContext context, IAwaitable<object> result)
{ 
var activity = await result as Activity; 
// calculate something for us to return 

int length = (activity.Text ?? string.Empty).Length; 

// return our reply to the user 
//test 
if (activity.Text.Contains("morning")) 
{ await context.PostAsync("Good Morning , Have a nice Day"); } 
else if (activity.Text.Contains("night")) 
{ await context.PostAsync("Good night and Sweetest Dreams"); } 
else if (activity.Text.Contains("who are you")) 
{ await context.PostAsync("I am a Bot created by Neel"); } 
else if (activity.Text.Contains("date")) 
{ await context.PostAsync(DateTime.Now.ToString()); } 
else { await context.PostAsync($"You sent {activity.Text} which was {length} characters"); }
context.Wait(MessageReceivedAsync);
}

Here we are telling Bot, what it should answer when there are some specific keywords are there in the message.

Once you made the changes, just run your Bot application. It will have landing page as below:

At this point, your bot is ready to be used. We need an emulator to test our bot.

If we want to test our bots locally then Bot emulator is the best option.

The Bot Framework Emulator is a desktop application that allows bot developers to test and debug their bots on localhost or running remotely through a tunnel.

As we mentioned on top of the post, you can download the Bot emulator from here. Or you can click below, it will start the download automatically:

botframework-emulator-Setup-3.5.33.exe

Click on exe, it will start the installation:

And once the installation is done, it will have a landing page as below, here you need to give the URL of your bot application(http://localhost:3979/api/messages):

It will ask you for Microsoft App Id and password, but for now, do not give anything there and click on CONNECT.

Now your bot is ready to be tested.

Give something that you have added to your code and the bot will respond as per your input in code:

As you can see it answered all of those which we have given in above code and for rest of the things, it will answer as: “You sent {input} which was {length} character”

Congratulations, you just created your first Bot 🙂

You can integrate Microsoft Cognitive APIs into your Bot application, I have written a post on the same which you can find here.

In my upcoming posts, I will share my experiments with the Bots.

Hope it helps.